Como publicar uma página do Github

As páginas do Github permitem que os desenvolvedores hospedem um site estático de seu projeto gratuitamente. É uma das principais instalações do Github que tornou a manutenção de projetos livres de código aberto mais econômicos, especialmente para desenvolvedores independentes.

Bootstrap e Normalize.css são algumas páginas populares do Github. Para criar um, você só precisa criar um novo ramo do seu repositório de projetos, e chamá-lo páginas de gh. Publicar o ramo no Github.

Quando estiver pronto, o site pode ser acessado por meio do URL definido em relação ao nome de usuário do Github e ao nome do repositório. username .github.io / repository-name.

Você pode configurar um domínio personalizado para a sua página do Github. Nós mostramos como fazer isso em nosso tutorial anterior.

Páginas do Github simplificadas

Criar uma Página do Github é fácil e rápido. Mas há uma pequena ressalva.

Pegue um dos repositórios de demonstração em nossa conta do Github, Calendário do Advento, por exemplo. Nós temos dois ramos - mestre e páginas de gh que compartilham exatamente o mesmo dos ramos de código.

Precisamos ter certeza de que os códigos em páginas de gh estão sempre sincronizados com o mestre ramo.

Felizmente, o Github recentemente tornou mais simples, removendo páginas de gh requisito de ramificação. Podemos agora alimentar o site diretamente através do mestre ramo.

Para fazer isso, vá para qualquer tela do seu repositório do Github. Role para baixo até a seção Páginas do Github e selecione o ramo mestre menu da seleção.

Está tudo pronto e pode remover com segurança o páginas de gh ramificação do repositório.

Servindo Documentação

Alguns projetos, como Bootstrap, Foundation ou Skeleton, requerem uma página de documentação. E seus desenvolvedores geralmente também servem essas páginas de documentação através do páginas de gh documento.

Portanto, o repositório agora tem dois ramos com um conjunto de códigos e propósitos completamente diferentes; um é o principal fonte, enquanto o outro documentações de host e também alguns trechos de código. Nesta situação, você pode encontrar conflitos de mudança ao alternar entre essas duas ramificações..

Com essa nova mudança do Github, os desenvolvedores agora podem servir páginas de documentação por meio de um nome de pasta / docs / dentro do mestre ramo. Então, vá para as páginas do Github e selecione a próxima opção, pasta master branch / docs.

Agora, manter o código-fonte e a documentação tornou-se mais estratificado.