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.
- Empresas - O Conteúdo das empresas é uma importação do conteúdo encontrado em https://github.com/pythonbrasil/pyBusinesses-BR.
-
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
-
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.
-
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.
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
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:
$ gulp
E caso queira rodar sem o live reload, somente para gerar o css para publicação rode:
$ gulp build