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