Как создать простое и бесплатное веб-портфолио с помощью страниц 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. Это то, что управляет темой. Если его удалить, тема исчезнет.

Теперь перейдите на свой веб-сайт, у вас должно быть простое портфолио с выбранной вами темой!