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

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

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

Добавление темы

1. В GitHubперейдите в репозиторий сайта. 1. Перейдите к источнику публикации для сайта. Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages.

2. Перейдите к _config.yml.

3. В правом верхнем углу представления файла щелкните , чтобы открыть редактор файлов.

   

   Примечание. Вместо редактирования и фиксации файла с помощью редактора файлов по умолчанию можно использовать редактор кода github.dev. Для этого щелкните раскрывающееся меню рядом с и нажмите Открыть в github.dev.

   

4. Добавьте в файл новую строку для имени темы.

   • Чтобы использовать поддерживаемую тему, введите theme: THEME-NAME, заменив THEME-NAME именем темы, как показано в файле README репозитория темы. Полный список поддерживаемых тем см. в разделе Поддерживаемые темы на сайте GitHub Pages.
   • Чтобы использовать любую другую тему Jekyll, размещенную на GitHub, введите remote_theme: THEME-NAME, заменив THEME-NAME именем темы, как показано в файле README репозитория темы. 1. В нижней части страницы введите короткое понятное сообщение о фиксации, описывающее внесенное в файл изменение. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе Создание фиксации с несколькими авторами.

5. Если у вас есть несколько адресов электронной почты, связанных с вашей учетной записью в GitHub.com, щелкните раскрывающееся меню адрес электронной почты и выберите адрес электронной почты, который будет использоваться в качестве адреса электронной почты автора Git. В этом раскрывающемся меню отображаются только проверенные адреса электронной почты. Если вы включили сохранение конфиденциальности адресов электронной почты, то по умолчанию используется адрес электронной почты автора фиксации <username>@users.noreply.github.com. Дополнительные сведения см. в разделе Указание адреса электронной почты для фиксаций. 1. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание запроса на включение изменений. 1. Щелкните Предложить изменение файла.

Настройка CSS-темы

Эти инструкции лучше всего подходят для тем, которые официально поддерживаются GitHub Pages. Полный список поддерживаемых тем см. в статье "Поддерживаемые темы" на сайте GitHub Pages.

Исходный репозиторий темы может помочь в настройке темы. Например, см. файл сведений о Minima.

1. В GitHubперейдите в репозиторий сайта. 1. Перейдите к источнику публикации для сайта. Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages.

2. Создайте файл под именем /assets/css/style.scss.

3. Добавьте следующее содержимое в верхнюю часть файла:

   ---
   ---
   
   @import "{{ site.theme }}";
   

4. Добавьте любые пользовательские CSS или Sass (включая импорты) сразу после строки @import.

Настройка макета HTML-темы

Эти инструкции лучше всего подходят для тем, которые официально поддерживаются GitHub Pages. Полный список поддерживаемых тем см. в статье "Поддерживаемые темы" на сайте GitHub Pages.

Исходный репозиторий темы может помочь в настройке темы. Например, см. файл сведений о Minima.

1. Перейдите к исходному репозиторию вашей темы в GitHub. Например, исходный репозиторий для темы Minima — https://github.com/jekyll/minima.
2. В папке _layouts перейдите к файлу default.html вашей темы.
3. Скопируйте содержимое файла.
4. В GitHubперейдите в репозиторий сайта. 1. Перейдите к источнику публикации для сайта. Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages.
5. Создайте файл с именем _layouts/default.html.
6. Вставьте скопированное ранее содержимое макета по умолчанию.
7. Настройте макет как вам нужно.

Дополнительные материалы

• "Создание новых файлов"