Início Rápido para Páginas do GitHub

Você pode usar GitHub Pages para mostrar alguns projetos open source, hospedar um blog ou até mesmo compartilhar seu currículo. Este guia ajudará você a começar a criar o seu próximo site.

Quem pode usar esse recurso?

O GitHub Pages está disponível em repositórios públicos com o GitHub Free e o GitHub Free para organizações, e em repositórios públicos e privados com o GitHub Pro, o GitHub Team, o GitHub Enterprise Cloud e o GitHub Enterprise Server. Para saber mais, confira Planos do GitHub.

Neste artigo

Introdução

Neste guia, você criará um site de usuário em <username>.github.io.

Criando seu site

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

           ![Captura de tela das configurações do GitHub Pages em um repositório. O campo do nome do repositório contém o texto "octocat.github.io" e está contornado em laranja escuro.](/assets/images/help/pages/create-repository-name-pages.png)

  2. Escolha uma visibilidade do repositório. Para saber mais, confira Sobre repositórios.

  3. Alternar Adicionar LEIAME para Ativado.

  4. Clique em Criar repositório.

  5. No nome do repositório, clique em Settings. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , 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.

  6. Na seção "Code and automation" da barra lateral, clique em Pages.

  7. Em "Build e implantação", em "Fonte", selecione Implantar a partir de um branch.

  8. Em "Build e implantação", na seção "Branch", use o menu suspenso e selecione uma fonte de publicação.

           ![Captura de tela das configurações do Pages em um repositório do GitHub. Existe um menu para selecionar um branch para uma fonte de publicação, com a etiqueta "Nenhum", destacado em laranja escuro.](/assets/images/help/pages/publishing-source-drop-down.png)

  9. Opcionalmente, abra o arquivo README.md do seu repositório. O arquivo README.md é o local em que você escreverá o conteúdo do site. Você pode editar o arquivo ou manter o conteúdo padrão por enquanto.

  10. Acesse username.github.io para ver seu novo site. Observe que poderá levar até 10 minutos para que as alterações no seu site sejam publicadas depois que você efetuar push das alterações no GitHub.

Alterando o título e a descrição

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

  1. Clique na guia Código do 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 do site. Adicione uma nova linha com title: seguida do título desejado. Adicione uma nova linha com description: seguida da descrição desejada. Por exemplo:

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

  5. Quando finalizar a edição do arquivo, clique em Confirmar alterações.

Próximas etapas

Você criou, personalizou e publicou seu primeiro site do GitHub Pages com sucesso, mas há muito mais para explorar! Confira alguns recursos úteis para dar seus próximos passos com o GitHub Pages:

  •         [AUTOTITLE](/pages/setting-up-a-github-pages-site-with-jekyll/adding-content-to-your-github-pages-site-using-jekyll#about-content-in-jekyll-sites): este guia explica como adicionar páginas ao seu site.
  • Configurando um domínio personalizado para seu site GitHub Pages: é possível hospedar seu site no domínio github.io do GitHub ou em um domínio personalizado próprio.