Skip to main content

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.

O GitHub Pages está disponível em repositórios internos e privados com o GitHub AE. 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.

Introdução

GitHub Pages são sites públicos hospedados e publicados por meio de GitHub AE. 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. In the left sidebar, click Pages. Page tab in the left-hand sidebar

  4. Clique em Escolher um tema. Botão Escolher um tema

  5. O seletor de temas será aberto. Navegue pelos temas disponíveis e clique em Selecionar tema para escolher um tema. É fácil mudar seu tema mais tarde. Portanto, se você não tiver certeza, basta escolher um por enquanto. Opções de tema e botão Selecionar tema

  6. Depois que você selecionar um tema, o arquivo README.md do repositório será aberto no editor de arquivos. 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. Quando terminar de editar o arquivo, clique em Fazer commit das alterações.

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

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