Site Live: http://python.org.br/
Repositório: https://github.com/pythonbrasil/wiki
Para contribuír com a melhoria do conteúdo deste site basta acessar alguma das páginas mapeadas abaixo, editar seu conteúdo e submeter sua alteração como um pull request.
Introdução - Conteúdo em formato markdown no arquivo content/pages/introducao.md.
Qual python? - Conteúdo em formato markdown no arquivo content/pages/qual-python.md.
Download do Python - Apenas um link para [página de download do Python] (https://www.python.org/downloads/). Esse link, assim como todos os itens do menu principal, são definidos na arquivo pelicanconf.py na variável NAVBAR_HOME_LINKS.
Instalação Linux - Conteúdo em formato markdown no arquivo content/pages/instalacao-linux.md.
Instalação Mac - Conteúdo em formato markdown no arquivo content/pages/instalacao-mac.md.
Instalação Windows - Conteúdo em formato markdown no arquivo content/pages/instalacao-windows.md.
Ferramentas - Conteúdo em formato markdown no arquivo content/pages/ferramentas.md
Web - Conteúdo em formato markdown no arquivo content/pages/web.md.
Mobile - Conteúdo em formato markdown no arquivo content/pages/mobile.md.
Games - Conteúdo em formato markdown no arquivo content/pages/games.md.
Científico - Conteúdo em formato markdown no arquivo content/pages/cientifico.md.
Wiki - Apenas um link para o wiki antigo da comunidade Python Brasil.
Comunidades Locais - 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/.
Pyladies - 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.
Eventos - 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/.
Contribua - Conteúdo em formato markdown no arquivo content/pages/contribua.md.
Tradução - Conteúdo em formato markdown no arquivo content/pages/traducao.md.
Python Brasil - Conteúdo em formato markdown no arquivo content/pages/python-brasil.md.
A APyB - Conteúdo em formato markdown no arquivo content/pages/apyb.md.
Premio Dorneles Tremea - Conteúdo em formato markdown no arquivo content/pages/premio-dorneles-tremea.md.
(ao contribuir com o Repositório utilizar a branch 'pelican')
Clone o repositório do projeto para o seu computador e depois navegue para o diretório criado:
$ git clone git@github.com:pythonbrasil/wiki.git
$ cd wiki
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 -p python3 .venv
$ source .venv/bin/activate
Provavelmente irá aparecer em seu terminal algo como (.venv)$:
Pronto! Você já está na pasta do projeto e com o virtualenv ativado! Certifique-se disso. Agora vamos instalar os programas necessários:
$ pip install -r requirements.txt
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:
$ sudo ./install_os_dependencies.sh install
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
$ export LC_ALL=en_US.UTF-8
$ export LANG=en_US.UTF-8
Se der erro de pycripto instale:
$ sudo apt install python3-dev
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?
$ make html
$ make serve
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.
Caso queira contribuir com o tema é preciso ter o node instalado em sua máquina. Sua instalação é bem direta e pode ser obtida em:
https://nodejs.org/en/download/
Após a instalação do node você pode instalar as dependências do tema indo a seu diretório e rodando o npm:
$ cd themes/pybr
$ npm install
Com as dependências instaladas para rodar a montagem do css com live reload basta rodar:
$ npm run gulp
E caso queira rodar sem o live reload, somente para gerar o css para publicação rode:
$ npm run gulp build