Python Brasil-Contribua com este site
Impressione-se Empresas
Inicie-se Qual Python?
Aprenda mais Introdução
Participe Lista de Discussões
Contribua Este Site
Pensando na possibilidade de mantermos um site para a comunidade de maneira mais colaborativa onde qualquer um possa contribuir com conteúdo de maneira rápida, surgiu a idéia de utilizarmos o GitHub Pages.
Site Live: http://pythonbrasil.github.io/wiki
Repo: https://github.com/pythonbrasil/wiki
Este projeto utiliza Pelican como gerador de páginas estáticas e Travis-CI para realizar a integração contínua.
Basta ter uma conta no GitHub.
Consigo editar via web.
O site não tem senha, mas é automaticamente versionado.
Por que não usar um framework web?
Porque a tecnologia não pode estar entre o voluntário que deseja colaborar e a publicação do conteúdo.
Mas somos todos programadores...
Mas mesmo entre os dev temos conhecimentos distintos, muitos da comunidade não tem interesse em programação web.
Independente de ser ou não programador, ou conhecer ou não python, podemos tentar criar um site em que qualquer um com o mínimo de boa vontade consiga contribuir.
O mínimo de boa vontade é ter uma conta no GitHub
Veja como está organizado o conteúdo e como contribuir:
Páginas do Impressione-se
Empresas: Listagem das empresas que usam python
O Conteúdo está em formato estruturado JSON. Para adicionar uma nova empresa basta criar um arquivo com extensão .json na pasta content/empresas/ seguindo o padrão dos demais arquivos desta pasta e caso queira adicionar o logo da empresa basta colocar o arquivo de extensão .png na pasta content/images/empresas/.
Páginas do Inicie-se
Conteúdo em formato markdown no arquivo content/pages/instalacao.md.
Conteúdo em formato markdown no arquivo content/pages/ferramentas.md
Páginas do Aprenda mais
Conteúdo em formato markdown no arquivo content/pages/introducao.md.
Conteúdo em formato markdown no arquivo content/pages/web.md.
Conteúdo em formato markdown no arquivo content/pages/mobile.md.
Conteúdo em formato markdown no arquivo content/pages/games.md.
Conteúdo em formato markdown no arquivo content/pages/cientifico.md.
Páginas do Participe
O Conteúdo está em formato estruturado JSON. Para adicionar uma nova comunidade basta criar um arquivo com extensão .json na pasta content/comunidades-locais/ seguindo o padrão dos demais arquivos desta pasta e caso queira adicionar o logo da comunidade basta colocar o arquivo de extensão .png de tamanho 400X400 na pasta content/images/comunidades-locais/.
O Conteúdo das pyladies é uma importação do conteúdo encontrado em https://github.com/pyladies-brazil/br-pyladies-pelican/blob/master/data/ladies.yml.
O Conteúdo está em formato estruturado JSON. Para adicionar um novo evento basta criar um arquivo com extensão .json na pasta content/eventos/YYYY/.
Conteúdo em formato markdown no arquivo content/pages/python-brasil.md.
Conteúdo em formato markdown no arquivo content/pages/apyb.md.
Páginas do Contribua
Conteúdo em formato markdown no arquivo content/pages/este-site.md.
Conteúdo em formato markdown no arquivo content/pages/traducao.md.
Mas se você for programador e tem conhecimentos mínimos de Python, saiba como rodar o projeto em sua máquina e colaborar conosco:
Se não sabe o que é o virtualenv e/ou pra que serve, sugiro que leia a página do projeto.
Crie um virtualenv com o nome que desejar, acesse a pasta e ative o virtualenv (Considerando os comandos em sistemas Linux e OS X):
virtualenv project-name
Provavelmente irá aparecer em seu terminal algo como (project-name)$, agora vamos clonar o repositório do projeto:
git clone https://github.com/pythonbrasil/wiki.git
Pronto! Você já está na pasta do projeto! Agora vamos instalar os programas necessários (Certifique-se que o virtualenv está ativado):
Podem ocorrer problemas variados na instalação dos programas, se isso acontecer tente instalar as depêndencias do sistema operacional. No Ubuntu você pode usar o seguinte comando:
No Mac OS X Yosemite, use o seguinte comando para instalar ferramentas e utilitários como (libtool, lxml, cpp, etc...)que já é default em distros Linux:
x-code-select --install
Se der erro de locale, tente comando abaixo, o ideal é colocar no ~/.bash_profile
Ou verifique pelo Stackoverflow e pelo Google quais as soluções possíveis. Se o problema persistir, nos informe nas issues.
Legal, agora já instalei todos os programas, vamos fazê-lo rodar em nosso computador?
O make html irá gerar o HTML e o make serve irá criar o servidor. Basta acessar localhost:8000 e pronto! O site já está rodando em seu computador localmente!
Agora basta fazer as modificações na pasta content/pages, rodar os comandos make html e make serve e suas alterações já serão visíveis.
Resta então fazer o commit de suas alterações em seu repositório local e enviar-nos o Pull Request! o/
Mais informações sobre como funciona o Pelican, indicamos o artigo - http://mindbending.org/pt/instalando-o-pelican.