Blog colaborativo sobre tecnologias que envolvam a linguagem Python

• Faça um fork desse repositório
• Clone seu fork git clone https://github.com/SEU_USUARIO_DO_GITHUB/pythonclub.github.io.git
• Instale os requirements pip install -r requirements.txt
• Todas as publicações ficam na pasta content, os textos podem ser escritos no formato Markdown ou reStructuredText, fique a vontade para usar o que você sentir mais afinidade.
• Após criar ou editar seu artigo faça um pull-request para que ele seja adicionado ao site.

O site está sendo hospedado usando o Github Pages que hospeda arquivos HTML sem qualquer tipo de custo, bastando para isso que exista um repositório chamado seu-usuario.github.io o que faz com que qualquer arquivo HTML existente na branch master seja servido numa web, para gerar esses arquivos HTML usamos o Pelican que é um projeto feito em Python.

Como a branch master é usada internamente pelo Github para servir os arquivos HTML criamos uma branch chamada pelican para armazenar os arquivos de configuração e as publicação em seu "estado-bruto", essa branch está definida como padrão para o repositório e você possivelmente não precisará se preocupar com isso.

O Pelican conta com algumas facilidades que permitem que você teste o site localmente na medida que você vai escrevendo o texto antes de enviar para o servidor, inclusive vem com um script para facilitar isso, para iniciar basta executar o comando:

./develop_server.sh start

Então basta visitar o endereço http://localhost:8000/

Para finalizar o servidor use:

./develop_server.sh stop