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

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

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

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

В этой статье

Введение

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

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

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

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

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

           ![Снимок экрана: параметры GitHub Pages в репозитории. Поле имени репозитория содержит текст "octocat.github.io" и описывается темно-оранжевым цветом.](/assets/images/help/pages/create-repository-name-pages.png)

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

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

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

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

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

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

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

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

           ![Снимок экрана: параметры страниц в репозитории GitHub . Меню для выбора ветви для источника публикации с меткой "Нет", описано в темно-оранжевый цвет.](/assets/images/help/pages/publishing-source-drop-down.png)

  10. При необходимости откройте файл README.md репозитория. В файл README.md будет записываться содержимое сайта. Вы можете изменить его или пока что сохранить его содержимое.

  11. Посетите username.github.io, чтобы просмотреть новый веб-сайт. Обратите внимание, что изменение сайта может занять до 10 минут после отправки изменений в GitHub.

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

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

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

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

  3. Щелкните , чтобы изменить файл.

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

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

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

Дальнейшие шаги

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