Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

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

Se você usar a fonte de publicação padrão para seu 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.

Quem pode usar esse recurso

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.

Sobre as fontes de publicação

Seu site do GitHub Pages fará publicações sempre que as alterações forem enviadas por push para um branch específico. Você pode especificar qual branch e pasta usar como fonte de publicação. O branch de origem pode ser qualquer branch em seu repositório, e a pasta de origem pode ser a raiz do repositório (/) no branch de origem ou uma pasta /docs no branch de origem. Sempre que as alterações forem enviadas por push para o branch de origem, as alterações na pasta de origem serão publicadas em seu site do GitHub Pages.

Aviso: se o administrador do site tiver habilitado Páginas Públicas, sites GitHub Pages estarão disponíveis publicamente na Internet, mesmo que o repositório do site seja privado ou interno. Se você tiver dados confidenciais no repositório do seu site, poderá removê-los antes de publicá-los. Para obter mais informações, confira "Configurar o GitHub Pages para a sua empresa" e "Sobre repositórios."

Fazer publicação de um branch

  1. Verifique se o branch que você deseja usar como fonte de publicação já existe no repositório.

  2. Em GitHub Enterprise Server, acesse o repositório do seu site. 1. Abaixo do nome do repositório, clique em Configurações. Caso não consiga ver a guia suspensa "Configurações", selecione o menu suspenso e clique em Configurações.

    Captura de tela de um cabeçalho de repositório que mostra as guias. A guia "Configurações" é realçada por um contorno laranja escuro.

  3. Na seção "Código e automação" da barra lateral, clique em Pages.

  4. Em "GitHub Pages", use o menu suspenso de branch e selecione uma fonte de publicação. Captura de tela das configurações do Pages em um repositório do GitHub. Há um menu "Nenhum" a fim de selecionar um branch para uma fonte de publicação com o contorno em laranja escuro.

  5. Opcionalmente, use o menu suspenso de pasta a fim de selecionar uma pasta para a fonte de publicação. Captura de tela das configurações do Pages em um repositório do GitHub. Há um menu "/(raiz)" a fim de selecionar uma pasta para uma fonte de publicação com o contorno em laranja escuro.

  6. Clique em Save (Salvar).

Solução de problemas de publicação de um branch

Observação: If seu site não tiver sido publicado automaticamente, verifique se alguém com permissões de administrador e um endereço de email verificado efetuou push para a fonte de publicação.

Se você escolher a pasta docs em qualquer branch como a origem de publicação e, depois, remover a pasta /docs desse branch no repositório, seu site não será compilado e você receberá uma mensagem de erro de build de página para uma pasta /docs ausente. Para obter mais informações, confira "Solucionar problemas de erros de criação do Jekyll para sites do GitHub Pages".