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