Site estático 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.

Páginas do Impressione-se

Empresas - O Conteúdo das empresas é uma importação do conteúdo encontrado em https://github.com/pythonbrasil/pyBusinesses-BR.

Páginas do Inicie-se

Qual python? - Conteúdo em formato markdown no arquivo content/pages/qual-python.md.
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.
Introdução - Conteúdo em formato markdown no arquivo content/pages/introducao.md.
Ferramentas - Conteúdo em formato markdown no arquivo content/pages/ferramentas.md

Páginas do Aprenda mais

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.

Páginas do Participe

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.

Páginas da APyB

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.

Para contribuir com desenvolvimento

(ao contribuir com o Repositório utilizar a branch 'pelican')

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

$ cd project-name

$ source bin/activate

Provavelmente irá aparecer em seu terminal algo como (project-name)$, agora vamos clonar o repositório do projeto:

$ git clone git@github.com:pythonbrasil/wiki.git

$ cd wiki

Pronto! Você já está na pasta do projeto! Agora vamos instalar os programas necessários (Certifique-se que o virtualenv está ativado):

$ 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