#28 Criar documentação sobre gitpages

tutorial-gitpages.md

@@ -0,0 +1,35 @@
+# Como Funciona o GitHub Pages e Ferramentas para Criar sua Página
+
+O GitHub Pages é um serviço gratuito fornecido pelo GitHub que permite hospedar sites estáticos diretamente de um repositório GitHub. Isso torna incrivelmente fácil criar uma presença na web para projetos pessoais, portfólios, documentação e muito mais. Neste artigo, exploraremos como o GitHub Pages funciona e apresentaremos algumas ferramentas populares que você pode usar para criar sua própria página no GitHub.
+
+## Como o GitHub Pages Funciona
+
+O GitHub Pages utiliza um repositório GitHub como fonte de conteúdo para criar um site estático. Aqui está uma visão geral de como isso funciona:
+
+1. **Crie um Repositório**: Você começa criando um repositório no GitHub que conterá o código-fonte do seu site. O nome do repositório deve seguir o padrão `seuusername.github.io` para que o GitHub o reconheça como um repositório de GitHub Pages.
+
+2. **Adicione Seu Conteúdo**: Dentro do repositório, você pode adicionar arquivos HTML, CSS, JavaScript e, o mais comum, arquivos Markdown para criar o conteúdo do seu site.
+
+3. **Escolha uma Ferramenta de Construção**: Para facilitar a criação e a formatação de conteúdo, você pode escolher uma das muitas ferramentas disponíveis. Abaixo, listamos algumas delas:
+
+   - [MkDocs](https://www.mkdocs.org/): Um gerador de sites estáticos específico para documentação que usa Markdown e possui vários temas disponíveis.
+
+   - [Docsify](https://docsify.js.org/): Uma biblioteca JavaScript que transforma seus arquivos Markdown em uma documentação interativa e atraente.
+
+   - [Docusaurus](https://docusaurus.io/): Desenvolvido pelo Facebook, é ótimo para criar documentação de código aberto com temas personalizáveis.
+
+   - [VuePress](https://vuepress.vuejs.org/): Permite criar documentação usando Markdown e oferece pesquisa integrada e temas personalizáveis.
+
+4. **Configure o GitHub Pages**: Vá até as configurações do seu repositório no GitHub e ative o GitHub Pages, escolhendo o branch que contém o código-fonte do seu site.
+
+5. **Publique Seu Site**: Após ativar o GitHub Pages, o GitHub cuidará da construção e hospedagem do seu site. O endereço do seu site será `https://seuusername.github.io`.
+
+6. **Personalize e Mantenha**: Personalize o seu site de acordo com suas preferências, atualize o conteúdo conforme necessário e acompanhe o progresso do seu projeto.
+
+O GitHub Pages é uma maneira poderosa e gratuita de compartilhar seu trabalho com o mundo. Com a escolha da ferramenta certa, você pode criar uma experiência de usuário incrível para seus visitantes.
+
+## Conclusão
+
+Se você está procurando uma maneira rápida e eficaz de criar um site estático e hospedá-lo gratuitamente, o GitHub Pages é uma excelente opção. Além disso, ferramentas como MkDocs, Docsify, Docusaurus, VuePress e muitas outras tornam a criação de conteúdo agradável e personalizável.
+
+Agora que você entende como o GitHub Pages funciona e conhece algumas ferramentas populares, está pronto para começar a criar sua gitpage!