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.

Início rápido para o GitHub Pages

Você pode usar GitHub Pages para exibir alguns projetos de código aberto, hospedar um blogue ou até mesmo compartilhar seu currículo. Este guia ajudará você a começar a criar o seu próximo 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. Para obter mais informações, confira "produtos de GitHub".

Introdução

GitHub Pages são sites públicos hospedados e publicados por meio de GitHub Enterprise Cloud. 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 descreverá a criação de um site de usuário 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. Menu suspenso com a opção para criação de um repositório

  2. 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. Campo de nome do repositório 1. Abaixo do nome do repositório, clique em Configurações. Botão Configurações do repositório

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

  4. Em "Build e implantação", em "Fonte", selecione Fazer implantação de um branch.

  5. Em "Build e implantação", em "Branch", use o menu suspenso Nenhum ou Branch e selecione uma fonte de publicação.

    Menu suspenso usado para selecionar uma fonte de publicação

  6. 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.

  7. Acesse username.github.io para ver seu novo site. Observação: poderá levar até dez minutos para que as alterações no seu site sejam publicadas depois que você efetuar push das alterações para o GitHub Enterprise Cloud.

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 terminar de editar o arquivo, clique em Fazer commit das alterações.

Próximas etapas

Para obter mais informações sobre como adicionar mais páginas ao seu site, confira "Como adicionar 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, confira "Sobre o GitHub Pages e o Jekyll".