DEV Community 👩‍💻👨‍💻

Fábio Damas
Fábio Damas

Posted on

Configurando uma fonte de publicação para as páginas do GitHub

Você pode configurar Páginas GitHub para publicar arquivos de origem do seu site a partir de master, gh-pagesou uma /docspasta em seu masterramo de páginas do projeto e outros sites Páginas que atendam a determinados critérios.

As páginas do GitHub estão disponíveis em repositórios públicos com o GitHub Free e em repositórios públicos e privados com o GitHub Pro, GitHub Team, GitHub Enterprise Cloud e GitHub Enterprise Server. Para mais informações, consulte " Produtos do GitHub ".

Se o seu site for uma página de usuário ou organização com um repositório nomeado .github.ioou .github.io, você não poderá publicar os arquivos de origem do site em locais diferentes. As páginas de usuário e organização que possuem esse tipo de nome de repositório são publicadas apenas a partir da masterramificação.

Para obter mais informações sobre os diferentes tipos de sites de páginas do GitHub, consulte " Usuário, organização e páginas de projeto ".

Configurações de origem padrão para repositórios sem o esquema de nomeação de nome de usuário

As configurações padrão para publicar os arquivos de origem do site dependem do tipo e das ramificações existentes no repositório do site.

Se o repositório do site não tiver uma ramificação masterou gh-pages, sua fonte de publicação das Páginas do GitHub será definida como None e seu site não será publicado.

configuração sem fonte

Depois de criar um masterou gh-pagesramo, você pode definir um como sua fonte de publicação para que seu site seja publicado.

Se você bifurcar ou carregar o repositório do site apenas com uma ramificação masterou gh-pages, a configuração de origem do seu site será ativada automaticamente para essa ramificação.

Habilitando as páginas do GitHub para publicar seu site masterough-pages

Para selecionar masterou gh-pagescomo sua fonte de publicação, você deve ter a ramificação presente em seu repositório. Se você não tiver um masterou gh-pagesramo, poderá criá-los e retornar às configurações de origem para alterar sua fonte de publicação.

No GitHub, navegue até o repositório do site GitHub Pages.

Sob o nome do seu repositório, clique em Configurações .

Botão de configurações do repositório

Use o menu suspenso Selecionar fonte para selecionar páginas mestras ou gh como sua fonte de publicação de páginas do GitHub.

selecione-gh-páginas-ou-mestre-como-fonte

Clique em Save .

clique em salvar ao lado da seleção de origem

Publicando seu site GitHub Pages a partir de uma /docspasta em sua masterfilial

Para publicar os arquivos de origem do seu site a partir de uma /docspasta em sua masterfilial, você deve ter uma masterfilial e seu repositório:

tem uma /docspasta na raiz do repositório

não siga o esquema de nomenclatura do repositório .github.ioou.github.io

As páginas do GitHub lerão tudo para publicar seu site, incluindo o arquivo CNAME, da /docspasta Por exemplo, quando você edita seu domínio personalizado pelas configurações das Páginas do GitHub, o domínio personalizado é gravado /docs/CNAME.

Dica: se você remover a /docspasta da masterramificação depois de ativada, o site não será criado e você receberá uma mensagem de erro de criação de página para uma /docspasta ausente .

No GitHub, navegue até o repositório do site GitHub Pages.

Crie uma pasta na raiz do seu repositório na masterfilial chamada /docs.

Sob o nome do seu repositório, clique em Configurações .

Botão de configurações do repositório

Use o menu suspenso Selecionar fonte para selecionar a pasta master branch / docs como sua fonte de publicação nas Páginas do GitHub.

selecione-master-branch-docs-folder-as-source

Dica: A configuração de origem da pasta da ramificação principal / documentos não aparecerá como uma opção se a /docspasta não existir na masterramificação.

Clique em Save .

clique em salvar próximo à master-branch-docs-folder-source-selection

Top comments (0)

We are hiring! Do you want to be our Senior Platform Engineer? Are you capable of chipping in across sysadmin, ops, and site reliability work, while supporting the open source stack that runs DEV and other communities?

This role might just be for you!

Apply now