Примечание. Владельцы организации могут ограничить публикацию сайтов GitHub Pages из репозиториев, принадлежащих организации. Дополнительные сведения см. в разделе Управление публикацией сайтов GitHub Pages.
Предварительные требования
Прежде чем использовать Jekyll для создания сайта GitHub Pages, необходимо установить Jekyll и Git. Дополнительные сведения см. в разделах Установка в документации по Jekyll и Настройка Git.
Мы рекомендуем использовать Средство увязки программ в пакеты для установки и запуска Jekyll. Средство увязки программ в пакеты управляет зависимостями Ruby, уменьшает ошибки сборки Jekyll и предотвращает ошибки, связанные со средой. Чтобы установить Средство увязки программ в пакеты, выполните следующие действия.
- Установите Ruby. Дополнительные сведения см. в разделе Установка Ruby документации по Ruby.
- Установка Средства увязки программ в пакеты. Дополнительную информацию см. в разделе Средство увязки программ в пакеты.
Совет. Если при попытке установить Jekyll с помощью Средства связывания программ в пакеты возникает ошибка Ruby, может потребоваться использовать диспетчер пакетов, например RVM или Homebrew для управления установкой Ruby. Дополнительные сведения см. в статье Устранение неполадок в документации по Jekyll.
Создание репозитория для сайта
Для сайта можно создать новый репозиторий или выбрать существующий.
Если необходимо создать сайт GitHub Pages для репозитория, в котором не все файлы имеют отношение к сайту, можно настроить источник публикации. Например, вы можете иметь выделенную ветвь и папку для хранения исходных файлов , или использовать пользовательский рабочий процесс GitHub Actions для создания и развертывания исходных файлов сайта.
Если учетная запись, которой принадлежит репозиторий, использует GitHub Free или GitHub Free для организаций, репозиторий должен быть общедоступным.
Чтобы создать сайт в существующем репозитории, перейдите к разделу Создание сайта.
- В правом верхнем углу любой страницы откройте раскрывающееся меню и выберите Новый репозиторий.
1. В раскрывающемся меню Владелец выберите учетную запись, которая должна владеть репозиторием.
Примечание: Если вы являетесь managed user account, вы можете публиковать сайты GitHub Pages только из репозиториев, принадлежащих организациям. Дополнительные сведения см. в статье Сведения о GitHub Pages.1. Введите имя репозитория и необязательное описание. Если вы создаете сайт пользователя или организации, репозиторию необходимо присвоить имя `.github.io` или ` .github.io`. Если имя пользователя или организации содержит прописные буквы, необходимо преобразовать их в нижний регистр. Дополнительные сведения см. в статье [Сведения о GitHub Pages](/articles/about-github-pages#types-of-github-pages-sites).  1. Настройте видимость репозитория. Дополнительные сведения см. в разделе [Сведения о репозиториях](/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility). 
Создание сайта
Перед созданием сайта необходимо иметь репозиторий для сайта на GitHub Enterprise Cloud. Если вы создаете сайт не в существующем репозитории, см. инструкции в статье Создание репозитория для сайта.
Предупреждение. Если ваше предприятие не использует Enterprise Managed Users, сайты GitHub Pages по умолчанию находятся в открытом доступе, даже если репозиторий для сайта является частным или внутренним. Для публикации сайта с закрытым доступом используйте управление доступом. Либо, если в репозитории вашего сайта есть конфиденциальные данные, удалите их перед публикацией. Дополнительные сведения см. в разделах Сведения о репозиториях и Изменение видимости сайта GitHub Pages.
-
Откройте ТерминалТерминалGIT Bash.
-
Если у вас еще нет локальной копии репозитория, перейдите к расположению, где вы хотите хранить исходные файлы сайта, заменив PARENT-FOLDER папкой, в которой должна содержаться папка для репозитория.
$ cd PARENT-FOLDER
-
Если это еще не сделано, инициализируйте локальный репозиторий Git, заменив REPOSITORY-NAME именем вашего репозитория.
$ git init REPOSITORY-NAME > Initialized empty Git repository in /Users/octocat/my-site/.git/ # Creates a new folder on your computer, initialized as a Git repository
-
Измените каталоги на репозиторий.
$ cd REPOSITORY-NAME # Changes the working directory
-
Укажите, какой источник публикации вы хотите использовать. Дополнительные сведения см. в статье "Настройка источника публикации для сайта GitHub Pages". 1. Перейдите к источнику публикации для сайта. Дополнительные сведения см. в статье "Настройка источника публикации для сайта GitHub Pages". Например, если вы решили опубликовать свой сайт из папки
docs
в ветви по умолчанию, создайте и измените каталоги на папкуdocs
.$ mkdir docs # Creates a new folder called docs $ cd docs
Если вы решили опубликовать свой сайт из ветви
gh-pages
, создайте и проверьте ветвьgh-pages
.$ git checkout --orphan gh-pages # Creates a new branch, with no history or contents, called gh-pages, and switches to the gh-pages branch $ git rm -rf . # Removes the contents from your default branch from the working directory
-
Чтобы создать новый сайт Jekyll, используйте команду
jekyll new
:$ jekyll new --skip-bundle . # Creates a Jekyll site in the current directory
-
Откройте файл Gemfile, созданный Jekyll.
-
Добавьте "#" в начало строки, которая начинается с
gem "jekyll"
, чтобы закомментировать эту строку. -
Добавьте зависимость
github-pages
, изменив строку, начинающуюся с# gem "github-pages"
. Измените эту строку следующим образом:gem "github-pages", "~> GITHUB-PAGES-VERSION", group: :jekyll_plugins
Замените GITHUB-PAGES-VERSION последней поддерживаемой версией зависимости
github-pages
. Эту версию можно найти здесь: Версии зависимостей.Правильная версия Jekyll будет установлена в качестве зависимости gem
github-pages
. -
Сохраните и закройте Gemfile.
-
Выполните из командной строки команду
bundle install
. -
При необходимости внесите нужные изменения в файл
_config.yml
. Это требуется для относительных путей, когда репозиторий размещается в подкаталоге. Дополнительные сведения см. в разделе Разделение вложенной папки в новый репозиторий.domain: my-site.github.io # if you want to force HTTPS, specify the domain without the http at the start, e.g. example.com url: https://my-site.github.io # the base hostname and protocol for your site, e.g. http://example.com baseurl: /REPOSITORY-NAME/ # place folder name if the site is served in a subfolder
-
При желании протестируйте сайт локально. Дополнительные сведения см. в разделе Локальное тестирование сайта GitHub Pages с помощью Jekyll.
-
Добавьте и зафиксируйте свою работу.
git add . git commit -m 'Initial GitHub pages site with Jekyll'
-
Добавьте репозиторий в GitHub.com в качестве удаленного, замена USER учетной записью, которая владеет репозиторием и REPOSITORY именем репозитория.
$ git remote add origin https://github.com/USER/REPOSITORY.git
-
Отправьте репозиторий в GitHub Enterprise Cloud, заменив BRANCH именем ветви, в которой вы работаете.
$ git push -u origin BRANCH
-
Настройте источник публикации. Дополнительные сведения см. в разделе Настройка источника публикации для сайта GitHub Pages. 1. В GitHub Enterprise Cloudперейдите в репозиторий сайта. 1. Нажмите Параметры под именем репозитория.
-
В разделе «Код и автоматизация» на боковой панели щелкните Страницы .
-
При необходимости, если вы публикуете сайт проекта из частного или внутреннего репозитория, выберите видимость для вашего сайта. В разделе GitHub Pages", выберите раскрывающийся список в меню настроек видимости GitHub Pages , а затем выберите настройку видимости. Дополнительные сведения см. в разделе Изменение видимости сайта GitHub Pages.
<div class="extended-markdown note border rounded-1 mb-4 p-3 color-border-accent-emphasis color-bg-accent f5">
Примечание. Для публикации сайта GitHub Pages в конфиденциальном режиме ваша организация должна использовать GitHub Enterprise Cloud. Дополнительные сведения о том, как бесплатно попробовать GitHub Enterprise Cloud, см. в разделе Настройка пробной версии GitHub Enterprise Cloud.
1. Чтобы просмотреть опубликованный сайт, в разделе "GitHub Pages" щелкните ** Посетить сайт**. Примечание. Публикация изменений на сайте после передачи изменений в GitHub Enterprise Cloud может занять до 10 минут. Если через час изменения сайта GitHub Pages все еще не отображаются в браузере, см. раздел Сведения об ошибках сборки Jekyll для сайтов GitHub Pages.
-
Ваш сайт GitHub Pages создан и развернут с помощью рабочего процесса GitHub Actions. Дополнительные сведения см. в статье Просмотр журнала выполнения рабочего процесса.
Примечание. GitHub Actions предоставляется бесплатно для общедоступных репозиториев. Плата за использование начисляется для частных и внутренних репозиториев, которые превышают число выделяемых ежемесячно бесплатных минут. Дополнительные сведения см. в статье Ограничения использования, выставление счетов и администрирование.
Примечание. Если публикация выполняется из ветви и сайт не публикуется автоматически, убедитесь, что пользователь с разрешениями администратора и проверенным адресом электронной почты отправил изменения в источник публикации.
Дальнейшие действия
О добавлении на сайт новой страницы или публикации см. в разделе Добавление содержимого на сайт GitHub Pages с помощью Jekyll.
Вы можете добавить тему Jekyll на сайт GitHub Pages, чтобы настроить его внешний вид. Дополнительные сведения см. в разделе Добавление темы на сайт GitHub Pages с помощью Jekyll.