diff --git a/tutorial-gitpages.md b/tutorial-gitpages.md new file mode 100644 index 0000000..d6f4f87 --- /dev/null +++ b/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!