Skip to content

Blog colaborativo sobre tecnologias que envolvam a linguagem Python

Notifications You must be signed in to change notification settings

igr-santos/pythonclub.github.io

 
 

Repository files navigation

Duvidas sobre este projeto, deixe sua mensagem em ![Gitter](https://badges.gitter.im/Join Chat.svg)

Blog colaborativo sobre tecnologias que envolvam a linguagem Python

Como Contribuir

  • Faça um fork desse repositório, clicando no botão Fork, na parte superior direita da pagina do Github

  • Clone seu fork:

    git clone --recursive 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, veja alguns exemplos.

  • Após criar ou editar seu artigo faça um pull-request para que ele seja adicionado ao site.

  • Caso tenha dificuldades para escrever Markdown ou reStructuredText, veja esses editores online que auxiliam sua escrita:

Não entendeu nada? Veja o video que explica o processo de fork, clone, push e pull-request : http://pythonclub.com.br/como-fazer-fork-clone-push-pull-request-no-github.html

Sincronizando seu fork

Caso você já tenha feito fork a algum tempo você tem duas opções para garantir que estará trabalhando com as ultimas alterações, que pode ser simplesmente deletar seu fork e fazer um novo ou sincronizar seu fork com o repositório de origem usando as instruções contidas na wiki

Informações Técnicas

O site pythonclub.com.br está sendo hospedado usando o Github Pages.

O Github Pages hospeda arquivos HTML sem qualquer tipo de custo, bastando que exista um repositório chamado seu-usuario.github.io (Perceba que deve ser incluido o .github.io). Os arquivos HTML devem ser incluidos no branch master para que o Github automaticamente publique aqueles arquivos HTML na web no endereço: http://seu-usuario.github.io

Para gerar os arquivos HTML, e visando a facilidade de escrever textos utilizando a linguagem de marcação Markdown e reStructuredText, utilizamos o Pelican, que é um projeto feito em Python.

Como a branch master é usada internamente pelo Github para servir os arquivos HTML, criamos uma branch chamado 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.

Visualizando sua publicação antes de enviar

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

Para utilizar o script 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

Futuras Publicações

Alguns dos contribuidores criaram o compromisso de publicar alguns artigos.

Foi estabelecido um prazo maximo para a entrega dos artigos com o intuito de que o contribuidor realmente publique o artigo com o conteudo que ele mesmo definiu.

Você pode ver a lista contendo os nomes dos artigos nesta planilha no Google Drive.

Quando tiver um assunto e uma data de entrega, adicione na planinha, ao finalizar o seu artigo, envie o pull request e atualize a planilha marcando que sua publicação já foi entregue.

About

Blog colaborativo sobre tecnologias que envolvam a linguagem Python

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • CSS 54.3%
  • Makefile 15.1%
  • Python 14.4%
  • Shell 13.2%
  • JavaScript 3.0%