Как создать простое и бесплатное веб-портфолио с помощью страниц GitHub
Личное присутствие на веб-сайте - отличный способ продемонстрировать свою работу. Это также может быть чрезвычайно полезно для поиска работы в области науки о данных. Портфолио дает вам возможность поделиться высокоуровневым обзором ваших проектов в области науки о данных. Это требует более глубокого погружения в ваши проекты, чем ваше резюме, но менее технически и утомительно, чем ваши репозитории на github. Это идеальный уровень для рекрутеров и менеджеров по анализу данных.
Создать простое портфолио проще, чем вы ожидаете. Все, что вам нужно, это учетная запись GitHub и немного знаний о уценке. Никаких HTML или веб-фреймворков не требуется!
Этот подход использует страницы GitHub для обслуживания README вашего проекта в качестве веб-сайта. GitHub размещает эти веб-сайты, поэтому они бесплатны для вас. Этот портфель - лишь верхушка айсберга; Страницы GitHub также можно использовать для создания простых веб-сайтов для каждого из ваших проектов.
В этом уроке я буду использовать уценку для создания портфолио; однако вы также можете использовать html, если хотите использовать более традиционные инструменты для создания веб-сайтов. После того, как мы настроим наш веб-сайт, мы будем использовать одну из существующих тем от Jekyll, чтобы придать ему более эстетичный вид.
Конечный результат: https://playingnumbers.github.io/Ken_Portfolio/
Видеоверсия этого руководства: https://www.youtube.com/watch?v=1aXk2RViq3c
Шаг 1. Создайте новое репозиторий GitHub
Сначала мы создаем новое репо и инициализируем файл README.md.
Шаг 2. Зайдите в настройки и прокрутите вниз до раздела GitHub Pages.
Щелкните вкладку настроек репо в правом углу списка.
Прокрутите вниз, где находится поле Github Pages.
Переключите источник с Нет на главную ветку.
Шаг 3. Убедитесь, что ваш сайт работает
Щелкните ссылку вверху раздела страниц GitHub, чтобы перейти на свой новый веб-сайт.
Веб-страница должна отображать содержимое README.md вашего репо.
Поздравляю! у вас уже есть рабочий сайт. Если вы получаете ошибку 404, не волнуйтесь. Иногда настройка сервера занимает немного времени (по моему опыту, это может занять до 5 минут)
Шаг 4. Добавьте содержимое веб-сайта в файл README.md
Поскольку на веб-странице отображается README, все, что вам нужно сделать, это изменить его, чтобы отображалось то, что вы хотите на своем веб-сайте. Вы делаете это с помощью уценки (я настоятельно рекомендую эту шпаргалку https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet).
Если у вас уже есть проекты с подробными файлами README, вы можете просто скопировать и вставить их.
Сначала щелкните значок редактирования в правом верхнем углу README.
Затем заполните этот раздел тем контентом, который вы хотите разместить на своем веб-сайте. Что касается себя, я просто использовал обзоры проектов из некоторых проектов, которые я делал ранее. Я также связался с другими репозиториями и добавил несколько простых картинок. В руководстве по уценке (см. Выше) показано, как все это делать.
Вы можете нажать кнопку предварительного просмотра изменений, чтобы увидеть, как все будет выглядеть на веб-страницах.
Чтобы добавить изображения на сайт, вам необходимо создать отдельную папку с изображениями. Вы используете путь к изображениям в этой папке, чтобы они отображались на экране.
Чтобы создать папку изображений в github, вы нажимаете кнопку создания нового файла над содержимым репо.
В месте назначения файла введите images / README.md
Затем перейдите вниз и нажмите кнопку «зафиксировать новый файл». Вам не нужно добавлять сюда какой-либо контент.
Когда вы вернетесь в свое портфолио, вы должны увидеть папку с изображениями.
Теперь щелкните папку изображений и загрузите файлы, которые хотите показать на своем веб-сайте.
Чтобы изображение отображалось на вашем веб-сайте, вы должны использовать этот формат пути в разметке:! [] (/ Images / your_image.png)
Шаг 5: Выберите тему
На этом этапе у вас должен быть очень простой веб-сайт, который выглядит точно так же, как README репозитория github. Если вы хотите добавить базовое форматирование, вы можете использовать тему от Jekyll.
Для этого вы снова нажимаете кнопку настроек репо и возвращаетесь в окно настроек Github Pages.
На этот раз вы нажимаете кнопку «Сменить тему».
Вверху выберите нужную тему и нажмите «Выбрать тему».
Если вы вернетесь в свое репо, у вас должен быть файл _config.yml. Это то, что управляет темой. Если его удалить, тема исчезнет.
Теперь перейдите на свой веб-сайт, у вас должно быть простое портфолио с выбранной вами темой!