Configurar uma fonte de publicação para o site do GitHub Pages

Se você usar a fonte de publicação padrão do site do GitHub Pages, seu site será publicado automaticamente. Você também pode optar por publicar o seu site a partir de um branch ou uma pasta diferente.

People with admin or maintainer permissions for a repository can configure a publishing source for a GitHub Pages site.

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. Para obter mais informações, consulte os "produtos do GitHub".

Para obter mais informações sobre fontes de publicação, consulte "Sobre o GitHub Pages".

Escolher uma fonte de publicação

Antes de configurar uma fonte de publicação, verifique se o branch que você deseja usar como fonte de publicação já existe no repositório.

  1. Em GitHub, acesse o repositório do seu site.

  2. No nome do seu repositório, clique em Configurações. Botão de configurações do repositório

  3. Na barra lateral esquerda, clique em Pages (Páginas). Aba de páginas na barra lateral esquerda

  4. Em "GitHub Pages", use o menu suspenso Nenhum ou Branch e selecione uma fonte de publicação. Menu suspenso para selecionar uma fonte de publicação

  5. Opcionalmente, use o menu suspenso para selecionar uma pasta para sua fonte de publicação. Menu suspenso para selecionar uma pasta para a fonte de publicação

  6. Clique em Salvar. Botão para salvar alterações nas configurações da fonte de publicação

Solucionar problemas de publicação com o site do GitHub Pages

Note: If your site has not published automatically, make sure someone with admin permissions and a verified email address has pushed to the publishing source.

Se você escolher a pasta docs em qualquer branch como fonte de publicação e, em seguida, remover a pasta /docs desse branch do repositório, seu site não vai criar e você receberá uma mensagem de erro de criação de página para uma pasta /docs que está faltando. Para obter informações, consulte Solucionar problemas de erros de criação do Jekyll para sites do GitHub Pages".

O seu sitede GitHub Pages será sempre implantado com a execução de um fluxo de trabalho GitHub Actions, mesmo que você tenha configurado seu site GitHub Pages para ser criado usando uma ferramenta de CI diferente. A maioria dos fluxos de trabalho de CI externos fazem "implantação" no GitHub Pages, fazendo commit da saída da compilação no branch de gh-pages do repositório, e normalmente, incluem um arquivo .nojekyll. Quando isso acontecer, o fluxo de trabalho de GitHub Actions detectará o estado de que o branch não precisa de uma etapa de criação e seguirá as etapas necessárias para implantar o site em servidores de GitHub Pages.

Para encontrar possíveis erros com a compilação ou implantação, você pode verificar a execução do fluxo de trabalho para o seu site de GitHub Pages revisando a execução do fluxo de trabalho do seu repositório. Para obter mais informações, consulte "Visualizar histórico de execução de fluxo de trabalho". Para obter mais informações sobre como executar novamente o fluxo de trabalho em caso de erro, consulte "Executar novamente fluxos de trabalho e trabalhos".

Note: GitHub Actions workflow runs for your GitHub Pages sites are in public beta for public repositories and subject to change. GitHub Actions workflow runs are free for public repositories.

Esse documento ajudou você?

Política de Privacidade

Ajude-nos a tornar esses documentos ótimos!

Todos os documentos do GitHub são de código aberto. Você percebeu que algo que está errado ou não está claro? Envie um pull request.

Faça uma contribuição

Ou, aprenda como contribuir.