Try  HackMD Logo HackMD

hackmd.io/@villares/github-io-comofaz

Como fazer uma página pessoal no GitHub

Início

  • Criar uma conta (escolher um <username>) em github.com
  • Criar um repositório [faltou detalhar esse passo de como cria um repositório] chamado username.github.io
    • imediatamente crie um novo arquivo, por exemplo README.md que vai ser a página de entrada do seu site.
    • Alternativamente você pode querer usar um arquivo index.html.
    • [Opcional avançado] É possível fazer ajustes que usam arquivos de uma pasta docs ou de um branch epecial.
  • Ajustar nas configurações do repositório, na parte "Github Pages", para publicar "ativar" a funcionalidade.

Repositórios viram sub-pastas

Se você criar um repositório, digamos, chamado meu-projeto, e ativar o GitHub Pages nas configurações do repositório, o README.md ou o index.html que você publicar nele aparece em username.github.io/meu-projeto.

Extras - opcionais

Domínio próprio

Avançado - Ajustar layout base HTML

  • Crie arquivo _layouts/default.html com add file > create new file (durante a criação do arquivo, ao digitar a barra diagonal o GitHub entende que deve ser criada a apasta _layouts)

Este exemplo aqui é sem o título que tem no layout padrão:

    <!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <title>CAYTU</title>
    <meta name="viewport" content="width=device-width, initial-scale=1">
   
  </head>
  <body>

    <article> 
    <div class="content">
      {{ content }}
    </div>
  </article>  
    <footer>
      <div class="container">
      </div>
    </footer>
  </body>
</html>
  • Pode acrescenatar assets
    • Pode criar um arquivo CSS
    • Pode subir um Favicon (ícone par o site)
      • acrescentar no default.html <link rel="icon" href="/assets/favicon-32.png" sizes="32x32">