wiki

by pythonbrasil

pythonbrasil / wiki

Site python.org.br estático com Pelican

138 Stars 146 Forks Last release: Not found 547 Commits 0 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Site estático python.org.br

Build Status

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.

Páginas do Impressione-se

  1. Empresas - O conteúdo em formato JSON criado através de uma importação do conteúdo encontrado em pyBusinesses-BR. Essa importação é feita quando make html é executado (ver abaixo), pelo arquivo empresas_generator.py e os arquivos são salvos em content/empresas.
  2. Projetos Brasileiros - Conteúdo em formato markdown no arquivo content/pages/projetos.md

Páginas do Inicie-se

  1. Introdução - Conteúdo em formato markdown no arquivo content/pages/introducao.md.

  2. Qual python? - Conteúdo em formato markdown no arquivo content/pages/qual-python.md.

  3. Download do Python - Apenas um link para página de download do Python. Esse link, assim como todos os itens do menu principal, são definidos na arquivo pelicanconf.py na variável NAVBARHOMELINKS.

  4. Instalação Linux - Conteúdo em formato markdown no arquivo content/pages/instalacao-linux.md.

  5. Instalação Mac - Conteúdo em formato markdown no arquivo content/pages/instalacao-mac.md.

  6. Instalação Windows - Conteúdo em formato markdown no arquivo content/pages/instalacao-windows.md.

  7. Ferramentas - Conteúdo em formato markdown no arquivo content/pages/ferramentas.md

Páginas do Aprenda mais

  1. Web - Conteúdo em formato markdown no arquivo content/pages/web.md.

  2. Mobile - Conteúdo em formato markdown no arquivo content/pages/mobile.md.

  3. Games - Conteúdo em formato markdown no arquivo content/pages/games.md.

  4. Científico - Conteúdo em formato markdown no arquivo content/pages/cientifico.md.

  5. Wiki - Apenas um link para o wiki antigo da comunidade Python Brasil.

Páginas do Participe

  1. 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/.

  2. 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.

  3. 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/.

  4. Contribua - Conteúdo em formato markdown no arquivo content/pages/contribua.md.

  5. Tradução - Conteúdo em formato markdown no arquivo content/pages/traducao.md.

Páginas da APyB

  1. Python Brasil - Conteúdo em formato markdown no arquivo content/pages/python-brasil.md.

  2. A APyB - Conteúdo em formato markdown no arquivo content/pages/apyb.md.

  3. 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')

Clone o repositório do projeto para o seu computador e depois navegue para o diretório criado:

$ git clone [email protected]: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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.