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

Поддержка этой версии GitHub Enterprise была прекращена 2023-03-15. Исправления выпускаться не будут даже при критических проблемах безопасности. Для повышения производительности, укрепления безопасности и новых функций установите последнюю версию GitHub Enterprise. Чтобы получить справку по обновлению, обратитесь в службу поддержки GitHub Enterprise.

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 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 Enterprise Server. Затем протестируйте сайт локально. Дополнительные сведения см. в разделе Локальное тестирование сайта GitHub Pages с помощью Jekyll.

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

  1. В GitHub Enterprise Serverперейдите в репозиторий сайта. 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 (Сообщение о фиксации) введите короткое осмысленное сообщение о фиксации, описывающее изменения, внесенные в файл. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе Создание фиксации с несколькими авторами. 1. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание запроса на включение изменений. Параметры фиксации ветви 1. Щелкните Предложить изменение файла. 1. Создайте запрос на вытягивание для предлагаемых изменений.
  7. В списке "Запросы на вытягивание" щелкните запрос на вытягивание, который хотите объединить. 1. Щелкните Выполнить слияние запросов на вытягивание. Дополнительные сведения см. в разделе Слияние запроса на вытягивание. 1. При появлении запроса введите сообщение о фиксации или примите сообщение по умолчанию. 1. Щелкните Подтвердить слияние. 1. При необходимости удалите ветвь. Дополнительные сведения см. в разделе Создание и удаление ветвей в репозитории.

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

  1. В GitHub Enterprise Serverперейдите в репозиторий сайта. 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 (Сообщение о фиксации) введите короткое осмысленное сообщение о фиксации, описывающее изменения, внесенные в файл. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе Создание фиксации с несколькими авторами. 1. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание запроса на включение изменений. Параметры фиксации ветви 1. Щелкните Предложить изменение файла. 1. Создайте запрос на вытягивание для предлагаемых изменений.
  8. В списке "Запросы на вытягивание" щелкните запрос на вытягивание, который хотите объединить. 1. Щелкните Выполнить слияние запросов на вытягивание. Дополнительные сведения см. в разделе Слияние запроса на вытягивание. 1. При появлении запроса введите сообщение о фиксации или примите сообщение по умолчанию. 1. Щелкните Подтвердить слияние. 1. При необходимости удалите ветвь. Дополнительные сведения см. в разделе Создание и удаление ветвей в репозитории.

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

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

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