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

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

В этой статье

Вы можете персонализировать свой сайт Jekyll, добавив и настроив тему оформления.

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

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

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

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

  1. В GitHubперейдите в репозиторий сайта.
  2. Перейдите к источнику публикации для сайта. Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages.
  3. Перейдите к _config.yml.
  4. В правом верхнем углу представления файлов щелкните , чтобы открыть редактор файлов. Снимок экрана: файл. В заголовке кнопка, помеченная значком карандаша, выделена темно-оранжевым цветом.

Примечание: Вместо редактирования и фиксации файла с помощью редактора файлов по умолчанию можно выбрать редактор кода github.dev , выбрав раскрывающееся меню и щелкнув github.dev. Вы также можете клонировать репозиторий и изменить файл локально с помощью GitHub Desktop, щелкнув GitHub Desktop.

Снимок экрана: файл. В заголовке значок треугольника, обращенный вниз, выделен темно-оранжевым цветом.

4. Добавьте в файл новую строку для имени темы. - Чтобы использовать поддерживаемую тему, введите `theme: THEME-NAME`, заменив _THEME-NAME_ именем темы, как показано в файле README репозитория темы. Полный список поддерживаемых тем см. в разделе [Поддерживаемые темы](https://pages.github.com/themes/) на сайте GitHub Pages. Например, чтобы выбрать тему Minima, введите `theme: minima`. - Чтобы использовать любую другую тему Jekyll, размещенную на GitHub, введите `remote_theme: THEME-NAME`, заменив THEME-NAME именем темы, как показано в файле README репозитория темы.

  1. Щелкните Зафиксировать изменения...

  2. В поле "Сообщение о фиксации" введите короткое осмысленное сообщение о фиксации, описывающее изменения, внесенные в файл. В таком сообщении фиксацию можно отнести к нескольким авторам. Дополнительные сведения см. в разделе Создание фиксации с несколькими авторами.

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

    Снимок экрана: запрос на вытягивание GitHub с раскрывающимся меню с параметрами выбора автор фиксации адреса электронной почты. octocat@github.com.

  4. Под полями сообщения о фиксации укажите, куда следует добавить фиксацию: в текущую ветвь или в новую. Если текущей ветвью является ветвь по умолчанию, нужно создать новую ветвь для фиксации, а затем создать запрос на вытягивание. Дополнительные сведения см. в разделе Создание запроса на включение изменений.

    Снимок экрана: запрос на вытягивание GitHub с переключателем для фиксации непосредственно в ветви main или для создания новой ветви. Выбрана новая ветвь.

  5. Нажмите кнопку Зафиксировать изменения или Предложить изменения.

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

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

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

  1. В GitHubперейдите в репозиторий сайта.

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

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

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

    ---
---

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

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

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

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

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

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

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