Люди с разрешениями на запись в репозитории могут добавлять содержимое на сайт 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 Enterprise Server. Затем протестируйте сайт локально. Дополнительные сведения см. в разделе Локальное тестирование сайта GitHub Pages с помощью Jekyll.
Добавление на сайт новой страницы
-
В GitHub Enterprise Serverперейдите в репозиторий сайта. 1. Перейдите к источнику публикации для сайта. Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages.
-
В корне источника публикации создайте новый файл для страницы с именем
PAGE-NAME.md
, заменив PAGE-NAME значимым именем файла для страницы. -
Добавьте следующий интерфейс 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
-
Под заглавным блоком добавьте содержимое для страницы.
-
В поле "Сообщение о фиксации" введите короткое осмысленное сообщение о фиксации, описывающее изменения, внесенные в файл. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе Создание фиксации с несколькими авторами. 1. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание запроса на включение изменений.
1. Нажмите кнопку Зафиксировать изменения или Предложить изменения. 1. Создайте запрос на вытягивание для предлагаемых изменений. -
В списке "Запросы на вытягивание" щелкните запрос на вытягивание, который хотите объединить. 1. Щелкните Выполнить слияние запросов на вытягивание. Дополнительные сведения см. в разделе Слияние запроса на вытягивание. 1. При появлении запроса введите сообщение о фиксации или примите сообщение по умолчанию. 1. Щелкните Подтвердить слияние. 1. При необходимости удалите ветвь. Дополнительные сведения см. в разделе Создание и удаление ветвей в репозитории.
Добавление на сайт новой записи
-
В GitHub Enterprise Serverперейдите в репозиторий сайта. 1. Перейдите к источнику публикации для сайта. Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages.
-
Перейдите к каталогу
_posts
. -
Создайте файл с именем
YYYY-MM-DD-NAME-OF-POST.md
, заменив ГГГГ-ММ-ДД датой публикации, а NAME-OF-POST — именем публикации. -
Добавьте следующий интерфейс YAML в начало файла, включая заголовок записи, заключенный в кавычки, дату и время записи в формате ГГГГ-ММ-ДД чч:мм:сс -0000, а также столько категорий, сколько нужно для публикации.
layout: post title: "POST-TITLE" date: YYYY-MM-DD hh:mm:ss -0000 categories: CATEGORY-1 CATEGORY-2
-
Под заглавным блоком добавьте содержимое для записи.
-
В поле "Сообщение о фиксации" введите короткое осмысленное сообщение о фиксации, описывающее изменения, внесенные в файл. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе Создание фиксации с несколькими авторами. 1. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание запроса на включение изменений.
1. Нажмите кнопку Зафиксировать изменения или Предложить изменения. 1. Создайте запрос на вытягивание для предлагаемых изменений. -
В списке "Запросы на вытягивание" щелкните запрос на вытягивание, который хотите объединить. 1. Щелкните Выполнить слияние запросов на вытягивание. Дополнительные сведения см. в разделе Слияние запроса на вытягивание. 1. При появлении запроса введите сообщение о фиксации или примите сообщение по умолчанию. 1. Щелкните Подтвердить слияние. 1. При необходимости удалите ветвь. Дополнительные сведения см. в разделе Создание и удаление ветвей в репозитории.
Теперь ваша запись должна появиться на вашем сайте! Если базовый URL-адрес вашего сайта — https://octocat.github.io
, новая публикация будет размещена по адресу https://octocat.github.io/YYYY/MM/DD/TITLE.html
.
Дальнейшие действия
Вы можете добавить тему Jekyll на сайт GitHub Pages, чтобы настроить его внешний вид. Дополнительные сведения см. в разделе Добавление темы на сайт GitHub Pages с помощью Jekyll.