Criando páginas HTML para projetos github, ou como usar o github para hospedar projetos em HTML

Depois de um crash-course com o Vitinho, estou usando intensamente o github com os meus projetos. Alguns deles, como a tradução da documentação do jQuery Mobile para português brasileiro, o metro-rio-xml-json, que oferece dados em formato de máquina sobre o Metrô Rio, e especialmente o Metrô Rio Mobile, um webapp sobre o Metrô Rio, são em HTML puro (e CSS e também JavaScript, mas sem nenhuma linguagem de renderização server-side) e, portanto, seria interessante ter alguma forma de disponibilizar o conteúdo para acesso direto, sem exigir que as pessoas façam check-out para visualizar o conteúdo.

Pois bem, o github oferece a possibilidade de publicar um branch especial do projeto chamado gh-pages em http://usuario.github.com/projeto (note que é diferente do endereço normal do projeto, que seria http://github.com/usuario/projeto). Você pode utilizar isso também para criar uma página HTML para o seu projeto no github.

Para isso, basta:
cd /pasta/do/projeto
git symbolic-ref HEAD refs/heads/gh-pages
rm .git/index
git clean -fdx
echo "Minha página no GitHub" > index.html
git add .
git commit -a -m "Primeiro commit de página no github"
git push origin gh-pages

Nota: isto remove os arquivos do projeto, ou seja, você perderá quaisquer modificações não commitadas. Note que você pode criar uma nova pasta para o projeto (seguindo os passos de configuração de um novo repositório git) e já começar a utilizar direto o branch gh-pages. Veja mais detalhes sobre a criação de páginas em repositórios github em GitHub Pages.

This entry was posted in Tecnologia and tagged , . Bookmark the permalink.

Deixe um Comentário

O seu endereço de email não será publicado Campos obrigatórios são marcados *

*

Você pode usar estas tags e atributos de HTML: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <strike> <strong> <pre lang="" line="" escaped="" highlight="">