Skip to main content

Esta versão do GitHub Enterprise foi descontinuada em 2022-10-12. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Testar o site do GitHub Pages localmente com o Jekyll

Você pode criar o site do GitHub Pages localmente para visualizar e testar as alterações nele.

GitHub Pages está disponível em repositórios públicos com GitHub Free e GitHub Free para organizações, e em repositórios públicos e privados com GitHub Pro, GitHub Team, GitHub Enterprise Cloud e GitHub Enterprise Server.

Qualquer pessoa com permissões de leitura para um repositório pode testar um site do GitHub Pages localmente.

Pré-requisitos

Antes de usar o Jekyll para testar um site, você deve:

Recomendamos usar o Bundler para instalar e executar o Jekyll. O Bundler gerencia as dependências do gem do Ruby, reduz os erros de compilação do Jekyll e evita erros relacionados ao ambiente. Para instalar o bundler:

  1. Instale o Ruby. Para obter mais informações, confira "Como instalar o Ruby" na documentação do Ruby.
  2. Instale o Bundler. Para obter mais informações, confira "Bundler".

Dica: caso você receba um erro do Ruby ao tentar instalar o Jekyll usando o Bundler, talvez seja necessário usar um gerenciador de pacotes, como o RVM ou o Homebrew, para gerenciar a instalação do Ruby. Para obter mais informações, confira "Solução de problemas" na documentação do Jekyll.

Criar site localmente

  1. Abra TerminalTerminalGit Bash. 1. Navegue até a fonte de publicação do seu site. Para obter mais informações, confira "Como configurar uma fonte de publicação para o seu site do GitHub Pages."
  2. Execute bundle install.
  3. Execute o site do Jekyll localmente.
    $ 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.
  4. Para visualizar seu site, no navegador da Web, navegue até http://localhost:4000.

Observação: se você estiver usando o Ruby 3.0 e o Jekyll 4.2.x ou uma versão mais antiga, precisará adicionar o gem webrick ao Gemfile do projeto antes de executar bundle install.

Atualizar o gem do GitHub Pages

O Jekyll é um projeto ativo de código aberto que é atualizado com frequência. Se o gem github-pages do computador estiver desatualizado com o gem github-pages do servidor do GitHub Pages, seu site poderá parecer diferente quando criado localmente do que quando publicado no GitHub Enterprise Server. Para evitar isso, atualize regularmente o gem github-pages do computador.

  1. Abra TerminalTerminalGit Bash.
  2. Atualize o gem github-pages.
    • Se você instalou o Bundler, execute bundle update github-pages.
    • Se você não tiver o Bundler instalado, execute gem update github-pages.

Leitura adicional