## `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 - Se você tem o seu próprio domínio, como por exemlo meunome.com ou meunome.com.br você pode ajustar. ### 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: ```html <!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">