2 minuto de leitura

para criar o nosso site vamos seguir o passo a passo de 1

Com HTML

  1. Criar um repositório

    Vá até o GitHub e crie um novo repositório público chamado username.github.io, onde username é seu nome de usuário (ou nome da organização) no GitHub.

    Se a primeira parte do repositório não corresponder exatamente ao seu nome de usuário, não funcionará, portanto, certifique-se de acertar.

  2. Criar um arquivo de index.html

    Vá no repositório criado e clique no botão Criar novo arquivo

  3. Nomeie o arquivo index.html e digite algum conteúdo HTML no editor.

  4. Confirme o arquivo

    Role até o final da página, escreva uma mensagem de confirmação e confirme o novo arquivo.

  5. Configurações do repositório

    Clique na guia Configurações e role para baixo até a seção GitHub Pages.

    Em seguida, selecione a origem do branch principal e clique no botão Salvar.

  6. Pronto!

    Abra um navegador e vá para http://username.github.io/

ver leandro-costa.github.io HTML

Com Markdown

para criar o nosso site vamos seguir o passo a passo de 2

  1. Criando seu site

    repete o passo 1 de Com HTML

  2. No página do seu repositório, clique em Configurações.

  3. Clique Pages.
  4. Clique Escolher um tema.

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

  6. 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.
  7. Ao terminar de editar o arquivo, clique em Aplicar as alterações.
  8. Acesse username.github.io para ver seu novo site.
    • podem ser necessários até 20 minutos para que as alterações no site sejam publicadas após o push delas no GitHub.

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.

Referências

  1. GitHub, Inc. GitHub Pages. Websites for you and your projects. https://pages.github.com/.(Acessado em 28/06/2022) 

  2. GitHub, Inc. GitHub Pages. Início rápido para o GitHub Pages. https://docs.github.com/pt/pages/quickstart.(Acessado em 28/06/2022) 

Atualizado: