Быстрый старт для страниц GitHub

Вы можете использовать GitHub Pages для демонстрации открытый код проектов, размещения блога или даже совместного использования вашего résumé. Это руководство поможет вам приступить к созданию вашего нового веб-сайта.

Кто может использовать эту функцию?

GitHub Pages доступен в общедоступных репозиториях с GitHub Free и GitHub Free для организаций, а также в общедоступных и частных репозиториях с GitHub Pro, GitHub Team, GitHub Enterprise Cloudи GitHub Enterprise Server. См . раздел AUTOTITLE.

В этой статье

Введение

В этом руководстве вы создадите на сайте <username>.github.ioпользователя.

Создание веб-сайта

  1. В правом верхнем углу любой страницы выберите , а затем нажмите кнопку "Создать репозиторий".

    Снимок экрана: раскрывающееся меню GitHub с параметрами создания новых элементов. Пункт меню "Новый репозиторий" описан в темно-оранжевый.

  2. Введите username.github.io в качестве имени репозитория. Замените username на ваш GitHub ник. Например, если имя пользователя — octocat, именем репозитория должно быть octocat.github.io.

Снимок экрана: параметры GitHub Pages в репозитории. Поле имени репозитория содержит текст «octocat.github.io» и обведено тёмно-оранжевым цветом.

  1. Настройте видимость репозитория. Дополнительные сведения см. в разделе Сведения о репозиториях.

  2. Включите параметр «Добавить файл сведений».****

  3. Щелкните Создать репозиторий.

  4. Под именем репозитория щелкните Settings. Если вкладка "Параметры" не отображается, выберите раскрывающееся меню и нажмите кнопку "Параметры".

    Снимок экрана: заголовок репозитория с вкладками. Вкладка "Параметры" выделена темно-оранжевым контуром.

  5. В разделе "Код и автоматизация" боковой панели щелкните Pages.

  6. В разделе "Сборка и развертывание" в пункте "Источник" выберите Развернуть из ветви.

  7. В разделе "Сборка и развертывание" в разделе "Ветвь" используйте раскрывающееся меню ветви и выберите источник публикации.

Снимок экрана: параметры страниц в репозитории GitHub . Меню для выбора ветви для источника публикации с меткой "Нет", описано в темно-оранжевый цвет.

  1. При необходимости откройте файл README.md репозитория. В файл README.md будет записываться содержимое сайта. Вы можете изменить его или пока что сохранить его содержимое.
  2. Посетите username.github.io, чтобы просмотреть новый веб-сайт. Обратите внимание, что публикация изменений на вашем сайте может занять до 10 минут после того, как вы отправите изменения в GitHub.

Изменение заголовка и описания

По умолчанию сайт имеет заголовок username.github.io. Вы можете изменить заголовок путем изменения файла _config.yml в репозитории. Можно также добавить описание вашего сайта.

  1. В репозитории нажмите вкладку Код.

  2. В списке файлов проверьте, существует _config.yml ли он. Если его нет, создайте новый файл с именем _config.yml.

  3. В списке файлов нажмите _config.yml, чтобы открыть файл.

  4. Нажмите , чтобы отредактировать файл.

  5. Файл _config.yml уже содержит строку, в которой указана тема для сайта. Добавьте новую строку с title: и нужным заголовком. Добавьте новую строку с description: и нужным описанием. Например:

    theme: jekyll-theme-minimal
title: Octocat's homepage
description: Bookmark this to keep an eye on my project updates!

  6. После завершения редактирования файла нажмите кнопку "Зафиксировать изменения".

Дальнейшие действия

Вы успешно создали, персонализированный и опубликовали свой первый GitHub Pages веб-сайт, но есть так многое другое, чтобы изучить! Вот несколько полезных ресурсов, чтобы сделать следующие шаги с GitHub Pages: