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.

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 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. Menu suspenso com a opção de criar um 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. Campo nome do repositório

  3. No nome do seu repositório, clique em Configurações. Botão de configurações do repositório

  4. In the "Code and automation" section of the sidebar, click Pages.

  5. Clique Escolher um tema. Botão Choose a theme (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. Opções de tema e botão Select theme (Selecionar tema)

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