Эта версия GitHub Enterprise Server была прекращена 2024-09-25. Исправления выпускаться не будут даже при критических проблемах безопасности. Для повышения производительности, повышения безопасности и новых функций выполните обновление до последней версии GitHub Enterprise Server. Чтобы получить справку по обновлению, обратитесь в службу поддержки GitHub Enterprise.

Локальное тестирование сайта GitHub Pages с помощью Jekyll

Вы можете создать сайт GitHub Pages локально для предварительного просмотра и тестирования изменений сайта.

Кто может использовать эту функцию?

GitHub Pages is available in public repositories with GitHub Free and GitHub Free for organizations, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server.

Platform navigation

В этой статье

Тестировать сайт GitHub Pages локально может любой пользователь с разрешениями на чтение для репозитория.

Необходимые компоненты

Прежде чем тестировать сайт с помощью Jekyll, необходимо выполнить следующие действия:

Мы рекомендуем использовать Средство увязки программ в пакеты для установки и запуска Jekyll. Средство увязки программ в пакеты управляет зависимостями Ruby, уменьшает ошибки сборки Jekyll и предотвращает ошибки, связанные со средой. Чтобы установить Средство увязки программ в пакеты, выполните следующие действия.

  1. Установите Ruby. Дополнительные сведения см. в разделе "Установка Ruby" в документации по Ruby .
  2. Установка Средства увязки программ в пакеты. Дополнительные сведения см. в разделе Bundler.

Tip

Если при попытке установить Jekyll с помощью Bundler возникает ошибка Ruby, может потребоваться использовать диспетчер пакетов, например RVM или Homebrew, для управления установкой Ruby. Дополнительные сведения см . в документации по Jekyll по устранению неполадок .

Локальное создание сайта

  1. Откройте ТерминалТерминалGIT Bash.

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

  3. Запустите bundle install.

  4. Запустите сайт Jekyll локально.

    $ bundle exec jekyll serve
> Configuration file: /Users/octocat/my-site/_config.yml
>            Source: /Users/octocat/my-site
>       Destination: /Users/octocat/my-site/_site
> Incremental build: disabled. Enable with --incremental
>      Generating...
>                    done in 0.309 seconds.
> Auto-regeneration: enabled for '/Users/octocat/my-site'
> Configuration file: /Users/octocat/my-site/_config.yml
>    Server address: http://127.0.0.1:4000/
>  Server running... press ctrl-c to stop.

    Note

    • Если вы установили Ruby 3.0 или более поздней версии (если вы установили версию по умолчанию через Homebrew), на этом шаге может возникнуть ошибка. Это связано с тем, что эти версии Ruby больше не установлены webrick .

      Чтобы устранить ошибку, попробуйте выполнить bundle add webrick, а затем повторно запустить bundle exec jekyll serve.

    • _config.yml Если поле файла baseurl содержит ссылку репозитория GitHub, вы можете использовать следующую команду при локальном создании, чтобы игнорировать это значение и обслуживать сайт наlocalhost:4000/:

      bundle exec jekyll serve --baseurl=""

  5. Чтобы выполнить предварительный просмотр сайта в веб-браузере, перейдите по адресу http://localhost:4000.

Обновление пакета GitHub Pages

Jekyll — это активный проект с открытым кодом, который регулярно обновляется. github-pages Если драгоценный камень на компьютере устарел с github-pages драгоценным камнем на сервере GitHub Pages, ваш сайт может выглядеть по-разному при локальном построении, чем при публикации на GitHub. Чтобы избежать этого, регулярно обновляйте пакет github-pages на компьютере.

  1. Откройте ТерминалТерминалGIT Bash.
  2. Обновите пакет github-pages.
    • Если установлено средство увязки, выполните команду bundle update github-pages.
    • Если средство увязки не установлено, выполните команду gem update github-pages.

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