Skip to main content
Мы публикуем частые обновления нашей документации, и перевод этой страницы может все еще выполняться. Актуальные сведения см. в документации на английском языке.

Hover over a link to another article to get more details. If you have ideas for how we can improve this page, let us know in the discussion.

Добавление содержимого на сайт GitHub Pages с помощью Jekyll

Можно добавить новую страницу или сделать публикацию на сайте Jekyll в GitHub Pages.

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

Люди с разрешениями на запись в репозитории могут добавлять содержимое на сайт GitHub Pages с помощью Jekyll.

О содержимом на сайтах Jekyll

Прежде чем добавлять содержимое на сайт Jekyll в GitHub Pages, необходимо создать сайт Jekyll. Дополнительные сведения см. в разделе Создание сайта GitHub Pages с помощью Jekyll.

Основными типами содержимого для сайтов Jekyll являются страницы и записи. Страница предназначена для автономного содержимого, которое не связано с определенной датой, как, например, страница "Сведения". Сайт Jekyll по умолчанию содержит файл с именем about.md, который отображается как страница на вашем сайте в YOUR-SITE-URL/about. Вы можете изменять содержимое этого файла, чтобы персонализировать страницу "Сведения", а также использовать страницу "Сведения" в качестве шаблона для создания новых страниц. Дополнительные сведения см. в разделе Страницы в документации Jekyll.

Запись — это запись блога. Сайт Jekyll по умолчанию содержит каталог с именем _posts, в котором находится файл записи по умолчанию. Вы можете изменять содержимое этой записи и использовать запись по умолчанию в качестве шаблона для создания новых записей. Дополнительные сведения см. в разделе Записи в документации Jekyll.

Тема включает макеты по умолчанию, включаемые объекты и таблицы стилей, которые будут автоматически применяться к новым страницам и записям на сайте, но вы можете переопределить любой из этих стандартных объектов. Дополнительные сведения см. в разделе Сведения о GitHub Pages и Jekyll.

Чтобы задать переменные и метаданные, такие как название и макет, для страницы или публикации на сайте, можно добавить титульный лист YAML в начало любого файла Markdown или HTML. Дополнительные сведения см. в статье "Титульный лист" в документации по Jekyll.

Если публикация выполняется из ветви, изменения на сайте публикуются автоматически при слиянии изменений в источнике публикации сайта. Если публикация выполняется с помощью пользовательского рабочего процесса GitHub Actions, изменения публикуются при каждой активации рабочего процесса (обычно за счет отправки в ветвь по умолчанию). Для предварительного просмотра изменений можно внести их локально, а не в GitHub. Затем протестируйте сайт локально. Дополнительные сведения см. в разделе Локальное тестирование сайта GitHub Pages с помощью Jekyll.

Добавление на сайт новой страницы

  1. В GitHubперейдите в репозиторий сайта. 1. Перейдите к источнику публикации для сайта. Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages.
  2. В корне источника публикации создайте новый файл для страницы с именем PAGE-NAME.md, заменив PAGE-NAME значимым именем файла для страницы.
  3. Добавьте следующий интерфейс YAML в начало файла, заменив PAGE-TITLE заголовком страницы, а URL-PATH — путем к URL-адресу страницы. Например, если базовый URL-адрес сайта — https://octocat.github.io, а ваш URL-PATH — /about/contact/, страница будет находиться по адресу https://octocat.github.io/about/contact.
    layout: page
    title: "PAGE-TITLE"
    permalink: /URL-PATH
  4. Под заглавным блоком добавьте содержимое для страницы.
  5. Щелкните Зафиксировать изменения...
  6. В поле Commit message (Сообщение о фиксации) введите короткое осмысленное сообщение о фиксации, описывающее изменения, внесенные в файл. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе Создание фиксации с несколькими авторами.
  7. Если у вас есть несколько адресов электронной почты, связанных с вашей учетной записью в GitHub.com, щелкните раскрывающееся меню адрес электронной почты и выберите адрес электронной почты, который будет использоваться в качестве адреса электронной почты автора Git. В этом раскрывающемся меню отображаются только проверенные адреса электронной почты. Если вы включили сохранение конфиденциальности адресов электронной почты, то по умолчанию используется адрес электронной почты автора фиксации <username>@users.noreply.github.com. Дополнительные сведения см. в разделе Указание адреса электронной почты для фиксаций. Выбор адресов электронной почты для фиксаций 1. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание запроса на включение изменений. Параметры фиксации ветви 1. Щелкните Предложить изменение файла. 1. Создайте запрос на вытягивание для предлагаемых изменений.
  8. В списке "Запросы на вытягивание" щелкните запрос на вытягивание, который хотите объединить. 1. Щелкните Выполнить слияние запросов на вытягивание. Дополнительные сведения см. в разделе Слияние запроса на вытягивание. 1. При появлении запроса введите сообщение о фиксации или примите сообщение по умолчанию. 1. Щелкните Подтвердить слияние. 1. При необходимости удалите ветвь. Дополнительные сведения см. в разделе Создание и удаление ветвей в репозитории.

Добавление на сайт новой записи

  1. В GitHubперейдите в репозиторий сайта. 1. Перейдите к источнику публикации для сайта. Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages.
  2. Перейдите к каталогу _posts.
  3. Создайте файл с именем YYYY-MM-DD-NAME-OF-POST.md, заменив ГГГГ-ММ-ДД датой публикации, а NAME-OF-POST — именем публикации.
  4. Добавьте следующий интерфейс YAML в начало файла, включая заголовок записи, заключенный в кавычки, дату и время записи в формате ГГГГ-ММ-ДД чч:мм:сс -0000, а также столько категорий, сколько нужно для публикации.
    layout: post
    title: "POST-TITLE"
    date: YYYY-MM-DD hh:mm:ss -0000
    categories: CATEGORY-1 CATEGORY-2
  5. Под заглавным блоком добавьте содержимое для записи.
  6. Щелкните Зафиксировать изменения...
  7. В поле Commit message (Сообщение о фиксации) введите короткое осмысленное сообщение о фиксации, описывающее изменения, внесенные в файл. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе Создание фиксации с несколькими авторами.
  8. Если у вас есть несколько адресов электронной почты, связанных с вашей учетной записью в GitHub.com, щелкните раскрывающееся меню адрес электронной почты и выберите адрес электронной почты, который будет использоваться в качестве адреса электронной почты автора Git. В этом раскрывающемся меню отображаются только проверенные адреса электронной почты. Если вы включили сохранение конфиденциальности адресов электронной почты, то по умолчанию используется адрес электронной почты автора фиксации <username>@users.noreply.github.com. Дополнительные сведения см. в разделе Указание адреса электронной почты для фиксаций. Выбор адресов электронной почты для фиксаций 1. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание запроса на включение изменений. Параметры фиксации ветви 1. Щелкните Предложить изменение файла. 1. Создайте запрос на вытягивание для предлагаемых изменений.
  9. В списке "Запросы на вытягивание" щелкните запрос на вытягивание, который хотите объединить. 1. Щелкните Выполнить слияние запросов на вытягивание. Дополнительные сведения см. в разделе Слияние запроса на вытягивание. 1. При появлении запроса введите сообщение о фиксации или примите сообщение по умолчанию. 1. Щелкните Подтвердить слияние. 1. При необходимости удалите ветвь. Дополнительные сведения см. в разделе Создание и удаление ветвей в репозитории.

Теперь ваша запись должна появиться на вашем сайте! Если базовый URL-адрес вашего сайта — https://octocat.github.io, новая публикация будет размещена по адресу https://octocat.github.io/YYYY/MM/DD/TITLE.html.

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

Вы можете добавить тему Jekyll на сайт GitHub Pages, чтобы настроить его внешний вид. Дополнительные сведения см. в разделе Добавление темы на сайт GitHub Pages с помощью Jekyll.