Início rápido para o GitHub Pages

Introdução

GitHub Pages são sites públicos hospedados e publicados por meio de GitHub Enterprise Server. A maneira mais rápida de colocar em funcionamento é usar o seletor de temas Jekyll para carregar um tema pré-criado. Em seguida, você pode modificar o seu estilo e conteúdo de GitHub Pages.

Este guia irá orientar você com relação �  criação de um site em username.github.io.

Criando seu site

1. No canto superior direito de qualquer página, use o menu suspenso e selecione Novo repositório.

2. Digite username.github.io como nome do repositório. Substitua nome de usuário pelo seu nome de usuário de GitHub. Por exemplo, se seu nome de usuário for octocat, o nome do repositório deverá ser octocat.github.io.

3. No nome do seu repositório, clique em Configurações.

4. Na barra lateral esquerda, clique em Pages (Páginas).

5. Clique Escolher um tema.

6. O seletor de temas será aberto. Pesquise os temas disponíveis e, em seguida, clique em Selecionar tema para selecionar um tema. É fácil mudar seu tema mais tarde. Portanto, se você não tiver certeza, basta escolher um por enquanto.

7. Depois de selecionar um tema, o arquivo README.md do repositório será aberto no editor do arquivo. O arquivo README.md é onde você escreverá o conteúdo do seu site. Você pode editar o arquivo ou manter o conteúdo padrão por enquanto.

8. Ao terminar de editar o arquivo, clique em Aplicar as alterações.

9. Acesse username.github.io para ver seu novo site. Observação: podem ser necessários até 20 minutos para que as alterações no site sejam publicadas após o push delas no GitHub Enterprise Server.

Alterando o título e a descrição

Por padrão, o título do seu site é username.github.io. Você pode alterar o título editando o arquivo _config.yml no seu repositório. Você também pode adicionar uma descrição para o seu site.

1. Clique na aba Código do seu repositório.

2. Na lista de arquivos, clique em _config.yml para abrir o arquivo.

3. Clique em para editar o arquivo.

4. O arquivo _config.yml já contém uma linha que especifica o tema para o seu site. Adicione uma nova linha com title: seguido do título que você deseja. Adicione uma nova linha com description: seguida da descrição que você deseja. Por exemplo:

   theme: jekyll-theme-minimal
   title: Octocat's homepage
   description: Bookmark this to keep an eye on my project updates!
   

5. Ao terminar de editar o arquivo, clique em Aplicar as alterações.

Próximos passos

Para obter mais informações sobre como adicionar páginas adicionais ao seu site, consulte "Adicionando conteúdo ao site do GitHub Pages usando o Jekyll".

Para obter mais informações sobre como configurar um site do GitHub Pages com o Jekyll, consulte "Sobre o GitHub Pages e o Jekyll".