Redirecionando para o formulário de denúncia do Código de Conduta Python Brasil 2022.
+ + diff --git a/content/images/apyb/fundadores-apyb.jpg b/content/images/apyb/fundadores-apyb.jpg deleted file mode 100644 index 31963be7..00000000 Binary files a/content/images/apyb/fundadores-apyb.jpg and /dev/null differ diff --git a/content/images/comunidades-locais/default.png b/content/images/comunidades-locais/default.png index ae5f8e5b..ecf18ae4 100644 Binary files a/content/images/comunidades-locais/default.png and b/content/images/comunidades-locais/default.png differ diff --git a/content/images/comunidades-locais/grupy-abc.png b/content/images/comunidades-locais/grupy-abc.png new file mode 100644 index 00000000..cb67566a Binary files /dev/null and b/content/images/comunidades-locais/grupy-abc.png differ diff --git a/content/images/comunidades-locais/grupy-pa.png b/content/images/comunidades-locais/grupy-pa.png new file mode 100644 index 00000000..d402bd32 Binary files /dev/null and b/content/images/comunidades-locais/grupy-pa.png differ diff --git a/content/images/comunidades-locais/grupy-sanca.png b/content/images/comunidades-locais/grupy-sanca.png new file mode 100644 index 00000000..21a23442 Binary files /dev/null and b/content/images/comunidades-locais/grupy-sanca.png differ diff --git a/content/images/comunidades-locais/pug-ce.png b/content/images/comunidades-locais/pug-ce.png deleted file mode 100644 index 34145a8c..00000000 Binary files a/content/images/comunidades-locais/pug-ce.png and /dev/null differ diff --git a/content/images/comunidades-locais/pug-pe.png b/content/images/comunidades-locais/pug-pe.png index d16c0643..ea19a536 100644 Binary files a/content/images/comunidades-locais/pug-pe.png and b/content/images/comunidades-locais/pug-pe.png differ diff --git a/content/images/comunidades-locais/pug-se.png b/content/images/comunidades-locais/pug-se.png deleted file mode 100644 index a6699518..00000000 Binary files a/content/images/comunidades-locais/pug-se.png and /dev/null differ diff --git a/content/images/comunidades-locais/pytche.png b/content/images/comunidades-locais/pytche.png deleted file mode 100644 index 60e18b77..00000000 Binary files a/content/images/comunidades-locais/pytche.png and /dev/null differ diff --git a/content/images/comunidades-locais/python-goias.png b/content/images/comunidades-locais/python-goias.png deleted file mode 100644 index beed5828..00000000 Binary files a/content/images/comunidades-locais/python-goias.png and /dev/null differ diff --git a/content/images/comunidades-locais/pythonrio.png b/content/images/comunidades-locais/pythonrio.png deleted file mode 100644 index 05071e8e..00000000 Binary files a/content/images/comunidades-locais/pythonrio.png and /dev/null differ diff --git a/content/images/empresas/2xt.png b/content/images/empresas/2xt.png deleted file mode 100644 index 485a9fe3..00000000 Binary files a/content/images/empresas/2xt.png and /dev/null differ diff --git a/content/images/empresas/configr.svg b/content/images/empresas/configr.svg deleted file mode 100644 index fd9cf375..00000000 --- a/content/images/empresas/configr.svg +++ /dev/null @@ -1 +0,0 @@ - \ No newline at end of file diff --git a/content/images/empresas/default.png b/content/images/empresas/default.png deleted file mode 100644 index ef12690a..00000000 Binary files a/content/images/empresas/default.png and /dev/null differ diff --git a/content/images/empresas/deway.png b/content/images/empresas/deway.png deleted file mode 100644 index ebb149c0..00000000 Binary files a/content/images/empresas/deway.png and /dev/null differ diff --git a/content/images/empresas/echoflow-engineering.png b/content/images/empresas/echoflow-engineering.png deleted file mode 100644 index 91b02442..00000000 Binary files a/content/images/empresas/echoflow-engineering.png and /dev/null differ diff --git a/content/images/empresas/ello-tecnologia.png b/content/images/empresas/ello-tecnologia.png deleted file mode 100644 index 6ae23730..00000000 Binary files a/content/images/empresas/ello-tecnologia.png and /dev/null differ diff --git a/content/images/empresas/evolux.png b/content/images/empresas/evolux.png deleted file mode 100644 index d1952aff..00000000 Binary files a/content/images/empresas/evolux.png and /dev/null differ diff --git a/content/images/empresas/filmow.jpg b/content/images/empresas/filmow.jpg deleted file mode 100644 index 98d23487..00000000 Binary files a/content/images/empresas/filmow.jpg and /dev/null differ diff --git a/content/images/empresas/fpf-tech.png b/content/images/empresas/fpf-tech.png deleted file mode 100644 index 0bfd3cdc..00000000 Binary files a/content/images/empresas/fpf-tech.png and /dev/null differ diff --git a/content/images/empresas/funceme.png b/content/images/empresas/funceme.png deleted file mode 100644 index ab851fa1..00000000 Binary files a/content/images/empresas/funceme.png and /dev/null differ diff --git a/content/images/empresas/genomika.png b/content/images/empresas/genomika.png deleted file mode 100644 index fc3f3620..00000000 Binary files a/content/images/empresas/genomika.png and /dev/null differ diff --git a/content/images/empresas/globocom.svg b/content/images/empresas/globocom.svg deleted file mode 100644 index 70266385..00000000 --- a/content/images/empresas/globocom.svg +++ /dev/null @@ -1,15 +0,0 @@ - - \ No newline at end of file diff --git a/content/images/empresas/grupocitec.png b/content/images/empresas/grupocitec.png deleted file mode 100644 index 7b3b026e..00000000 Binary files a/content/images/empresas/grupocitec.png and /dev/null differ diff --git a/content/images/empresas/hexgis.png b/content/images/empresas/hexgis.png deleted file mode 100644 index f468dbeb..00000000 Binary files a/content/images/empresas/hexgis.png and /dev/null differ diff --git a/content/images/empresas/ifrn.png b/content/images/empresas/ifrn.png deleted file mode 100644 index fc7ca2d7..00000000 Binary files a/content/images/empresas/ifrn.png and /dev/null differ diff --git a/content/images/empresas/intip.png b/content/images/empresas/intip.png deleted file mode 100644 index af3a2c80..00000000 Binary files a/content/images/empresas/intip.png and /dev/null differ diff --git a/content/images/empresas/jusbrasil.png b/content/images/empresas/jusbrasil.png deleted file mode 100644 index 74dc9213..00000000 Binary files a/content/images/empresas/jusbrasil.png and /dev/null differ diff --git a/content/images/empresas/labcodes.png b/content/images/empresas/labcodes.png deleted file mode 100644 index 77c01550..00000000 Binary files a/content/images/empresas/labcodes.png and /dev/null differ diff --git a/content/images/empresas/liberiun.png b/content/images/empresas/liberiun.png deleted file mode 100644 index c5f1049c..00000000 Binary files a/content/images/empresas/liberiun.png and /dev/null differ diff --git a/content/images/empresas/maqhin.png b/content/images/empresas/maqhin.png deleted file mode 100644 index 345c2fc5..00000000 Binary files a/content/images/empresas/maqhin.png and /dev/null differ diff --git a/content/images/empresas/meliuz.png b/content/images/empresas/meliuz.png deleted file mode 100644 index 9ce08a4f..00000000 Binary files a/content/images/empresas/meliuz.png and /dev/null differ diff --git a/content/images/empresas/morphus.png b/content/images/empresas/morphus.png deleted file mode 100644 index eb3b975e..00000000 Binary files a/content/images/empresas/morphus.png and /dev/null differ diff --git a/content/images/empresas/olist.jpg b/content/images/empresas/olist.jpg deleted file mode 100644 index 44e0f9af..00000000 Binary files a/content/images/empresas/olist.jpg and /dev/null differ diff --git a/content/images/empresas/potelo.png b/content/images/empresas/potelo.png deleted file mode 100644 index 836266c0..00000000 Binary files a/content/images/empresas/potelo.png and /dev/null differ diff --git a/content/images/empresas/prodap.jpg b/content/images/empresas/prodap.jpg deleted file mode 100644 index 40b17083..00000000 Binary files a/content/images/empresas/prodap.jpg and /dev/null differ diff --git a/content/images/empresas/pycursos.png b/content/images/empresas/pycursos.png deleted file mode 100644 index 42286332..00000000 Binary files a/content/images/empresas/pycursos.png and /dev/null differ diff --git a/content/images/empresas/serpro.svg b/content/images/empresas/serpro.svg deleted file mode 100644 index f19b1869..00000000 --- a/content/images/empresas/serpro.svg +++ /dev/null @@ -1,57 +0,0 @@ - - - - diff --git a/content/images/empresas/sigma.png b/content/images/empresas/sigma.png deleted file mode 100644 index 584f639c..00000000 Binary files a/content/images/empresas/sigma.png and /dev/null differ diff --git a/content/images/empresas/silex.png b/content/images/empresas/silex.png deleted file mode 100644 index 9f5e23fa..00000000 Binary files a/content/images/empresas/silex.png and /dev/null differ diff --git a/content/images/empresas/studiosol.svg b/content/images/empresas/studiosol.svg deleted file mode 100644 index 5ec01d19..00000000 --- a/content/images/empresas/studiosol.svg +++ /dev/null @@ -1,116 +0,0 @@ - - diff --git a/content/images/empresas/tag-i.png b/content/images/empresas/tag-i.png deleted file mode 100644 index 2b072208..00000000 Binary files a/content/images/empresas/tag-i.png and /dev/null differ diff --git a/content/images/empresas/vinta.png b/content/images/empresas/vinta.png deleted file mode 100644 index 900c690f..00000000 Binary files a/content/images/empresas/vinta.png and /dev/null differ diff --git a/content/images/instalacao-windows/01.png b/content/images/instalacao-windows/01.png new file mode 100755 index 00000000..b7a5db92 Binary files /dev/null and b/content/images/instalacao-windows/01.png differ diff --git a/content/images/instalacao-windows/02.png b/content/images/instalacao-windows/02.png new file mode 100755 index 00000000..885ada82 Binary files /dev/null and b/content/images/instalacao-windows/02.png differ diff --git a/content/images/instalacao-windows/03.png b/content/images/instalacao-windows/03.png new file mode 100755 index 00000000..4501b93f Binary files /dev/null and b/content/images/instalacao-windows/03.png differ diff --git a/content/images/instalacao-windows/04.png b/content/images/instalacao-windows/04.png new file mode 100755 index 00000000..7a7b669a Binary files /dev/null and b/content/images/instalacao-windows/04.png differ diff --git a/content/images/instalacao-windows/05.png b/content/images/instalacao-windows/05.png new file mode 100755 index 00000000..678267c0 Binary files /dev/null and b/content/images/instalacao-windows/05.png differ diff --git a/content/images/instalacao-windows/06.png b/content/images/instalacao-windows/06.png new file mode 100755 index 00000000..c03b3bac Binary files /dev/null and b/content/images/instalacao-windows/06.png differ diff --git a/content/images/instalacao-windows/09.png b/content/images/instalacao-windows/09.png new file mode 100755 index 00000000..69770ca1 Binary files /dev/null and b/content/images/instalacao-windows/09.png differ diff --git a/content/images/instalacao-windows/11.gif b/content/images/instalacao-windows/11.gif new file mode 100755 index 00000000..b35f63a5 Binary files /dev/null and b/content/images/instalacao-windows/11.gif differ diff --git a/content/pages/apyb-faq.md b/content/pages/apyb-faq.md new file mode 100644 index 00000000..d265d904 --- /dev/null +++ b/content/pages/apyb-faq.md @@ -0,0 +1,4 @@ +Title: APyB - FAQ +Slug: apyb-faq +Template: redirect +Redirect: https://apyb.python.org.br/apyb/faq/ \ No newline at end of file diff --git "a/content/pages/apyb-fundo-inclus\303\243o.md" "b/content/pages/apyb-fundo-inclus\303\243o.md" new file mode 100644 index 00000000..75d2387d --- /dev/null +++ "b/content/pages/apyb-fundo-inclus\303\243o.md" @@ -0,0 +1,4 @@ +Title: Fundo para Inclusão +Slug: fundo-para-inclusão +Template: redirect +Redirect: https://apyb.python.org.br/apyb/fundo-inclusão/ \ No newline at end of file diff --git a/content/pages/apyb-historia.md b/content/pages/apyb-historia.md new file mode 100644 index 00000000..67aeb68f --- /dev/null +++ b/content/pages/apyb-historia.md @@ -0,0 +1,4 @@ +Title: História da APyB +Slug: apyb-historia +Template: redirect +Redirect: https://apyb.python.org.br/a-associacao/associacao/ \ No newline at end of file diff --git a/content/pages/apyb.md b/content/pages/apyb.md index 092a97b6..9221fd1a 100644 --- a/content/pages/apyb.md +++ b/content/pages/apyb.md @@ -1,95 +1,4 @@ Title: A APyB Slug: apyb -Template: page - -A Associação Python Brasil (APyB) foi formada em abril de 2007 com a meta de apoiar as comunidades relacionadas à linguagem Python e suas tecnologias derivadas. - -Sua atual diretoria atuará até Setembro de 2017. O estatuto da APyB foi discutido democraticamente em nossa Assembléia de fundação em 2007 e emendado na Assembléia Geral de 2008. - -## Integrantes da diretoria e conselhos: - -- Carlos Leite (Cadu) - Presidente -- Henrique Bastos - Diretor Financeiro -- Tânia Andrea - Diretora de Marketing -- Filipe Cifali - Diretor de Tecnologia - -- Rudá Filgueiras - Conselho Deliberativo -- Gustavo Maia Neto - Conselho Deliberativo -- Marco Antônio Rougeth de Oliveira - Conselho Deliberativo -- Paula Grangeiro- Suplente - -- Leonardo Rochael Almeida - Conselho Fiscal -- Igor dos Santos Silva - Conselho Fiscal -- Sérgio Oliveira - Conselho Fiscal -- Annanda Dandi - Suplente - -## Formas de contato: - -- contato@ (python.org.br) -- doacoes@ (python.org.br) - -## Objetivos e Metas - -- Organização de eventos, seminários e palestras; -- Coordenação de esforços de promoção e marketing da linguagem; -- Divulgação de casos de sucesso; -- Manutenção de bases de conhecimento online e sites colaborativos para a linguagem e as principais soluções derivadas; -- Fomentar a utilização da linguagem e seus derivados em instituições de ensino e organizações privadas, governamentais e de economia mista; -- Assegurar a proteção e uso das marcas relacionadas à linguagem Python e seus derivados. - -## Fundadores - - - -De pé (esquerda para direita): - -- Fabio Rizzo -- Pedro Werneck -- Johan Dahlin -- Julio Monteiro -- Érico Andrei -- Jacson Tiola -- Daniel Vainsencher -- Leonardo Rochael -- Ricardo Bánffy -- Luciano Ramalho -- Rodrigo Bernardo Pimentel -- Rodrigo Senra -- Luciano Pacheco -- Rodrigo Castardo -- Giuseppe Romagnoli - -Sentados (esquerda para direita): - -- Rudá Porto Filgueiras -- ??? -- Fabiano Weimar dos Santos -- Sérgio Oliveira -- Osvaldo Santana Neto -- Marco André -- Dornéles Treméa -- Jean Ferri - -## Associe-se - -Apaixonado por Python? Quer fazer parte da APyB? Você pode se inscrever AGORA através de nosso site. - -É fácil, [preencha o formulário](http://associados.python.org.br/members/signup/) e realize o pagamento da anuidade. - -Existem duas categorias de membros: - -### Estudantes - -- Anuidade: R$32,00 -- Direito a descontos em eventos da APyB, descontos em ofertas de parceiros - -### Efetivo - -- Anuidade: R$64,00 -- Direito a descontos em eventos da APyB, descontos em ofertas de parceiros -- Direito a votar e ser votado para cargos da APyB - - -## Já sou associado - -Confira a [lista de associados](http://associados.python.org.br/members/list/) ou [Autentique-se](http://associados.python.org.br/login/) para verificar seu status. +Template: redirect +Redirect: https://apyb.python.org.br/ \ No newline at end of file diff --git a/content/pages/cdc.md b/content/pages/cdc.md new file mode 100644 index 00000000..6b0682fd --- /dev/null +++ b/content/pages/cdc.md @@ -0,0 +1,4 @@ +Title: Código de Conduta do Evento Python Brasil +Slug: cdc +Template: redirect +Redirect: https://apyb.python.org.br/pythonbrasil/cdc/ \ No newline at end of file diff --git a/content/pages/cientifico.md b/content/pages/cientifico.md index 036307c6..b5aaf8c4 100644 --- a/content/pages/cientifico.md +++ b/content/pages/cientifico.md @@ -2,14 +2,20 @@ Title: Python no Meio Científico Slug: cientifico Template: page -Descubra como usar python no meio científico: +A linguagem Python vêm se tornando cada vez mais popular no mundo científico, devido à sua facilidade de uso, legibilidade e comunidade. Existem muitos pacotes no ecossistema de Python científico para diversas funções, como por exemplo: -## Ferramentas + - [**NumPy:**](https://numpy.org/) operações numéricas e estruturas de dados como arranjos n-dimensionais, geradores de numeros aleatórios, álgebra linear, e mais. Otimizado em C. + - [**pandas:**](http://pandas.pydata.org/) biblioteca de estatística e análise de dados baseada na NumPy. Contém estruturas de dados como DataFrames, parsers para arquivos tabulares, planilhas, interação com bancos de dados e outras funções. + - [**SciPy:**](https://www.scipy.org/) um conjunto de pacotes para diversas aplicações no domínio científico, como otimizadores, algoritmos numéricos, processamento de sinais, e muito mais. + - [**Matplotlib:**](http://matplotlib.org/) Criação de figuras em 2D e 3D + - [**scikit-learn:**](http://scikit-learn.org/) algoritmos e ferramentas para aprendizado de máquina. + - [**scikit-image:**](http://scikit-image.org/) algoritmos e ferramentas para processamento de imagens. + - [**BioPython:**](https://biopython.org/) estruturas de dados biológicos e algoritmos de bioinformática. + - [**NetworkX:**](https://networkx.github.io/) ferramentas para análise de redes complexas. + - [**SymPy:**](http://www.sympy.org/) biblioteca para matemática simbólica e álgebra computacional. + - [**Dask**](https://dask.readthedocs.io/) **e** [**Joblib:**](https://joblib.readthedocs.io/) processamento paralelo e/ou distribuído. + - [**conda:**](https://docs.conda.io/en/latest/) gerenciador de pacotes de código aberto, voltado para uso científico. + +Também existe a comunidade de [SciPy LA](https://www.scipyla.org/pt/), de Python científico na América Latina, que promove eventos e discussões. -### Scikit-learn -[Scikit-learn](http://scikit-learn.org/stable/) é um módulo Python de código aberto usado para mineração e análise de dados a partir do uso de métodos de Aprendizado de Máquina. - -### Anaconda -[Anaconda](https://docs.continuum.io) é um gerenciador de pacotes de código aberto, com ferramentas para ciência de dados. Possui mais de 720 pacotes e pode ser usado em Windows, macOS e Linux. - -## Conteúdo +Texto inspirado na [página do SciPy.](https://www.scipy.org/about.html) diff --git a/content/pages/contribua.md b/content/pages/contribua.md new file mode 100644 index 00000000..6a4e944b --- /dev/null +++ b/content/pages/contribua.md @@ -0,0 +1,144 @@ +Title: Contribua com este site +Slug: contribua +Template: page + +Site Live: [http://python.org.br/](http://python.org.br/) + +Repositório: [https://github.com/pythonbrasil/wiki](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 das empresas é uma importação do conteúdo encontrado em [https://github.com/pythonbrasil/pyBusinesses-BR](https://github.com/pythonbrasil/pyBusinesses-BR). + +### Páginas do Inicie-se + +1. **Qual python?** - Conteúdo em formato markdown no arquivo [content/pages/qual-python.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/qual-python.md). + +2. **Instalação Linux** - Conteúdo em formato markdown no arquivo [content/pages/instalacao-linux.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/instalacao-linux.md). + +3. **Instalação Mac** - Conteúdo em formato markdown no arquivo [content/pages/instalacao-mac.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/instalacao-mac.md). + +4. **Instalação Windows** - Conteúdo em formato markdown no arquivo [content/pages/instalacao-windows.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/instalacao-windows.md). + +5. **Introdução** - Conteúdo em formato markdown no arquivo [content/pages/introducao.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/introducao.md). + +6. **Ferramentas** - Conteúdo em formato markdown no arquivo [content/pages/ferramentas.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/ferramentas.md) + +### Páginas do Aprenda mais + +1. **Web** - Conteúdo em formato markdown no arquivo [content/pages/web.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/web.md). + +2. **Mobile** - Conteúdo em formato markdown no arquivo [content/pages/mobile.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/mobile.md). + +3. **Games** - Conteúdo em formato markdown no arquivo [content/pages/games.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/games.md). + +4. **Científico** - Conteúdo em formato markdown no arquivo [content/pages/cientifico.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/cientifico.md). + +### 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/](https://github.com/pythonbrasil/wiki/tree/pelican/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/](https://github.com/pythonbrasil/wiki/tree/pelican/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](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/](https://github.com/pythonbrasil/wiki/tree/pelican/content/eventos). + +4. **Contribua** - Conteúdo em formato markdown no arquivo [content/pages/contribua.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/contribua.md). + +5. **Tradução** - Conteúdo em formato markdown no arquivo [content/pages/traducao.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/traducao.md). + +### Páginas da APyB + +1. **Python Brasil** - Conteúdo em formato markdown no arquivo [content/pages/python-brasil.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/python-brasil.md). + +2. **A APyB** - Conteúdo em formato markdown no arquivo [content/pages/apyb.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/apyb.md). + +3. **Premio Dorneles Tremea** - Conteúdo em formato markdown no arquivo [content/pages/premio-dorneles-tremea.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/premio-dorneles-tremea.md). + +### Para contribuir com desenvolvimento + +Crie um [virtualenv](https://virtualenv.readthedocs.org/en/latest/) 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](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/](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 +``` diff --git a/content/pages/empresas.md b/content/pages/empresas.md index 4ee6acb6..dc71c516 100644 --- a/content/pages/empresas.md +++ b/content/pages/empresas.md @@ -5,4 +5,19 @@ Template: empresas # Empresas que usam Python -Conheça as empresas espalhados pelo Brasil que utilizam Python. +Conheça as empresas espalhadas pelo Brasil que utilizam Python. + +> Se você quer incluir alguma empresa que usa Python, faça sua contribuição, adicionando-a ao repositório [https://github.com/pythonbrasil/pyBusinesses-BR](https://github.com/pythonbrasil/pyBusinesses-BR). Todos os dados aqui apresentados encontram-se nesse mesmo repositório. + + +## Ranking + +Gráfico com o ranking das cidades com mais empresas utilizando a linguagem de programação Python no Brasil segundo o repositório mencionado acima. + + + + + + + +## Empresas diff --git a/content/pages/estatuto.md b/content/pages/estatuto.md new file mode 100644 index 00000000..83763bcc --- /dev/null +++ b/content/pages/estatuto.md @@ -0,0 +1,4 @@ +Title: Estatuto da Associação Python Brasil +Slug: estatuto +Template: redirect +Redirect: https://github.com/apyb/estatuto \ No newline at end of file diff --git a/content/pages/estatuto.rst b/content/pages/estatuto.rst deleted file mode 100644 index 7af8b26f..00000000 --- a/content/pages/estatuto.rst +++ /dev/null @@ -1,456 +0,0 @@ -:title: Estatuto da APyB -:slug: estatuto -:template: page - -Capítulo I - Da Associação --------------------------- - -Art. 1º - A Associação Python Brasil, fundada em 22 de junho de 2007, é uma -associação civil de direito privado, sem fins lucrativos, que se regerá pelos -presentes estatutos, com sede e foro na cidade de Caxias do Sul, RS, podendo, -estabelecer delegações em quaisquer cidades do território nacional. - - § primeiro: a Associação Python Brasil terá sede na Rua Andréa Viero 215, - Bairro Marechal Floriano, Caxias do Sul, RS, CEP 95013-060. - - § segundo: o prazo de duração da Associação Python Brasil é por tempo - indeterminado. - -Art. 2º - A Associação Python Brasil tem por finalidade apoiar as -comunidades de usuários e desenvolvedores da linguagem Python e suas -aplicações, no Brasil, através da consecução dos seguintes objetivos: - -a. organizar eventos, seminários, palestras e atividades educacionais para - disseminar o conhecimento sobre Python e suas aplicações; -b. fomentar a utilização da linguagem e suas aplicações em instituições de - ensino e organizações privadas, governamentais e de economia mista; -c. manter bases de conhecimento, listas de discussão e sites colaborativos para - a comunidade de usuários e desenvolvedores; -d. coordenar esforços de promoção e marketing; -e. divulgar casos de sucesso; -f. assegurar a proteção e o bom uso das marcas relacionadas à linguagem Python - e suas aplicações. - - § único: no cumprimento de suas finalidades, a Associação Python Brasil poderá - firmar contratos e/ou convênios com entidades financiadoras de projetos, - nacionais ou estrangeiras, de direito público ou privado, destinando os - recursos exclusivamente para a manutenção e desenvolvimento de seus objetivos. - - -Capítulo II - Dos Associados ----------------------------- - -Art. 3º - A Associação será constituída por número ilimitado de associados, -pessoas físicas ou jurídicas, sem distinção de nacionalidade ou qualquer outra -natureza, desde que concordem com os objetivos da Associação Python Brasil, -desejem contribuir para que os mesmos sejam alcançados, aceitem e cumpram as -condições estabelecidas no Estatuto e sejam aprovados de acordo com a norma -específica. - -Art. 4º - As categorias de Associados são: - -a. Plenos; -b. Efetivos; -c. Estudantes; -d. Honorários. - - § primeiro: são Associados Plenos as pessoas físicas que tenham completado - cinco anos como Associados Efetivos ou tenham assinado a Ata da Assembléia - de Fundação até trinta dias após a realização da Assembléia de Fundação, e - estejam quites com a taxa de inscrição e demais contribuições, na forma - indicada pela Diretoria e fixada pelo Conselho Deliberativo. - - § segundo: são Associados Efetivos as pessoas físicas que tenham sua - proposta de associação aprovada pela Diretoria e estejam quites com a taxa - de inscrição e demais contribuições, na forma indicada pela Diretoria e - fixada pelo Conselho Deliberativo. - - § terceiro: são Associados Estudantes as pessoas físicas que possam - comprovar sua condição de aluno de instituição do ensino médio ou superior - reconhecida pelo Ministério da Educação, tenham sua proposta de associação - aprovada pela Diretoria e estejam quites com a taxa de inscrição e demais - contribuições, na forma indicada pela Diretoria e fixada pelo Conselho - Deliberativo. - - § quarto: são Associados Honorários as pessoas físicas ou jurídicas que, - por contribuírem para a consecução dos objetivos da Associação Python - Brasil, recebam tal designação do Conselho Deliberativo, ouvida a - Diretoria. - -Art. 5º - São direitos de todos os Associados pessoas físicas: ter prioridade e -desconto na inscrição em atividades patrocinadas ou organizadas pela Associação -Python Brasil; ser informado de tais atividades e de outros benefícios que -venham a ser criados. - - § único: São direitos exclusivos dos Associados Plenos e Associados - Efetivos: votar as deliberações propostas em Assembléia Geral, votar e ser - votado para a Diretoria, Conselho Deliberativo e Conselho Fiscal. - -Art. 6º - São deveres de todos os Associados: contribuir regularmente, na forma -e periodicidade fixadas; cumprir os preceitos deste estatuto, bem como os -Programas e Regulamentos que forem adotados; colaborar para que a Associação -Python Brasil atinja seus objetivos e zelar pelo seu bom nome e -desenvolvimento. - - § primeiro: Somente os Associados que estiverem quites com a taxa de - inscrição e em dia com as demais contribuições poderão gozar dos direitos - previstos neste estatuto. Em caso de atraso, tais direitos poderão ser - suspensos, sendo restituídos após a regularização dos pagamentos, na forma - indicada pela Diretoria. - - § segundo: As contribuições à Associação Python Brasil poderão ser em - espécie, bens ou serviços prestados, na forma e periodicidade indicadas - pela Diretoria e aprovadas pelo Conselho Deliberativo. - -Art. 7º - Qualquer associado pode ser advertido, suspenso, e até excluído por -atos ou omissões, pelo não-exercício de suas funções estatutárias ou por -desrespeito aos objetivos fundamentais da Associação Python Brasil, mediante -proposta da Diretoria ou de um grupo de associados ao Conselho Deliberativo. Os -membros faltosos bem como os demais membros da Assembléia serão comunicados por -escrito, incluindo meios eletrônicos, através de advertência. Os membros -faltosos têm 30 dias após a divulgação da advertência para interpor recurso à -Assembléia Geral. - - § único: em caso comprovadamente grave, e após ser oportunizado ao - associado o direito de ampla defesa, a Assembléia Geral decidirá, no prazo - de 60 (sessenta) dias qual a penalidade sofrerá o associado faltoso do - Conselho Deliberativo e da Assembléia Geral. - -Art. 8º - É direito do associado demitir-se do quadro social, quando julgar -necessário, protocolando seu pedido junto à secretária da Associação Python -Brasil, desde que não esteja em débito com suas obrigações associativas. - -Art. 9º - Os órgãos de direção da Associação Python Brasil são: - -a. Assembléia Geral; -b. Conselho Deliberativo; -c. Diretoria; -d. Conselho Fiscal; -e. Conselho Consultivo. - - -Capítulo III - Da Assembléia ----------------------------- - -Art. 10º - A Assembléia Geral é a reunião dos Associados Plenos e Efetivos, com -direito a voto e em dia com as suas contribuições. É o principal órgão de poder -e deliberação da Associação. - - § único: a convocação para a Assembléia Geral far-se-á com a antecedência - mínima de 30 (trinta) dias, mediante correspondência eletrônica aos - associados, bem como em Edital disponível no site da Associação. - -Art. 11º - Compete privativamente à assembléia geral: - -a. eleger os Diretores e Conselheiros; -b. destituir os Diretores e Conselheiros; -c. alterar o estatuto. -d. aprovar as contas e relatório constante no item "a" art 29.º deste Estatuto. - -Art. 12º - A Assembléia Geral reunir-se-á ordinariamente uma vez por ano, de -preferência durante a realização de evento de porte nacional, para dar -conhecimento aos seus membros do relatório da Diretoria, já aprovado pelo -Conselho Deliberativo, e eleger, quando couber, uma nova Diretoria e membros do -Conselho Deliberativo, conforme dispõem os termos do Estatuto; -extraordinariamente, para fins especiais e expressos, sempre que convocada pelo -Conselho Deliberativo, pela Diretoria ou por 1/5 (um quinto) dos Associados -Plenos e Efetivos em gozo dos seus direitos. - - § primeiro: a Assembléia Geral elegerá dentre os seus membros uma Mesa - constituída por um presidente, um primeiro e um segundo secretários. - - § segundo: os trabalhos das Assembléias Gerais serão dirigidos pelo - presidente, coadjuvado pelos secretários. - -Art. 13º - Ressalvadas outras disposições estatutárias, devem ser observadas as -seguintes normas para que a Assembléia Geral se realize e delibere: - -a. a Assembléia Geral deverá funcionar, em primeira convocação, com a presença - mínima de 1/3 (um terço) dos Associados com direito a voto, e em segunda - convocação, 30 (trinta) minutos depois, com qualquer quorum a partir de 11 - (onze) membros; -b. as decisões serão obtidas por maioria absoluta dos presentes, exceto quando - se tratar de alterações neste estatuto; -c. para aprovar alterações neste estatuto serão necessários no mínimo 2/3 dos - votos dos presentes; -d. é permitido o voto por procuração, limitado a uma procuração por membro - presente. - - § único: os membros da mesa da Assembléia Geral poderão integrar outros órgãos - da direção da Associação Python Brasil. - - -Capítulo IV - Do Conselho Deliberativo --------------------------------------- - -Art. 14º - O Conselho Deliberativo será constituído por 3 (três) membros -titulares e 1 (um) suplente, eleitos individualmente pela Assembléia Geral, -sendo composto obrigatoriamente por Associados Plenos ou Efetivos, conforme -disposição abaixo, Capítulo VIII, "Das eleições". - - § primeiro: o mandato dos membros do Conselho Deliberativo será de 2 (dois) - anos prorrogados automaticamente até o registro da ata empossando os - conselheiros eleitos em assembléia; exceto no primeiro exercício, conforme - disposto no Capítulo IX, "Das Disposições Gerais e Transitórias". - - § segundo: o Conselho Deliberativo elegerá, dentre os seus membros, na - primeira reunião que realizar após cada renovação de seus membros, um - Presidente e um Primeiro-Secretário que convocarão e dirigirão as suas - reuniões. Na falta de titulares, os conselheiros elegerão os membros da Mesa - para essa sessão de trabalho. - - § terceiro: o Conselho Deliberativo será convocado por seu Presidente, por - convocação direta de um de seus membros ou pela Diretoria da Associação - Python Brasil, com um mínimo de 7 (sete) dias de antecedência, através de - telegrama, comunicação eletrônica ou pessoal. O quorum para deliberações é de - 3 (três) conselheiros em primeira convocação ou 2 (dois) conselheiros em - segunda convocação, 30 (trinta) minutos depois, quando podem assumir os - respectivos suplentes de cada terço do Conselho. - - § quarto: os membros do Conselho Deliberativo poderão integrar outros órgãos - de direção da Associação. - -Art. 15º - São atribuições do Conselho Deliberativo: - -a. interpretar os presentes estatutos e aprovar regulamentos e normas - específicas apresentados pela Diretoria; -b. recomendar a suspensão ou a exclusão de qualquer membro do Conselho - Deliberativo, da Diretoria, do Conselho Fiscal ou do Conselho Consultivo, em - caso de não-exercício de suas funções estatutárias ou por falta grave, - assegurado o direito de defesa e recurso à Assembléia Geral; -c. aplicar penalidades e julgar recursos; -d. fixar anuidades e outras contribuições, por proposta da Diretoria; as - atualizações são de competência da Diretoria; -e. apreciar e aprovar os relatórios da Diretoria e os pareceres do Conselho - Fiscal; -f. conceder, por proposta da Diretoria, títulos de associados honorários ou - outras honrarias que a Associação venha a criar, podendo delegar à - Diretoria, por regulamento especifico, esta atribuição; -g. aprovar as indicações e renovar os mandatos de membros do Conselho - Consultivo; -h. solicitar pareceres e recomendar estudos e projetos ao Conselho Consultivo. - - -Capítulo V - Da Diretoria -------------------------- - -Art. 16º - A Diretoria é composta por 4 (quatro) Associados Plenos ou Efetivos -eleitos pela Assembléia Geral para um mandato de 2 (dois) anos prorrogados -automaticamente até o registro da ata empossando os novos diretores eleitos em -assembléia; exceto no primeiro exercício, conforme disposto no Capítulo IX, -"Das Disposições Gerais e Transitórias". - -Art. 17º - Compete à Diretoria planejar e realizar as atividades de entidade de -acordo com seus objetivos e programas, além do cumprimento das -responsabilidades que lhe serão atribuídas nestes estatutos ou que forem -determinadas pela Assembléia Geral ou pelo Conselho Deliberativo. - -Art. 18º - A Diretoria é constituída por: - -a. Diretor Presidente; -b. Diretor Financeiro; -c. Diretor de Tecnologia; -d. Diretor de Marketing. - -Art. 19º - Compete ao Diretor Presidente à representação em juízo e fora dele, -bem como presidir as reuniões da Diretoria, assinar cheques, efetuar -movimentações financeiras e pagamentos, além das atribuições restantes que -estatutariamente lhe estão conferido. - -Art. 20º - Compete ao Diretor Financeiro organizar e dirigir os trabalhos da -tesouraria, tendo a seu cargo o arquivo de documentos contábeis, arrecadação de -fundos e controle de despesas, bem como assinar cheques, efetuar movimentações -financeiras e pagamentos. Cabe ao Diretor Financeiro substituir o Diretor -Presidente em suas ausências e impedimentos. - -Art. 21º - Compete ao Diretor de Tecnologia administrar, executar e coordenar -as atividades relacionadas aos recursos tecnológicos necessários para dar -suporte às atividades da Associação Python Brasil; - -Art. 22º - Compete ao Diretor de Marketing coordenar as atividades de promoção -e divulgação da Linguagem Python e tecnologias relacionadas bem como da -Associação Python Brasil. Compete ao Diretor de Marketing escolher e apoiar a -organização de eventos que promovam a Linguagem Python e tecnologias -relacionadas. - -Art. 23º - Os documentos contábeis necessitarão da assinatura do Diretor -Presidente ou do Diretor Financeiro; - - § único: no caso da ausência ou impedimento do Diretor Presidente e do Diretor - Financeiro os documentos poderão ser assinados por qualquer integrante da - diretoria; - -Art. 24º - O quorum mínimo para deliberações da Diretoria é de 3 (três) -membros. As deliberações deverão se dar por maioria simples dos presentes, -cabendo ao Diretor Presidente em exercício o voto de desempate, se houver -necessidade. - -Art. 25º - A Diretoria pode contratar e demitir funcionários, bem como serviços -de terceiros, pessoas físicas ou jurídicas, assinar convênios e contratos e -criar quaisquer instâncias de funcionamento da Associação, desde que não -colidam com as disposições destes estatutos. - - -Capítulo VI - Do Conselho Fiscal --------------------------------- - -Art. 26º - O Conselho Fiscal será constituído por 3 (três) membros titulares e -1 (um) suplente eleito individualmente pela Assembléia Geral, com mandato -concomitante ao da Diretoria. - - § primeiro: nenhum Associado poderá ocupar simultaneamente cargo no Conselho - Fiscal e na Diretoria. - - § segundo: em sua primeira reunião o Conselho Fiscal elegerá, dentre seus - membros titulares, com voto dos suplentes, um Presidente que dirigirá e - convocará suas reuniões, e um Secretário, que fará a guarda dos livros e das - atas das reuniões. - -Art. 27º - O Conselho Fiscal reunir-se-á, ordinariamente, por convocação de seu -Presidente e, extraordinariamente, quando for convocado pela Diretoria. - -Art. 28º - Compete ao Conselho Fiscal: - -a. dar parecer e aprovar o relatório, o balanço e as contas anuais da - Diretoria; -b. fiscalizar os livros e as contas da Associação; -c. dar parecer sobre os atos financeiros a serem apresentados ao Conselho - Deliberativo. - - -Capítulo VII - Do Conselho Consultivo -------------------------------------- - -Art. 29º - O Conselho Consultivo será composto por pessoas com notório saber em -Ciência da Computação ou Engenharia de Software, ou histórico de contribuições -relevantes ao aperfeiçoamento, aplicação e divulgação da linguagem Python ou -produtos desenvolvidos com ela. - - § único: o mandato de cada membro do Conselho Consultivo poderá ser renovado a - cada 2 (dois) anos, sempre que uma nova Diretoria iniciar o seu mandato, - através de recomendação da Diretoria ao Conselho Deliberativo. - -Art. 30º - Candidatos a membro do Conselho Consultivo podem ser indicados por -qualquer Associado Efetivo ou Pleno ao Conselho Deliberativo. - -Art. 31º - Compete ao Conselho Consultivo: - -a. acompanhar a evolução da linguagem Python e suas aplicações no mercado e no - meio acadêmico; -b. elaborar pareceres, estudos e projetos a pedido do Conselho Deliberativo; -c. propor ações para que a Associação Python Brasil continue, em longo prazo, - cumprindo os objetivos delineados no Capítulo I deste estatuto. - - -Capítulo VIII - Das Eleições ----------------------------- - -Art. 32º - A eleição da Diretoria, do Conselho Deliberativo e do Conselho -Fiscal dar-se-á a cada dois anos. - -Art. 33º - Os processos eleitorais para renovar a Diretoria, o Conselho -Deliberativo e o Conselho Fiscal, através da Assembléia Geral, deverão ser -convocados pela Diretoria com a antecedência mínima de 30 (trinta) dias. - - § primeiro: a inscrição das chapas para a Diretoria e candidatos às vagas dos - Conselhos Deliberativo e Fiscal será feita na hora, junto à Mesa da Assembléia - Geral, até meia hora após a determinação do quorum e início dos trabalhos da - Assembléia. - - § segundo: cada Associado poderá se candidatar a até duas vagas individuais, - ou para uma vaga individual e uma chapa para a Diretoria. - - § terceiro: um mesmo candidato não poderá ser eleito para a Diretoria e o - Conselho Fiscal, mas poderá ser eleito para a Diretoria e o Conselho - Deliberativo ou para o Conselho Fiscal e o Conselho Deliberativo. - -Art. 34º - A eleição da Diretoria dar-se-á por chapas. - - § primeiro: para poder concorrer, cada chapa deverá indicar nomes para todos - os cargos da diretoria, a saber: Diretor Presidente, Diretor Financeiro, - Diretor de Tecnologia e Diretor de Marketing. - - § segundo: será eleita a chapa que tiver o maior número de votos. - - § terceiro: em caso de empate, proceder-se-á a nova eleição. - -Art. 35º - A eleição dos Conselhos Deliberativo e Fiscal dar-se-á por -indivíduos. - - § primeiro: cada membro da Assembléia poderá votar em um nome para cada vaga - em disputa no Conselho Deliberativo e no Conselho Fiscal, excluídas as - suplências, podendo incluir nomes não relacionados junto à Mesa, desde que - Associados Plenos ou Efetivos, em pleno gozo de seus direitos. - - § segundo: em caso de empate nas votações para o Conselho Deliberativo ou o - Conselho Fiscal, terá prioridade o candidato que seja Associado Pleno ou - Efetivo pelo período ininterrupto mais longo, como comprovado pelos registros - da Associação Python Brasil. Na persistência do empate, submeter-se-ão os - candidatos empatados à nova votação. - - -Capítulo IX - Das Disposições Gerais e Transitórias ---------------------------------------------------- - -Art. 36º - Os associados não respondem solidária nem subsidiariamente pelas -obrigações da Associação, assim como ela não é responsável por atos praticados -ou por obrigações contraídas por seus membros, salvo quando por deliberação de -seus órgãos de direção. - -Art. 37º - A dissolução da Associação, devidamente justificada, só poderá ser -deliberada em Assembléia Geral Extraordinária, especialmente convocada para -esse fim pelo Conselho Deliberativo ou pela Diretoria, com um quorum de 2/3 -(dois terços) dos associados com direito a voto, em primeira convocação, e com -o quorum de 1/3 (um terço) dos associados com direito a voto, em segunda -convocação, um dia depois. - - § primeiro: em caso de aprovação da dissolução da entidade, a Assembléia Geral - deverá escolher uma comissão de associados, com poderes especiais, para - proceder à liquidação. - - § segundo: apurado o ativo e liquidados os compromissos sociais, caso haja - saldo positivo, este será doado a uma entidade similar ou congênere, inscrita - no Conselho Nacional de Serviço Social, conforme Assembléia Geral - Extraordinária de dissolução. - -Art. 38º - As receitas da Associação Python Brasil são basicamente, -constituídas por: - -a. contribuições dos associados; -b. contribuições de entidades nacionais e estrangeiras; -c. subvenções, subscrições ou doações de origem pública ou privada; -d. edição e venda de publicações e livros; -e. realização de eventos, cursos e seminários; -f. realização de convênios; -g. receita proveniente de publicidade em seus veículos de comunicação; -h. outros meios que a Diretoria venha a criar, com a aprovação do Conselho - Deliberativo. - -Art. 39º - O exercício financeiro encerrar-se-á em 31 de dezembro de cada ano. - - § único: o relatório da Diretoria, o balanço anual e a documentação necessária - devem ser apresentados pela Diretoria, em março de cada ano. - -Art. 40º - O exercício de cargos eleitos não será remunerado a qualquer título. - -Art. 41º - Os casos omissos ou contraditórios do estatuto serão dirimidos pelo -Conselho Deliberativo. - -Art. 42º - A convocação dos órgãos deliberativos poderá ser feita por 1/5 (um -quinto) dos Associados com direito a voto. - -Art. 43º - Durante a Assembléia de Fundação serão eleitos uma Diretoria, 9 -(nove) conselheiros e 3 (três) suplentes para o Conselho Deliberativo e 3 -(três) conselheiros e 2 (dois) suplentes para o Conselho Fiscal, com os -seguintes mandatos reduzidos: - -a. Diretoria e Conselho Fiscal: mandato até a Assembléia Geral prevista para - agosto de 2007; -b. Conselho Deliberativo: 1/3 (um terço) com mandato até a Assembléia Geral - prevista para agosto de 2007, e 2/3 (dois terços) com mandato até a - Assembléia Geral prevista para o segundo semestre de 2008. Os eleitos melhor - classificados na lista de votação terão o mandato mais longo. - -Art. 44º - Excepcionalmente, durante a primeira Assembléia Geral que ocorrer um -ano após a Assembléia de Fundação, alterações neste estatuto poderão ser feitas -por maioria simples dos votos dos presentes. diff --git a/content/pages/este-site.md b/content/pages/este-site.md deleted file mode 100644 index fbb5dd9e..00000000 --- a/content/pages/este-site.md +++ /dev/null @@ -1,159 +0,0 @@ -Title: Contribua com este site -Slug: este-site -Template: page - -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](http://pythonbrasil.github.io/wiki) - -Repo: [https://github.com/pythonbrasil/wiki](https://github.com/pythonbrasil/wiki) - -Este projeto utiliza [Pelican](http://blog.getpelican.com/) como gerador de páginas estáticas e [Travis-CI](https://travis-ci.org/) para realizar a integração contínua. - -## Por que usar isso? - -1. Basta ter uma conta no GitHub. -2. Consigo editar via web. -3. 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... - -Não, não somos. - -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* - -## Mapeamento do Conteúdo - -Veja como está organizado o conteúdo e como contribuir: - -### Páginas do Impressione-se - -1. 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/](https://github.com/pythonbrasil/wiki/tree/pelican/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/](https://github.com/pythonbrasil/wiki/tree/pelican/content/images/empresas). - -### Páginas do Inicie-se - -1. Instalação - -Conteúdo em formato markdown no arquivo [content/pages/instalacao.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/instalacao.md). - -2. Ferramentas - -Conteúdo em formato markdown no arquivo [content/pages/ferramentas.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/ferramentas.md) - -### Páginas do Aprenda mais - -1. Introdução - -Conteúdo em formato markdown no arquivo [content/pages/introducao.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/introducao.md). - -2. Web - -Conteúdo em formato markdown no arquivo [content/pages/web.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/web.md). - -3. Mobile - -Conteúdo em formato markdown no arquivo [content/pages/mobile.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/mobile.md). - -4. Games - -Conteúdo em formato markdown no arquivo [content/pages/games.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/games.md). - -5. Científico - -Conteúdo em formato markdown no arquivo [content/pages/cientifico.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/cientifico.md). - -### 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/](https://github.com/pythonbrasil/wiki/tree/pelican/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/](https://github.com/pythonbrasil/wiki/tree/pelican/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](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/](https://github.com/pythonbrasil/wiki/tree/pelican/content/eventos). - -4. Python Brasil - -Conteúdo em formato markdown no arquivo [content/pages/python-brasil.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/python-brasil.md). - -5. A APyB - -Conteúdo em formato markdown no arquivo [content/pages/apyb.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/apyb.md). - -### Páginas do Contribua - -1. Este Site - -Conteúdo em formato markdown no arquivo [content/pages/este-site.md](https://github.com/pythonbrasil/wiki/blob/pelican/content/pages/este-site.md). - -2. Tradução - -Conteúdo em formato markdown no arquivo [content/pages/traducao.md](https://github.com/pythonbrasil/wiki/blob/pelican/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. - -### Processo de instalação: - -Crie um [virtualenv](https://virtualenv.readthedocs.org/en/latest/) 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 https://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](http://mindbending.org/pt/instalando-o-pelican). diff --git a/content/pages/eventos.md b/content/pages/eventos.md deleted file mode 100644 index e1532414..00000000 --- a/content/pages/eventos.md +++ /dev/null @@ -1,5 +0,0 @@ -Title: Eventos -Slug: eventos -Template: eventos - -Página para a divulgação dos eventos da comunidade. diff --git a/content/pages/ferramentas.md b/content/pages/ferramentas.md index 1ad911ec..cabfa9d5 100644 --- a/content/pages/ferramentas.md +++ b/content/pages/ferramentas.md @@ -6,118 +6,151 @@ Veja aqui uma listagem de ferramentas para te auxiliar no desenvolvimento python # Editores de texto -### vim - http://www.vim.org/ -Esse é o que eu uso ( OsvaldoSantanaNeto ). Tem em todo GNU/Linux e é altamente configurável. Uma forma de transformar o vim em uma IDE Python completa é seguindo o tutorial em http://avelino.us/2011/12/22/vim-ide-para-programadores-python/ (pt-BR) -PythonBrasil[5] - DDD.py - tem boas dicas para utilizar o vim - http://www.pythonbrasil.org.br/2009/sobre-o-evento/slides/ddd.py/view -### Emacs - http://www.gnu.org/software/emacs/emacs.html -Um editor ( ou um sistema operacional com capacidades de edição ? :) ) poderoso e amplamente extensível em eLisp (um dialeto Lisp). Vencida a curva de aprendizado (considerada dificil por alguns) é possível torna-lo em uma IDE Python poderosíssima. O python-mode.el prove diversas funcionalidades para edição, debug e desenvolvimento de programas em Python e o Ropemacs funcionalidades de refactoring. Mais "Emacs Goodies" na propria Wiki em PythonComEmacs. +### [Atom](https://atom.io/) -### SciTE - http://www.scintilla.org/SciTE.html -Excelente editor de textos voltado para programação. Suporta uma grande lista de linguagens, pode rodar e debugar os programas, é fácil de usar e é muito configurável. Disponível para Windows e X (ambiente gráfico dos UNIXes). +Atom é open source e feito pelo Github e com suporte para várias linguagens, dentre elas o Python. É integrado ao Git e Github, sendo possível mexer com o Git e Github através da interface do editor de texto. Ótimo para iniciantes. + +### [Visual Studio Code](https://code.visualstudio.com/) + +O VSCode é open source e free, desenvolvido pela Microsoft. Suporta inúmeras linguagens de programação. + +### [Vim](http://www.vim.org/) + +Tem em todo GNU/Linux e é altamente configurável. Uma forma de transformar o vim em uma IDE Python completa é seguindo o tutorial em [vim a ide para programadores python](https://avelino.run/vim-a-ide-para-programadores-python/). + +### [Emacs](http://www.gnu.org/software/emacs/emacs.html) + +Um editor (ou um sistema operacional com capacidades de edição?!) poderoso e amplamente extensível em eLisp (um dialeto Lisp). Vencida a curva de aprendizado (considerada difícil por algumas pessoas) é possível torná-lo em uma IDE Python poderosíssima. O python-mode.el prove diversas funcionalidades para edição, debug e desenvolvimento de programas em Python e o Ropemacs funcionalidades de refactoring. Mais "Emacs Goodies" na própria Wiki em PythonComEmacs. + +### [SciTE](http://www.scintilla.org/SciTE.html) + +Excelente editor de texto voltado para programação. Suporta uma grande lista de linguagens, pode rodar e debugar os programas, é fácil de usar e é facilmente configurável. Disponível para Windows e X (ambiente gráfico dos UNIXes). + +### [jext](https://sourceforge.net/projects/jext/) -### jext - http://www.jext.org/ Muito bom editor! Suporta muitas linguagens e possui plugins para Python (executar, por exemplo). -### joe - http://sourceforge.net/projects/joe-editor/ -Editor de texto para dinossauros :-) Utiliza os mesmos comandos do WordStar, SideKick, etc. Disponivel via apt-get e emerge. (NiloMenezes). +### [joe](http://sourceforge.net/projects/joe-editor/) -### sublime - http://www.sublimetext.com/ -Editor de texto proprietário e pago, porém disponibiliza uma versão beta para uso sem custo. Atualmente na versão 2, a compra de sua licensa permite o uso de ambas as versão existentes. +Editor de texto para dinossauros :-) Utiliza os mesmos comandos do WordStar, SideKick, etc. Disponivel via apt-get e emerge. -### PS Pad - http://www.pspad.com/ -Grátis (freeware) para Windows. Colore código Python e suporta edição com vários encodings. Tem também utilitários para HTML/XML, tabela ASCII e conversão DOS/UNIX. O Hex view quebra um galho na hora de procurar erros em arquivos com encoding incorreto. +### [sublime](http://www.sublimetext.com/) + +Editor de texto proprietário e pago, porém disponibiliza uma versão beta para uso sem custo. Atualmente na versão 3, a compra de sua licensa permite o uso de ambas as versão existentes. -Uma lista com outros (muitos) editores podem ser encontrados em http://www.python.org/moin/PythonEditors +### [PS Pad](http://www.pspad.com/) + +Grátis (freeware) para Windows. Colore código Python e suporta edição com vários encodings. Tem também utilitários para HTML/XML, tabela ASCII e conversão DOS/UNIX. O Hex view quebra um galho na hora de procurar erros em arquivos com encoding incorreto. # IDEs gratuitas -### Idle - http://www.python.org -O IDLE vem com o Python. É feito com Tkinter e se você se acostumar pode lhe ajudar bastante. É bem simples de ser usado também. +### [Idle](http://www.python.org) + +A IDLE vem com o Python. É feita com Tkinter e se você se acostumar pode lhe ajudar bastante. É bem simples de ser usada também. + +### [PyCharm community](https://www.jetbrains.com/pycharm/) + +É desenvolvido pela companhia JetBrains. Esta edição é liberada sob a licença da Apache. É multiplataforma. Essa IDE fornece análise de código, um depurador gráfico, um testador de unidade integrado, integração com sistemas de controle de versão (VCSes), e suporta desenvolvimento de web com Django. + +### [Komodo-Edit](http://www.activestate.com/komodo_edit/) -### Komodo-Edit - http://www.activestate.com/komodo_edit/ Também desenvolvido pela ActiveState o Komodo-Edit é uma excelente opção de editor, bastante rico em recursos tais como autocomplete, calltips, multi-language file support, syntax coloring, syntax checking, Vi emulation, Emacs key bindings e outros. -### NetBeans - http://netbeans.org/features/python/index.html +### [NetBeans](http://nbpython.org/) + Analogamente ao Eclipse, o NetBeans também oferece suporte ao Python através de plugins. -### NINJA-IDE - http://ninja-ide.org/ +### [NINJA-IDE](http://ninja-ide.org/) + Do acrônimo recursivo: "Ninja-IDE Is Not Just Another IDE", é uma IDE multi-plataforma de desenvolvimento integrado. NINJA-IDE é executado em Linux/X11, Mac OS X e sistemas operacionais de desktop Windows, e permite aos desenvolvedores criarem aplicações para diversas finalidades, utilizando todas as ferramentas e utilitários de NINJA-IDE, tornando a tarefa de escrever software mais fácil e agradável. -### SPE - http://pythonide.blogspot.com/ +### [SPE](http://pythonide.blogspot.com/) + Desenvolvido com wxPython é livre e tem algumas funcionalidades interessantes. Tem wxGlade como plugin para desenho de telas gráficas. -### Spyder 2 - http://code.google.com/p/spyderlib/ +### [Spyder 2](http://code.google.com/p/spyderlib/) + Spyder (também conhecido como Pydee) é um poderoso ambiente de desenvolvimento interativo para a linguagem Python com edição avançada, testes interativos, recursos de depuração e introspecção -### Pida - http://pida.co.uk/ -É uma IDE desenvolvida com PyGTK e visa a integração com o Vim. Oferece recursos como project management, source code management, code browser, code refactor, profiler, debugger entre outros. +### [Pida](https://www.openhub.net/p/pida) -### Eric4 - http://www.die-offenbachs.de/eric/index.html -Dos IDEs esse é o que mais gosto. Não é exatamente o que eu uso (OsvaldoSantanaNeto) mas acho que é o mais completo de todos. É feito com a biblioteca QT e se integra às ferramentas da QT e com outros softwares como o Bicycle Repair Man (refactoring) e TabNanny (verificação de indentações). O autor dos bindings python para o Qt4, lançou um instalador para windows que contém as bibliotecas e os programas de desenvolvimento do Qt4, o pyqwt e o Eric4, o que facilita bastante a instalação no windows. Segue o link para o instalador: http://www.riverbankcomputing.com/Downloads/PyQt4/GPL/. +É um IDE desenvolvido com PyGTK e visa a integração com o Vim. Oferece recursos como project management, source code management, code browser, code refactor, profiler, debugger entre outros. -### Boa-Constructor - http://boa-constructor.sf.net -Essa é a "única" IDE ao estilo RAD do Delphi/VB. Funciona com o wxPython na versão 2.4 e é acho que é a mais fácil de ser usada apesar de não promover boas práticas de desenvolvimento como a de separar lógica de negócios de apresentação (telas). As outras IDEs não possuem mecanismos para desenho de telas gráficas mas podem usar ferramentas como Glade e/ou wxGlade. +### [Eric4](https://eric-ide.python-projects.org/) -### Eclipse - http://www.eclipse.org -Diferente de todos os outros. Pesado, grande, monstruoso mas muito poderoso. É feito em Java e é ideal para desenvolvimento Java. Mas existem plugins para se desenvolver em Python com ele (e detalhe: atualmente é um brasileiro quem o mantém) que é o ppydev: http://pydev.sourceforge.net/ +É feito com a biblioteca QT e se integra às ferramentas da QT e com outros softwares como o Bicycle Repair Man (refactoring) e TabNanny (verificação de indentações). O autor dos bindings python para o Qt4, lançou um instalador para Windows que contém as bibliotecas e os programas de desenvolvimento do Qt4, o pyqwt e o Eric4, o que facilita bastante a instalação no Windows. -### EasyEclipse - http://www.easyeclipse.org/site/distributions/python.html +### [Boa-Constructor](http://boa-constructor.sf.net) + +Essa é a "única" IDE ao estilo RAD do Delphi/VB. Funciona com o wxPython na versão 2.4 e acho que é a mais fácil de ser usada apesar de não promover boas práticas de desenvolvimento como a de separar lógica de negócios de apresentação (telas). As outras IDEs não possuem mecanismos para desenho de telas gráficas mas podem usar ferramentas como Glade e/ou wxGlade. + +### [Eclipse](http://www.eclipse.org) + +Diferente de todos os outros. Pesado, grande, monstruoso mas muito poderoso. É feito em Java e é ideal para desenvolvimento Java. Mas existem plugins para se desenvolver em Python com ele (e detalhe: atualmente é um brasileiro quem o mantém) que é o [ppydev](http://pydev.sourceforge.net/). + +### [EasyEclipse](http://easyeclipse.org/site-1.0.2/distributions/python.html) + +EasyEclipse é open source e hospedado pela Sourceforge que fornece muitas distribuições empacotadas do Eclipse pré-configuradas com plug-ins para Python, Ruby, etc. + +### [DrPython](http://drpython.sourceforge.net/) -### DrPython - http://drpython.sourceforge.net/ Usa wxPython. Criado para ser utilizado em escolas. -### IPython - http://ipython.scipy.org/ -Um shell com muitos recursos, através das comandos "magicos". Bastante util, modo texto apenas. Você pode usa-lo como um shell "acoplado" aos seus programas também. +### [IPython](https://ipython.org/) + +Um shell com muitos recursos, através das comandos "mágicos". Bastante útil, modo texto apenas. Você pode usá-lo como um shell "acoplado" aos seus programas também. + +### [KDevelop](http://www.kdevelop.org/) -### KDevelop - http://www.kdevelop.org/ IDE livre para GNU/Linux e outros *nixes-like. -### PythonWin - http://pywin32.sf.net/ +### [PythonWin](http://pywin32.sf.net/) + IDE que acompanha as extensões Win32 para Python (PyWin32). Oferece auto-completion e debugging, e tem recursos extras voltados à programação Windows (coletor de exceções para componentes COM criados, COM browser, geração de arquivos .py com informações sobre objetos COM (static dispatch), etc.). -### PythonCard - http://pythoncard.sourceforge.net +### [PythonCard](http://pythoncard.sourceforge.net) + É uma GUI para construção de aplicações multiplataforma em Windows, Mac OS X e Linux, usando a linguagem de programação Python. O lema de PythonCard é "coisas simples devem ser simples de fazer e coisas complexas devem devem ser possiveis". É a ferramenta para quem deseja desenvolver aplicações gráficas de maneira rápida e fácil, com um mínimo de esforço e codificação; simples mas poderoso. Utiliza a biblioteca wxPython, mas separa a lógica do código da apresentação utilizando um tipo de arquivo de definição de recursos. (RômuloCampelo - 08/04/2005) -### TruStudio - http://trustudio.unipro.ru e http://sourceforge.net/projects/trustudio -Esta IDE é um plugin para o Eclipse (mais informações sobre este acima), tornando o suporte a PHP e Python bem mais completo e poderoso. +### [PyScripter](https://sourceforge.net/projects/pyscripter/) -### PyScripter - http://mmm-experts.com/Downloads.aspx?ProductId=3 -Acompanha o conjunto de componentes python para Delphi (embora não requira que o Delphi esteja instalado para funcionar). Suporta debugging, auto-completion, navegação no código entre outros recursos. Na versão atual (3.31) o instalador parece ter um problema pois abre a IDE durante a instalação, diz que não pôde localizá-la e não cria um atalho, porém você pode criar um a partir do pasta onde foi instalada (geralmente C:\Arquivos de Programas\PythonForDelphi). +Acompanha o conjunto de componentes python para Delphi (embora não requira que o Delphi esteja instalado para funcionar). Suporta debugging, auto-completion, navegação no código entre outros recursos. -### PyPE - http://pype.sourceforge.net/index.shtml -Não se trata de um IDE propriamente dito, mas é um editor Python, leve, funcional e rico em recursos interessantes e multiplataforma. Além disso, é desenvolvido utilizando wxPython. +### [PyPE](http://pype.sourceforge.net/index.shtml) -### Rodeo - https://www.yhat.com/products/rodeo -Rodeo é uma IDE leve e intuitiva voltado para análise de dados. Com -suporte a Jupyter Notebook, navegador de arquivos, busca de packages e -visualização de gráficos, além de suporte a comandos VIM. +Não se trata de uma IDE propriamente dita, mas é um editor Python, leve, funcional e rico em recursos interessantes e multiplataforma. Além disso, é desenvolvido utilizando wxPython. + +### [Rodeo](https://rodeo.yhat.com/) + +Rodeo é uma IDE leve e intuitiva voltada para análise de dados. Com suporte a Jupyter Notebook, navegador de arquivos, busca de packages e visualização de gráficos, além de suporte a comandos VIM. # IDEs (pagas) -Wing - http://www.wingware.com - Das IDEs proprietárias essa é uma das que mais gosto ( OsvaldoSantanaNeto ). A empresa wingware recentemente lançou o wingide101 para auxiliar no ensino de python e é uma versão com menos recursos que as versões professional e personal, mas que tem funcionalidades interessantes, como depurador gráfico, shell interativo. Segue o link: http://wingware.com/wingide-101/index -### Komodo - http://www.activestate.com +### [Wing](http://www.wingware.com) + +A empresa wingware recentemente lançou o wingide101 para auxiliar no ensino de Python e é uma versão com menos recursos que as versões professional e personal, mas que tem funcionalidades interessantes, como depurador gráfico, shell interativo. Segue o link: http://wingware.com/wingide-101/index + +### [Komodo](http://www.activestate.com) + Essa é outra IDE bem poderosa também. Trabalha com outras linguagens além de Python e roda em Linux e Windows. Existe uma licença gratuita que pode ser usada para aprendizado. -### PyCharm - http://www.jetbrains.com/pycharm/ -Possui um conjunto de ferramentas úteis para um desenvolvimento produtivo. Além disso, o IDE fornece capacidades de alta classe para o desenvolvimento Web profissional com framework Django e Flask, Google AppEngine. Possui suporte a diversos sistemas de controle de versão, integração com Github e atraves de plugin, com o Heroku. Possui gerador de Diagramas de Classe e ORM. Suporte para interpretador Python remoto. Criação de gerencia de ambientes (virtualenv). Mais informações sobre funcionalidades e desenvolvimento do PyCharm veja http://confluence.jetbrains.net/display/PYH/PyCharm+IDE+and+Python+Plugin+for+IntelliJ+IDEA +### [PyCharm](http://www.jetbrains.com/pycharm/) -### BlackAdder - http://www.thekompany.com/products/blackadder/ -Feita pelo pessoal que desenvolve o KDE. +Possui um conjunto de ferramentas úteis para um desenvolvimento produtivo. Além disso, a IDE fornece capacidades de alta classe para o desenvolvimento Web profissional com framework Django e Flask, Google AppEngine. Possui suporte a diversos sistemas de controle de versão, integração com Github e atraves de plugin, com o Heroku. Possui gerador de Diagramas de Classe e ORM. Suporte para interpretador Python remoto. Criação de gerência de ambientes (virtualenv). Mais informações sobre funcionalidades e desenvolvimento do PyCharm veja http://confluence.jetbrains.net/display/PYH/PyCharm+IDE+and+Python+Plugin+for+IntelliJ+IDEA -### Visual Studio 2010+ - http://ironpython.net/ -IDE completo para o mundo .NET que com o IronPython se torna um excelente IDE. +### [Visual Studio 2010+](http://ironpython.net/) +IDE completa para o mundo .NET que com o IronPython se torna uma excelente IDE. # Refactoring -### Bycicle Repair Man - http://bicyclerepair.sourceforge.net/ -Automatiza algumas operações básicas de refactoring para Python. Tem integração com vários editores, como o PyDev e o Emacs. - -### Rope - https://github.com/python-rope/rope -Uma biblioteca de refactoring para Python. Pode ser usada em outras IDEs. +### [Bycicle Repair Man](http://bicyclerepair.sourceforge.net/) +Automatiza algumas operações básicas de refactoring para Python. Tem integração com vários editores, como o PyDev e o Emacs. +### [Rope](https://github.com/python-rope/rope) +Uma biblioteca de refactoring para Python. Pode ser usada em outras IDEs. -*Boa parte do conteúdo foi retirado do link (http://wiki.python.org.br/IdesPython) +*Boa parte deste conteúdo foi retirado do link (http://wiki.python.org.br/IdesPython) diff --git a/content/pages/games.md b/content/pages/games.md index 014860c4..89b6b5d9 100644 --- a/content/pages/games.md +++ b/content/pages/games.md @@ -4,6 +4,20 @@ Template: page Confira as ferramentas e conteúdo sobre desenvolvimento de games com python: -## Ferramentas +## Pygame -## Conteúdo +[Pygame](https://www.pygame.org/) é uma biblioteca usada na criação de aplicações multimídia como jogos. +Ela é uma camada de abstração construída sobre a biblioteca [SDL](http://www.libsdl.org/), e assim como a SDL ela é altamente portável e roda em praticamente todas plataformas e sistemas operacionais. + +### Cursos e Tutoriais + +- [Desbravando o pygame](https://humberto.io/pt-br/tags/pygame/): Série de postagens introduzindo o desenvolvimento de jogos com pygame por [Humberto Rocha](https://humberto.io/blog/). + +### Documentação + +- [Documentação oficial em inglês](https://www.pygame.org/docs/): Esta é a documentação oficial da biblioteca, infelizmente somente em inglês. + +## Pyxel + +[Pyxel](https://github.com/kitao/pyxel) é uma engine para desenvolvimentos de jogos retro seguindo as limitações dos consoles fictícios [PICO-8](https://www.lexaloffle.com/pico-8.php) e [TIC-80](https://tic.computer/). +Ela vem com um editor embutido para criação de sprites, tilemaps e efeitos sonoros. diff --git a/content/pages/gruposonline.md b/content/pages/gruposonline.md new file mode 100644 index 00000000..e18995c4 --- /dev/null +++ b/content/pages/gruposonline.md @@ -0,0 +1,29 @@ +Title: Grupos de discussão online +Slug: gruposonline +Template: page + + +Estes grupos não são organizados pelo [Associação Python Brasil](https://apyb.python.org.br/). +Os grupos listados abaixo são gerenciados e mantidos por iniciativas independentes da comunidade Python. + +Sites listados apenas para facilitar serem encontrados. + + +## Telegram + +- [Python Brasil - Roda de Conversa](https://t.me/pythonbr) +- [Data Science Python](https://t.me/datasciencepython) +- [Django Brasil](https://t.me/djangobrasil) +- [Flask Brasil](https://t.me/flaskbrasil) +- [Tradução da documentação da documentação do Python e correlatas](https://t.me/pybr_i18n) +- [FastAPI Brasil](https://t.me/fastapibr) +- [Live de Python - Dunossauro](https://t.me/livepython) + +Diversos grupos e comunidades locais também organizam seus próprios grupos no Telegram. +[Lista completa das comunidades locais](/comunidades-locais) + +## Discord + +- [Python Brasil](https://discord.gg/TuENdUjwQX) + +Caso você queira adicionar seu grupo Telegram ou servidor Discord, [faça um pull request no repositório desta wiki](https://github.com/pythonbrasil/wiki/). Lembre-se que ela deve ser sobre o ecossistema Python. diff --git a/content/pages/home.md b/content/pages/home.md index c3ccb515..d79a6531 100644 --- a/content/pages/home.md +++ b/content/pages/home.md @@ -1,3 +1,4 @@ Title: Home Slug: index Template: home +save_as: index.html diff --git a/content/pages/instalacao-linux.md b/content/pages/instalacao-linux.md index 54ebd862..6d9f5fc1 100644 --- a/content/pages/instalacao-linux.md +++ b/content/pages/instalacao-linux.md @@ -2,49 +2,63 @@ Title: Instalando o Python no Linux Slug: instalacao-linux Template: page -## Verifique se já tem o Python instalado +Os sistemas GNU/Linux mais recentes ja possuem uma versão do Python instalada junto com o sistema operacional. Podemos checar com o seguinte comando: -Se você usa GNU/Linux, provavelmente já possui alguma versão do Python instalada por padrão. Para conferir, digite em um terminal: - - $ which python + $ which python3 + /usr/bin/python3 -ou +que nos mostra onde o Python padrão do sistema operacional está instalado. - $ which python3 +A versão do Python na distribuição Linux Ubuntu 22.04.2 LTS é a 3.10. -que deve retornar algo como `/usr/bin/python`. Isso significa que o Python está instalado nesse endereço. + $ python3 --version + Python 3.10.6 -Caso contrário, se retornar algo como `which: no python in (/usr/local/sbin:/usr/local/bin:/usr/bin:/usr...)` você precisa instalar pelos repositórios ou gerenciador de pacotes de sua distribuição. +Para evitar conflitos com o Python do sistema operacional, sugere-se a instalação de um outro interpretador, que pode ser feita de 2 formas diferentes: através do de gerenciador de pacotes ou de repositórios. -## Instalação por Gerenciadores de Pacotes +## Instalação por gerenciadores de pacotes -Os gerenciadores de pacotes mais comuns são apt-get (Debian, Ubuntu) e yum +Os gerenciadores de pacotes mais comuns são `apt-get` (Debian, Ubuntu) e `yum` (RedHat, CentOS). Caso sua distribuição utilize um gerenciador de pacotes diferente, acesse a [página de downloads do Python](https://www.python.org/downloads/). -### Apt-get +### Debian e Ubuntu + +Através do gerenciador de pacotes, é possível instalar versões específicas do Python. +No exemplo abaixo, é instalada a versão, por exemplo, 3.9 do Python + + sudo apt-get install python3.9 -Para instalar o Python 2.7, digite em um terminal: +É possível instalar qualquer outra versão: `python3.8`, `python3.9`, `python.10` + +Desta forma, a instalação desta versão específica do Python acima difere da versão padrão do sistema operacional. + + $ which python3.9 + /usr/bin/python3.9 + + $ which python3 + /usr/bin/python3 - $ sudo apt-get install python2.7 +### RedHat e CentOS -Para instalar o Python 3.5, digite em um terminal: +Assim como no tópico anterior, é possível instalar versões específicas do Python. +No comando abaixo, é instalada a versão, por exemplo, 3.9 do Python. - $ sudo apt-get install python3.5 + sudo yum install python3.9 -(Opcional) Para instalar o gerenciador de pacotes pip, digite em um terminal: +## Instalação por repositório - $ sudo apt-get install python-pip +Os repositórios no GNU/Linux são chamados de PPAs (do inglês Personal Package Archives). -### Yum +Para adicionar repositórios ao nosso sistema, precisamos de um software chamado `software-properties-common`, que pode ser instalado com o comando abaixo: -Para instalar o Python 2.7, digite em um terminal: + sudo apt-get install software-properties-common - $ sudo yum install python27 +Habilitada a adição de repositórios ao nosso sitema operacional, podemos agora incluir o repositório que contém o Python. Este repositório é chamado de deadsnakes, cuja página oficial pode ser encontrada neste [link](https://launchpad.net/~deadsnakes/+archive/ubuntu/ppa). -Para instalar o Python 3.5, digite em um terminal: + sudo add-apt-repository ppa:deadsnakes/ppa - $ sudo yum install python35 +Agora a instalação do Python pode ser feita a partir deste repositório com o comando -(Opcional) Para instalar o gerenciador de pacotes pip, digite em um terminal: + sudo apt-get install python3.9 - $ yum -y install python-pip +Da mesma forma, é possível instalar várias versões. Observem que a versão python correspondente à do sistema operacional padrão não está disponível no repositório deadsnakes. diff --git a/content/pages/instalacao-mac.md b/content/pages/instalacao-mac.md index 31a20880..fe34b852 100644 --- a/content/pages/instalacao-mac.md +++ b/content/pages/instalacao-mac.md @@ -2,9 +2,7 @@ Title: Instalando o Python no Mac OS X Slug: instalacao-mac Template: page -## Verifique se já tem o Python instalado - -Se você usa macOS 10.2 ou superior, provavelmente já possui alguma versão do Python instalada por padrão. Para conferir, digite em um terminal: +Verifique se já tem o Python instalado, se você usa macOS 10.2 ou superior, provavelmente já possui alguma versão do Python instalada por padrão. Para conferir, digite em um terminal: $ which python diff --git a/content/pages/instalacao-windows.md b/content/pages/instalacao-windows.md old mode 100644 new mode 100755 index 25568182..87ae6f90 --- a/content/pages/instalacao-windows.md +++ b/content/pages/instalacao-windows.md @@ -1,7 +1,61 @@ -Title: Instalando o Python no Windows +Title: Instalando o Python 3 no Windows Slug: instalacao-windows Template: page -Para instalar o Python em Windows, baixe o instalador do site oficial [neste link](https://www.python.org/downloads/). **Dê preferência ao Python 3**, já que a versão 2.x é mantida por compatibilidade com códigos antigos e será descontinuada em 2020. +Para instalar o Python no seu sistema operacional Windows, você precisa baixar o instalador. Acesse o site oficial [neste link](https://www.python.org/downloads/) e clique em download, como mostrado abaixo. -**Importante:** Certifique-se de selecionar a opção "Adicionar python.exe ao Path" na etapa de Personalização da instalação. Isso garante que ao digitar "python" no prompt de comando, o Windows consiga encontrar o executável do programa e/ou iniciar no modo interativo pelo `cmd`. + + +Isso fará o download do Python 3 para sitemas 64 bits. Para o instalador de 32 bits, acesse [](https://www.python.org/downloads/windows/) e selecione o instalador de 32 bits apropriado, como mostrado abaixo. + + + +Faça o download do instalador executável do Windows (32 ou 64 bits) e clique duas vezes nele para iniciar o assistente de instalação do python, como mostrado abaixo. + + + +O processo de instalação é bem simples. + +1. Marque a opção "Add Python to PATH" +2. Clique em "Install Now" + +A tela abaixo será mostrada. Aguarde enquanto o instalador completa o processo de instalação. + + + +Se tudo ocorrer bem, a próxima tela será mostrada. Clique em "Close". + + + +Para verificar se a instalação do Python foi bem-sucedida, pesquise no menu iniciar por "cmd" e clique duas vezes para abri-lo. + + + +Digite o seguinte comando: + $ python --version + Python 3.11.3 + +Este comando retornará a versão do python que está instalada em sua máquina. Agora digite: + + $ pip --version + pip 22.3.1 from C:\Users\...\AppData\Local\Programs\Python\Python311\Lib\site-packages\pip (python 3.11) + +Esse comando retornará a versão do pip que está instalada em sua máquina. O pip é o gerenciador de pacote do Python. Com ele você poderá adicionar novas funcionalidades ao seu Python. + +## IDLE + +O IDLE (Ambiente de Desenvolvimento e Aprendizagem Integrado) é um ambiente de desenvolvimento integrado (IDE) para Python. O instalador do Python para Windows contém o módulo IDLE por padrão. + +O IDLE pode ser usado para executar uma única instrução, como o Python Shell, e também para criar, modificar e executar scripts Python. O IDLE fornece um editor de texto completo para criar scripts Python que incluem recursos como destaque de sintaxe, preenchimento automático e recuo inteligente. Ele também possui um depurador com recursos de etapas e pontos de interrupção. + +Para iniciar o shell interativo IDLE, procure o ícone IDLE no menu Iniciar e clique duas vezes nele. + + + +Isso abrirá o IDLE, onde você pode escrever o código Python e executá-lo como mostrado abaixo. + + + +Parabéns, agora o Python, o pip e o Idle já estão instalados em seu sistema Windows. + +Happy Hacking! ^-^ diff --git a/content/pages/introducao.md b/content/pages/introducao.md index 884f7ed8..cf0e8b0b 100644 --- a/content/pages/introducao.md +++ b/content/pages/introducao.md @@ -2,11 +2,53 @@ Title: Python para quem está começando Slug: introducao Template: page -Não sabe por onde começar? Veja nossa listagem de conteúdo para quem está começando na linguagem: +Python é uma linguagem poderosa e divertida. Com ela você pode fazer diversas coisas como: + +* Construção de sistemas Web com Django, Flask, Pyramid, etc; +* Análise de dados, Inteligência Artificial, Machine Learning e etc com Numpy, Pandas, Matplotlib, etc; +* Construção de aplicativos com Kivy e Pybee; +* Construção de sistemas desktop com Tkinter, WxPython, etc. + +Existem diversos cursos onlines onde você pode encontrar material. São cursos +que você consegue aprender o básico da programação com Python, como tipos de +variáveis, como escrever funções, etc. + +**Devo usar o Interpretador do Python puro?** +Depende da sua preferência. Ele é uma ferramenta poderosa, mas boa parte de +profissionais usa o interpretador [*ipython*](http://ipython.org/). Pois, este +contém mais recursos visuais e de auxílio (como colorir as mensagens de erro). + +**Que IDE usar?** +Depende muito da sua preferência. Você pode usar qualquer editor de texto puro, como o [Notepad++](https://notepad-plus-plus.org/), +[gedit](https://help.gnome.org/users/gedit/stable/index.html.pt_BR) ou [Sublime](http://sublimetext.com/) e até editores orientados para +a linha de comando, como o [Nano](https://www.nano-editor.org/). Ou editores com recursos de depuração, execução de tarefas e controle +de versão, como o [VS Code](https://code.visualstudio.com/) ou sua versão sem telemetria e rastreamento, o [VSCodium](https://vscodium.com/). +Não existe padrão. +Para quem vem do MATLAB ou R, o [Spyder](https://www.spyder-ide.org/) pode ser muito útil. O [Pycharm](https://www.jetbrains.com/pycharm/) é outro IDE muito utilizado na comunidade e traz consigo muitas funções úteis para iniciantes e profissionais. +**Aonde eu encontro os módulos para utilizar no meu projeto?** +Alguns módulos já vem por padrão no Python puro, por exemplo o módulo matemático +(math). Outros, devem ser baixados de um repositório, como é o caso do Django ou +Numpy. Hoje, mais de 207 mil projetos estão cadastrados no +[repositório oficial](https://pypi.org/). Caso você não ache o que procura, há +muito incentivo para que você construa um novo módulo e inclua no repositório! + +Se você não tem a menor ideia de que módulo você precise, dê uma procurada no +Google e StackOverflow. De certo, alguém já fez algo parecido com o que você +precisa! + +**O que são ambientes virtuais?** +O ideal para projetos Python é que você isole as bibliotecas que você usa, para evitar conflitos entre projetos. +Isso é uma boa prática e pode evitar dores de cabeça futuras. [Dê uma lida](https://docs.python.org/pt-br/3/library/venv.html) sobre antes de iniciar um projeto, ok? + +**Indicação de material de estudo** + +Não sabe por onde começar? Veja nossa listagem de conteúdo para quem está começando na linguagem: -| Ano | Título | Autor | Tipo | Nível | Grátis? | Link | -|------|------------------------------------------------|---------------------------|-------|-----------|---------|---------------------------------------------------------------------------------------------| -| 2003 | Python para Zumbis | Fernando Massanori | Curso | Iniciante | Sim | [link](http://pycursos.com/python-para-zumbis/) | -| 2014 | Introdução à Programação com Python | Nilo Ney Coutinho Menezes | Livro | Iniciante | Não | [link](http://python.nilo.pro.br/) | -| 2015 | Curso de Programação em Python para Iniciantes | PyLadies BH | Curso | Iniciante | Sim | [link](https://www.youtube.com/watch?v=O2xKiMl-d7Y&list=PL70CUfm2J_8SXFHovpVUbq8lB2JSuUXgk) | + Ano | Título | Autor | Tipo | Nível | Grátis? | Link +-----|--------|-------|------|-------|---------|------ + 2024 | Introdução à Programação com Python (4ª edição) | Nilo Ney Coutinho Menezes | Livro | Iniciante | Não | [link](http://python.nilo.pro.br/) + 2021 | Curso para acesso ao mercado Python de Tecnologia | Renzo Nuccitelli | Curso | Intermediario | Não | [link](https://www.python.pro.br/) + 2017 | Pycubator (Tradução PT-BR) | Noam Elfanbaum, Udi Oron e Gilson Filho (Tradução) | Material online | Iniciante | Sim | [link](http://df.python.org.br/pycubator/) + 2016 | Python Básico | Solyd/Guilherme Junqueira | Curso | Iniciante | Sim | [link](https://solyd.com.br/treinamentos/python-basico) + 2015 | Curso de Programação em Python para Iniciantes | PyLadies BH | Curso | Iniciante | Sim | [link](https://www.youtube.com/watch?v=O2xKiMl-d7Y&list=PL70CUfm2J_8SXFHovpVUbq8lB2JSuUXgk) diff --git a/content/pages/mobile.md b/content/pages/mobile.md index a6dcf215..5617386a 100644 --- a/content/pages/mobile.md +++ b/content/pages/mobile.md @@ -4,6 +4,10 @@ Template: page Encontre aqui referências de aprendizado em programação mobile com python: -## Ferramentas +## Kivy -## Conteúdo +[Kivy](https://kivy.org/#home) é uma biblioteca para o desenvolvimento de software com código-fonte aberto, voltado ao rápido desenvolvimento de aplicações que utilizam novas interfaces de usuário, e projetada para também ser utilizada na como aplicações que serão executadas em dispositivos multi-touch. + +#### Documentação + +- [Documentação Oficial da Biblioteca Kivy em Português](http://excript.com/downloads/kivy-pt_br-excript.pdf) diff --git a/content/pages/patrocinio.md b/content/pages/patrocinio.md deleted file mode 100644 index f2e79aa9..00000000 --- a/content/pages/patrocinio.md +++ /dev/null @@ -1,5 +0,0 @@ -Title: Patrocinio -Slug: patrocinio -Template: page - -Página reservada para o branding dos patrocinadores da APyB. diff --git a/content/pages/premio-dorneles-tremea-jean-ferri.md b/content/pages/premio-dorneles-tremea-jean-ferri.md new file mode 100644 index 00000000..1a820f92 --- /dev/null +++ b/content/pages/premio-dorneles-tremea-jean-ferri.md @@ -0,0 +1,4 @@ +Title: Prêmio Dorneles Treméa|Jean Ferri +Slug: premio-dorneles-tremea-jean-ferri +Template: redirect +Redirect: https://apyb.python.org.br/apyb/premio-dorneles-tremea-jean-ferri/ \ No newline at end of file diff --git a/content/pages/premio-dorneles-tremea.md b/content/pages/premio-dorneles-tremea.md index 74b3eadc..d11dceb6 100644 --- a/content/pages/premio-dorneles-tremea.md +++ b/content/pages/premio-dorneles-tremea.md @@ -1,72 +1,4 @@ -Title: Prêmio Dorneles Treméa +Title: Prêmio Dorneles Treméa|Jean Ferri Slug: premio-dorneles-tremea -Template: page - -**O Prêmio Dorneles Treméa é concedido ao membro, ou membros, da comunidade Python brasileira que mantém vivo o espírito de colaboração, empreendedorismo e entrega à comunidade.** - -## O Prêmio -Criado em 2011 pela Associação Python Brasil, o Prêmio Dorneles Treméa é um momento para a comunidade Python brasileira lembrar e homenagear anualmente a(s) pessoa(s) que mais se destacou(aram) e contribuíu(íram) para manter vivo o espírito de colaboração, empreendedorismo e entrega à comunidade que eram características marcantes do Dorneles Treméa. - -### Critérios utilizados -O prêmio é dedicado àquelas que, durante os últimos doze meses, dedicaram-se a: - -- Divulgar e ensinar Python -- Participar ativamente das comunidades locais -- Participar ativamente das comunidades online - -E estão excluídos da seleção: - -- Presidente da gestão atual da APyB -- Big Kahuna e organizadores da Python Brasil -- Homenageados em anos anteriores - -### Cerimônia de entrega -A entrega do Prêmio Dorneles Treméa é realizada anualmente durante a PythonBrasil. - -## Homenageados - -**2011 - PythonBrasil 7 (São Paulo)** - - * Luciano Ramalho - * Rodrigo Senra - - - -**2012 - PythonBrasil 8 (Rio de Janeiro)** - - * Érico Andrei - * Marcel Caraciolo - -**2013 - PythonBrasil 9 (Brasília)** - - * Fernando Massanori - * Henrique Bastos - -**2014 - PythonBrasil 10 (Porto de Galinhas)** - - * Osvaldo Santana - -**2015 - PythonBrasil 11 (São José dos Campos)** - - * Tânia Andrea - -**2016 - PythonBrasil 12 (Florianópolis)** - - * Paula Grangeiro - -## Sobre Dorneles Treméa - -Gaúcho, colorado, amante de sushi e de suco de maçã, empreendedor, líder de comunidades OSS, desenvolvedor, empreendedor, marido e pai de duas gurias. - -Déo, como os mais próximos o chamavam, foi fundador da Debian-RS, da Associação Python Brasil, membro da Plone Foundation, Big Kahuna da PythonBrasil[5] e palestrante constante. - -Era o presidente da Associação Python Brasil, quando faleceu em um acidente de carro em 10 de fevereiro de 2011 - na época, com 31 anos. - -Sempre disposto a ajudar, ele será sempre lembrado por sua disposição de compartilhar conhecimento. Seu legado é o espírito de entrega e dedicação que norteia a existência da Associação Python Brasil. - -Leia mais sobre Dorneles Treméa em posts e imagens feitos publicados por seus amigos: - -* [Sidnei da Silva](http://blog.sidneidasilva.com/2011/02/14/unfinished-life-of-a-sushi-lover/) -* [Luciano Ramalho](http://blog.ramgarlic.com/2011/06/dorneles-tremea-o-grande-deo.html) -* [Érico Andrei](http://www.erico.com.br/blog/2011/06/18/no-sleep-for-you) -* [Nate Aune](https://www.flickr.com/photos/natea/sets/72157625894791457/) +Template: redirect +Redirect: https://apyb.python.org.br/apyb/premio-dorneles-tremea-jean-ferri/ \ No newline at end of file diff --git a/content/pages/projetos.md b/content/pages/projetos.md new file mode 100644 index 00000000..36c222ad --- /dev/null +++ b/content/pages/projetos.md @@ -0,0 +1,24 @@ +Title: Projetos brasileiros com Python +Slug: projetos +Template: page + +Diversos projetos de Python e outras linguagens estão disponíveis [neste post](https://medium.com/nossa-coletividad/projetos-brasileiros-para-fazer-pull-requests-nesse-hacktoberfest-4dc9b9b576c0)! + +Alguns projetos brasileiros que usam python: + +- [Site Pyladies Brasil](https://github.com/pyladies-brazil/br-pyladies-pelican) +- [Import caipyra](https://github.com/jtemporal/caipyra) +- [Algpedia](https://github.com/thaisviana/algpedia) +- [Bottery](https://github.com/rougeth/bottery) +- [Speakerfight](https://github.com/luanfonceca/speakerfight) +- [Tapioca-Jarbas](https://github.com/daneoshiga/tapioca-jarbas) +- [python-simple-rest-client](https://github.com/allisson/python-simple-rest-client) +- [jinja-assets-compressor](https://github.com/jaysonsantos/jinja-assets-compressor) +- [python-binary-memcached](https://github.com/jaysonsantos/python-binary-memcached) +- [correios](https://github.com/olist/correios) +- [simple-model](https://github.com/lamenezes/simple-model) +- [python-ami](https://github.com/ettoreleandrotognoli/python-ami/) +- [python-cdi](https://github.com/ettoreleandrotognoli/python-cdi) +- [django-pycdi](https://github.com/ettoreleandrotognoli/django-pycdi) +- [revelation](https://github.com/humrochagf/revelation) +- [BotCity Framework Core](https://github.com/botcity-dev/botcity-framework-core-python) diff --git a/content/pages/python-brasil.md b/content/pages/python-brasil.md index c272cce0..06b8b9aa 100644 --- a/content/pages/python-brasil.md +++ b/content/pages/python-brasil.md @@ -1,103 +1,5 @@ Title: Python Brasil Slug: python-brasil -Template: page - -## O que é a Python Brasil? - -**Python Brasil** é uma conferência vibrante de Python que estimula a comunidade, o debate, propicia negócios, motiva e **conecta pessoas**. - -É uma conferência sem fins lucrativos mantida por voluntários com o suporte da Associação Python Brasil (APyB) e a Python Software Foundation (PSF). - -## Audiência - -Desenvolvedores de software freelancers, de startups e grandes empresas, ativistas, hackers, geeks, administradores de sistemas, empreendedores, executivos, gerentes, educadores, cientistas e estudantes. - -## Quem já palestrou nas Python Brasil? - -- Alan Runyan, Plone co-founder and Enfold president -- Alexander Limi, Firefox UX Lead at Mozilla -- Bruce Eckel, Thinking in Java and Thinking in C++ author -- Collin Winter, Google -- Dorneles Tremea, Plone developer -- Facundo Batista, Canonical technical lead -- Gustavo Niemeyer, Canonical technical lead -- Jacob Kaplan-Moss, Django co-founder -- Jim Fulton, Zope Corp. -- Kenneth Rohde Christiansen, CTO INdT -- Maciej Fijalkowski, PyPy core developer -- Steve Holden, Python Software Foundation chair -- Wesley Chun, Google developer advocate -- Paul Everitt, Plone core developer and Pyramid core developer -- Paul Hildebrandt, Senior Engineer at Walt Disney Studios -- Daniel Greenfeld and Audrey Roy, Two Scoops of Django authors -- Fernando Perez, Creator of IPython Notebook -- José Valim, Creator of Elixir programming language -- Lynn Root, Software developer of Spotify and Pyladies SF founder -- Alex Gaynor, Software engineer of OpenStack -- Bryan Van de Ven, software engineer at Continuum Analytics, and is the project lead for the Open Source Bokeh visualization system. -- David Beasley, Author of the Python Essential Reference and Python Cookbook. -- Naomi Ceder, Author of Quick Python and PSF Board member. - -## Perguntas frequentes - -**Hangout com os antigos organizadores das Python Brasil ao longo dos anos falando sobre a conferência. O assunto pricipal é sobre a Python Brasil 11 [2015], em São José dos Campos.** - - - -- O que são Tutoriais? -- O que são Palestras? -- O que é Sprint? -- Palestrante tem desconto? -- Estudante tem desconto? -- Mulher tem desconto? -- Por que ingresso para empresa e setor público é mais caro? -- O que são Lightalks? Qualquer um pode fazer? -- Como organizar uma Python Brasil? -- Como ser o próximo Big Kahuna? -- Dicas como lidar com burocracia na organização de uma PythonBrasil? -- Qual é o maior desafio de organizar uma PythonBrasil? -- É possível participar dos tutoriais e não das palestras, e vice-versa? -- Como funciona a área open space? (horário de funcionamento, como participar e duração de cada atividade) -- A Python Brasil é aberta para pessoas iniciantes ou que venham de outras linguagens como Ruby por exemplo? -- Dicas de hotéis próximos -- Como chegar ao local do evento pra quem não entende nada de SP :) -- Por que patrocínios com brindes e sorteios não são aceitos? -- [Código de Conduta APyB](https://github.com/pythonbrasil/codigo-de-conduta), um overview sobre o que é, para que server e onde se aplica dentro da PythonBrasil[11] -- [Propostals para Plone Conference](https://plone.org/events/conferences/plone-conference-2016/2016-call-for-proposals) -- [Mapa da Python Brasil](https://mapa-pybr11.herokuapp.com/) -- [Prêmio Dorneles Trémea](https://www.youtube.com/watch?v=SlmB-g7uJdo) - -## Histórico das Python Brasil - -Em todas as edições da PythonBrasil uma pessoa da comunidade fica responsável por coordenar e gerenciar todos os envolvidos na organização do evento. - -Essa pessoa recebe, por razões históricas (consulte o Rodrigo Senra para maiores detalhes), o título de ‘Big Kahuna’. O ‘Big Kahuna’ é o grande chefe, o maestro da organização, se ele trabalha bem o evento é um sucesso, se ele não trabalha bem o evento não sairá direito. - -Todavia, em todas as edições, o evento é fruto do trabalho de diversas pessoas, e é responsabilidade de todos o sucesso da empreitada. - -- 2005 - [São Paulo - Campinas - Centro de Computação da Unicamp](https://manual-do-big-kahuna.readthedocs.org/en/latest/historia/pyconbrasil.html) - Rodrigo Senra -- 2006 - [Distrito Federal - Brasília - Interlegis](https://manual-do-big-kahuna.readthedocs.org/en/latest/historia/pyconbrasil2.html) - Jean Rodrigo Ferri -- 2007 - [Santa Catarina - Joinville - SOCIESC](https://manual-do-big-kahuna.readthedocs.org/en/latest/historia/pyconbrasil3.html) - Marco André Lopes -- 2008 - [Rio de Janeiro - UVA](https://manual-do-big-kahuna.readthedocs.org/en/latest/historia/pyconbrasil2008.html) - Luis Gustavo Neves -- 2009 - [Rio Grande do Sul - Caxias do Sul - UCS](https://manual-do-big-kahuna.readthedocs.org/en/latest/historia/pythonbrasil5.html) - Dorneles Treméa -- 2010 - [Paraná - Curitiba - UFPR](https://manual-do-big-kahuna.readthedocs.org/en/latest/historia/pythonbrasil6.html) - Ramiro Batista Luz -- 2011 - [São Paulo - AMCHAM Business Center](https://manual-do-big-kahuna.readthedocs.org/en/latest/historia/pythonbrasil7.html) - Érico Andrei -- 2012 - [Rio de Janeiro - Cidade Nova - Centro de convenções SulAmérica](https://manual-do-big-kahuna.readthedocs.io/en/latest/historia/pythonbrasil8.html) - Tatiana Al-Chueyr e Álvaro Justen -- 2013 - [Distrito Federal - Brasília - Centro de Convenções Ulysses Guimarães (CCUG)](https://manual-do-big-kahuna.readthedocs.org/en/latest/historia/pythonbrasil9.html) - Tania Andréa -- 2014 - [Pernambuco - Porto de Galinhas - Hotel Armação](http://2014.pythonbrasil.org.br/) - Renato Oliveira -- 2015 - [São Paulo - São José dos Campos - Novotel](http://pythonbrasil.github.io/pythonbrasil11-site/) - Renzo Nuccitelli -- 2016 - [Santa Catarina - Florianópolis - Centro de Convenções CentroSul](http://2016.pythonbrasil.org.br/) - Mário Sérgio Oliveira de Queiroz -- A Python Brasil 2017 será em Belo Horizonte, Minas Gerais - Igor Santos -- A Python Brasil 2018 será em Natal, Rio Grande do Norte - -Mais informações podem ser encontradas no manual do Big Kahuna - [https://manual-do-big-kahuna.readthedocs.org/en/latest/](https://manual-do-big-kahuna.readthedocs.org/en/latest/) - -## Vídeos das conferências passadas - -- [II Pycon Brasil](https://www.youtube.com/user/ericoandrei/videos) -- [Pycon Brasil 2008](https://www.youtube.com/user/opobre/videos) -- [Python Brasil 2010](https://www.youtube.com/watch?v=iuKjxeHLVOU&list=PLqjh1U8eZaP5Qd-IXAxhSXoO6MXZjfP_b) -- [Python Brasil 2011](https://www.youtube.com/watch?v=kMwZpxm_Pac&list=PLqjh1U8eZaP4GVDc2sB-nbZdim13rUU74) -- [Python Brasil 2011](https://www.youtube.com/watch?v=oj3l-VuIIVw&list=PLF6D4A34C424514D3) -- [Python Brasil 2013](https://www.youtube.com/watch?v=FnZTQGKG7dA&list=PLqjh1U8eZaP6TM0tCdLVeiB0LTBkaEBai) -- [Plone Conference 2013](https://www.youtube.com/watch?v=4x_vjgKPyhA&list=PLqjh1U8eZaP4QiTZlx4XFKIannYcMr_am) +Alias: /pythonbrasil/ +Template: redirect +Redirect: https://apyb.python.org.br/pythonbrasil/o-que-é/ \ No newline at end of file diff --git a/content/pages/qual-python.md b/content/pages/qual-python.md index 68cf15ae..ff2211c3 100644 --- a/content/pages/qual-python.md +++ b/content/pages/qual-python.md @@ -2,17 +2,17 @@ Title: Qual Python? Slug: qual-python Template: page -Uma das dúvidas mais recorrentes dentre os iniciantes na linguagem é a respeito da escolha de versão: "Estou começando na linguagem, devo usar python 2 ou python 3?" Para responder a esta pergunta é importante entender o estado atual da linguagem: +Uma das dúvidas mais recorrentes dentre iniciantes na linguagem é a respeito da escolha de versão: "Estou começando na linguagem, devo usar python 2 ou python 3?" Para responder a esta pergunta é importante entender o estado atual da linguagem: - Python 2 foi o padrão da linguagem por muito tempo. -- Python 3 introduziu algumas mudanças que quebraram a compatibilidade com a versão anterior o que criou a nessecidade de se manter duas versões da linguagem. +- Python 3 introduziu algumas mudanças que quebraram a compatibilidade com a versão anterior o que criou a necessidade de se manter duas versões da linguagem. - Python 2 receberá atualizações de segurança até 2020 quando seu suporte será descontinuado. -- Python 3 está constantemente evoluindo e recebendo novas funcionalidades, que não estaram presentes na versão anterior. +- Python 3 está constantemente evoluindo e recebendo novas funcionalidades, que não estarão presentes na versão anterior. -Sabendo disso, a recomendação é de dar sempre que possível preferência ao Python 3, por ser o futuro da linguagem e pelo fato de sua versão anterior estar em processo de descontinuação. +Sabendo disso, a recomendação é dar sempre que possível preferência ao Python 3, por ser o futuro da linguagem e pelo fato de sua versão anterior estar em processo de descontinuação. Use Python 2 somente quando estiver trabalhando com um software que ainda não foi migrado para Python 3 ou caso precise manter algum sistema legado. -As diferênças entre as versões para quem está começando a aprender a linguagem não são tão grandes ao ponto de você não conseguir alternar entre as duas caso necessário. +As diferenças entre as versões para quem está começando a aprender a linguagem não são tão grandes ao ponto de você não conseguir alternar entre as duas caso necessário. -Se estiver curioso quanto as mudanças entre as duas versões dê uma olhada neste [link](https://docs.python.org/3.0/whatsnew/3.0.html). +Se você possuir curiosidade quanto as mudanças entre as duas versões dê uma olhada neste [link](https://docs.python.org/3.0/whatsnew/3.0.html). diff --git a/content/pages/traducao.md b/content/pages/traducao.md new file mode 100644 index 00000000..f0947ddb --- /dev/null +++ b/content/pages/traducao.md @@ -0,0 +1,205 @@ +Title: Como colaborar com a tradução +Slug: traducao +Template: page + +Uma excelente forma de contribuir com a comunidade é através da tradução da documentação da linguagem, de bibliotecas e de ferramentas. Com isso você contribui com o crescimento da comunidade aumentando o alcance da linguagem dentro de pessoas nativas do Português Brasileiro. + +Caso haja interesse em contribuir, a comunidade possui um grupo no Telegram destinado a essa tarefa que pode ser acessado através do seguinte link: + +[https://t.me/pybr_i18n](https://t.me/pybr_i18n) + +As traduções estão sendo feitas através da plataforma [transifex](https://www.transifex.com/). Para ajudar com a tradução basta criar uma conta e seguir para um dos projetos em andamento abaixo: + +### Tradução da documentação da linguagem Python + +Para começar a traduzir faça sua requisição através de: + +[https://www.transifex.com/python-doc/public/](https://www.transifex.com/python-doc/public/) + +### Tradução da documentação do framework Django + +Para começar a traduzir faça sua requisição através de: + +[https://www.transifex.com/django/public/](https://www.transifex.com/django/public/) + +Você pode também participar da lista de e-mails para +discussão sobre tradução do Django: + +[https://groups.google.com/d/forum/django-i18n](https://groups.google.com/d/forum/django-i18n) + +E ler mais sobre a localização do projeto em: + +[https://docs.djangoproject.com/en/dev/internals/contributing/localizing/#documentation](https://docs.djangoproject.com/en/dev/internals/contributing/localizing/#documentation) + +## Referências de tradução + +O Luciano Ramalho e mais uma galera, criaram algumas dicas para quando eles estavam traduzindo o tutorial oficial do Python 2.7 que podem ser usados como referência ao realizar as traduções: + +[http://turing.com.br/pydoc/2.7/tutorial/NOTAS.html#notas-para-os-tradutores-da-versao-pt-br](http://turing.com.br/pydoc/2.7/tutorial/NOTAS.html#notas-para-os-tradutores-da-versao-pt-br) + +## Tradução offline + +Embora o processo de tradução possa ser feito diretamente pelo navegador web, também é possível gerar a documentação traduzida no computador. Isso pode facilitar o processo de revisão já que pelo browser fica mais difícil visualizar links quebrados e navegar pela documentação. + +Para gerar a documentação em português siga os passos a seguir (usaremos o Django como exemplo): + +**1** - Conforme a [documentação do Transifex](http://docs.transifex.com/client/config/), será preciso criar um arquivo chamado `.transifexrc` na raiz do seu diretório pessoal (ex.: `/home/user/.transifexrc`) contendo seu login e senha no Transifex: + +``` +[https://www.transifex.com] +username = user +token = +password = passw0rd +hostname = https://www.transifex.com +``` + +**2** - Será preciso baixar os repositórios e instalar algumas bibliotecas, para isso é recomendado criar uma pasta de trabalho: + +``` +mkdir ~/traducoes/django-br && cd ~/traducoes/django-br +``` + +**3** - Faça o clone do repositório no GitHub: + +``` +git clone https://github.com/django/django.git +``` + +**4** - Faça também o clone do repositório contendo as traduções do Django (como as traduções consomem muito espaço, elas foram movidas para um repositório separado): + +``` +git clone https://github.com/django/django-docs-translations.git +``` + +**5** - Para gerar a documentação em português, nós vamos trabalhar dentro do diretório `django-docs-translations`: + +``` +cd django-docs-translations/ +``` + +**6** - Existem várias traduções disponíveis, uma para cada versão do Django, nesse exemplo nós vamos gerar a documentação para a versão 1.10.x: + +``` +git checkout stable/1.10.x +``` + +**7** - Para a instalação das bibliotecas, é recomendado também criar e ativar um virtualenv: + +``` +python -m venv .django-br +source .django-br/bin/activate +``` + +**6** - Para gerar a documentação, o Django utiliza uma biblioteca chamada Sphinx, você pode instalá-la rodando o comando abaixo: + +``` +pip install sphinx +``` + +**7** - Para baixar as últimas traduções do site Transifex, nós vamos precisar instalar também a biblioteca `Transifex-Client`: + +``` +pip install transifex-client +``` + +**8** - Com o `Transifex-Client` instalado e com o arquivo `.transifexrc` configurado na raiz do seu diretório pessoal, será possível executar o comando abaixo para baixar as traduções do Transifex: + +``` +tx pull -f -l pt_BR +``` + +**9** - Com o download das traduções concluído, agora é preciso executar o comando 'make translations' para compilá-las: + +``` +make translations +``` + +**10** - Também é necessário criar um link simbólico para que o Sphinx gere a documentação utilizando os arquivos baixados e compilados por você (ao invés dos arquivos padrão no repositório do Django): + +``` +ln -s ~/traducoes/django-br/django-docs-translations/translations/ ~/traducoes/django-br/django/docs/locale +``` + +**11** - Agora saia do repositório django-docs-translations e vá para o repositório django, onde vamos encontrar um diretório chamado `docs`. É dentro desse diretório que vamos poder gerar a documentação: + +``` +cd ../django/docs/ +``` + +**12** - Dentro do diretório docs do repositório do Django, após executar os passos acima, rode o comando abaixo para que o Sphinx gere a documentação em português: + +``` +make html LANGUAGE=pt_BR +``` + +**13** - Como medida de segurança, eu sugiro excluir o arquivo `~/.transifexrc` do seu home ou apagar a senha contida dentro dele já que o Transifex não oferece autenticação via tokens (ainda): + +``` +rm ~/.transifexrc +``` + +**14** - Ao final do processo, um novo diretório `_build` é criado e dentro desse diretório é possível encontrar também o diretório `html` contendo os arquivos gerados pelo Sphinx. Para visualizar a documentação entre em `_build/html/`: + +``` +cd _build/html/ +``` + +A página principal da documentação é a `index.html`, clique duas vezes nesse arquivo para que ele seja aberto no seu browser. Clique nos links para navegar pela documentação, embora sejam links html, todo o conteúdo está contido dentro da pasta `_build` e portanto disponível offline. O Sphinx permite ainda gerar a documentação em outros formatos como `.pdf`. + +## Dicas de tradução + +Nesta seção apresentamos agumas dicas de tradução. + +### Atenção com palavras de grafia parecida + +Model: Modelo -- Classe que representa uma tabela. +Module: Módulo -- Módulo Python, e dentro do Django ainda pode ser o nome de uma Django "app". + + +### Cuidado com neologismo + +A maioria dos termos de computação vem do inglês. E muitas vezes usamos os termos em inglês sem nos dar conta, ou pior, usamos uma tradução cujo o sentido da palavra em português é outro. + +### Adotando a linguagem neutra de gênero + +Tente usar a linguagem neutra de gênero, pois é uma forma inclusiva de comunicação. Usar 'x' ou '@' no final de termos masculinos ou femininos não é inclusivo e não é reconhecido por leitores de tela. Tente usar uma linguagem que se refira à pessoas, não somente ao masculino ou feminino. Por exemplo: + +**Se você está interessado em contribuir entre em contato conosco** + +Use ao invés disso: + +**Caso haja interesse em contribuir entre em contato conosco** + +Para saber mais sobre a linguagem neutra de gênero você poder ler este artigo da ThoughtWorks Brasil: [Adotando a linguagem neutra de gênero](https://medium.com/coragem/adotando-a-linguagem-neutra-de-g%C3%AAnero-e509e6e4e06c) + +### Cuidado com os artigos + +Em inglês as palavras não possuem gênero, portando tenha atenção quanto a concordância dos artigos ao realizar a tradução: + +**Or use a common ancestor to hold the :class:\`~django.db.models.AutoField\`** + +alguém poderia traduzir como usando o artigo "o" referindo-se ao "autoField": + +**Ou use um acestral comum para manter o :class:\`~django.db.models.AutoField\`** + +Mas não seria correto. Talvez para uma leitura menos atenta fique até estranho, o que é bom pois chamará atenção se usarmos um artigo feminino neste caso. + +**Ou use um acestral comum para manter a :class:\`~django.db.models.AutoField\`** + +quer dizer, "ou use um acestral comum para a manter a classe ~django.db.models.AutoField" + +Depois do texto renderizado, a diretiva `:class:` não é mostrada, e usar o artigo correto ajuda a lembrar que referenciamos uma classe ou método por exemplo. + +### Não tente explicar mais que na autoria original + +Cuidado ao achar que um texto em inglês não está bem explicado, ou falta detalhes. Você pode ter razão, e a solução é sugerir melhorias no texto original. + +Se ao invés disso, tentar escrever um texto melhor na tradução, +além do problema raiz persistir, pode acontecer de estar sendo repetitivo. + +O erro no texto original pode existir, mas antes de afirmá-lo, procure ler o contexto todo e entender se aquele detalhe ou explicação deveria estar ali, ou já foi comentado em outra seção, +ou se é realmente papel do texto explicar em detalhes tal condição. + +### Glossário de tradução + +Este glossário tem como objetivo criar uma consistência de tradução entre os projetos: diff --git a/content/pages/traducao.rst b/content/pages/traducao.rst deleted file mode 100644 index ee709550..00000000 --- a/content/pages/traducao.rst +++ /dev/null @@ -1,220 +0,0 @@ -:title: Como colaborar com a tradução -:slug: traducao -:template: page - -Para traduzir, faça o cadastro no transifex e entre nas urls: - -https://www.transifex.com/django/django-docs/dashboard/ - -https://www.transifex.com/django/django-docs/language/pt_BR/ - - -Você pode também participar da lista de e-mails para -discussão sobre tradução do django: - -https://groups.google.com/d/forum/django-i18n - -https://docs.djangoproject.com/en/dev/internals/contributing/localizing/#documentation - - -O Luciano Ramalho e mais uma galera, criaram algumas dicas para quando eles estavam traduzindo o tutorial oficial do Python 2.7. Talvez algumas dessas dicas também sirvam para ajudar a traduzir a documentação do django. - -http://turing.com.br/pydoc/2.7/glossary.html#glossary - -http://turing.com.br/pydoc/2.7/tutorial/NOTAS.html#notas-para-os-tradutores-da-versao-pt-br - -Se você tem pouco tempo, alguns minutos, tente o tópico [faq] - -[faq] https://www.transifex.com/django/django-docs/translate/#pt_BR/ - - -Hoje algumas partes estão totalmente traduzidas. Mas toda vez que tem um release novo do Django, os textos ficam obsoletos, ao menos em parte, e tem que ser revistos. Então é um trabalho que nunca acaba. - -Gerando a documentação em português ------------------------------------ - -Embora o processo de tradução possa ser feito diretamente pelo navegador web, também é possível gerar a documentação -traduzida no computador. Isso pode facilitar o processo de revisão já que pelo browser fica mais -difícil visualizar links quebrados e navegar pela documentação. - -Para gerar a documentação em português siga os passos a seguir: - -#. Conforme documentação do Transifex (disponível em http://docs.transifex.com/client/config/), será preciso criar um arquivo chamado '.transifexrc' na raiz do seu home (ex.: /home/user/.transifexrc) contendo seu login e senha no Transifex. Segue um exemplo: :: - - [https://www.transifex.com] - username = user - token = - password = passw0rd - hostname = https://www.transifex.com - -#. Será preciso baixar os repositórios do Django e instalar algumas bibliotecas, para isso eu sugiro criar uma pasta de trabalho: :: - - mkdir /tmp/django-br && cd /tmp/django-br - -#. Faça o clone do repositório do Django no GitHub: :: - - git clone https://github.com/django/django.git - -#. Faça também o clone do repositório contendo as traduções do Django (como as traduções consomem muito espaço, elas foram movidas para um repositório em separado) :: - - git clone https://github.com/django/django-docs-translations.git - -#. Para gerar a documentação em português, nós vamos trabalhar dentro do diretório 'django-docs-translations' :: - - cd django-docs-translations/ - -#. Existem várias traduções disponíveis, uma para cada versão do Django, nesse exemplo nós vamos gerar a documentação para a versão 1.10. :: - - git checkout stable/1.10.x - -#. Para a instalação das bibliotecas, eu também sugiro criar e ativar um virtualenv: :: - - python -m venv .django-br - source .django-br/bin/activate - -#. Para gerar a documentação, o Django utiliza uma biblioteca chamada Sphinx, você pode instalá-la rodando o comando abaixo: :: - - pip install sphinx - -#. Para baixar as últimas traduções do site Transifex, nós vamos precisar instalar também a biblioteca 'Transifex-Client': :: - - pip install transifex-client - -#. Com o 'Transifex-Client' instalado e com o arquivo .transifexrc configurado na raiz do seu home, será possível executar o comando abaixo para baixar as traduções do Transifex: :: - - tx pull -f -l pt_BR - -#. Com o download das traduções concluído, agora é preciso executar o comando 'make translations' para compilá-las: :: - - make translations - -#. Também é necessário criar um link simbólico para que o Sphinx gere a documentação utilizando os arquivos baixados e compilados por você (ao invés dos arquivos padrão no repositório do Django) :: - - ln -s /tmp/django-br/django-docs-translations/translations/ /tmp/django-br/django/docs/locale - -#. Agora saia do repositório django-docs-translations e vá para o repositório django, onde vamos encontrar um diretório chamado 'docs'. É dentro desse diretório que vamos poder gerar a documentação. :: - - cd ../django/docs/ - -#. Dentro do diretório docs do repositório do Django, após executar os passos acima, rode o comando abaixo para que o Sphinx gere a documentação em português :: - - make html LANGUAGE=pt_BR - -#. Como medida de segurança, eu sugiro excluir o arquivo ~/.transifexrc do seu home ou apagar a senha contida dentro dele já que o Transifex não oferece autenticação via tokens (ainda). :: - - rm ~/.transifexrc - -#. Ao final do processo, um novo diretório '_build' é criado e dentro desse diretório é possível encontrar também o diretório 'html' contendo os arquivos gerados pelo Sphinx. Para visualizar a documentação entre em _build/html/ :: - - cd _build/html/ - -A página principal da documentação é a 'index.html', clique duas vezes nesse arquivo para que ele seja aberto no seu browser. Clique nos links para navegar pela documentação, embora sejam links html, todo o conteúdo está contido dentro da pasta _build e portanto disponível offline. O Sphinx permite ainda gerar a documentação em outros formatos como .pdf mas eu só testei o formato html. - -O que traduzir --------------- - -Ao ler a documentção do Django seria comum se confundisse - -Model: Modelo -- Classe que representa uma tabela. -Module: Módulo -- Módulo Python, e dentro do Django ainda pode ser o nome de uma Django "app". - - -Atento aos nomes inerentes ao objeto da tradução ------------------------------------------------- - -A maioria dos termos de computação vem do inglês. E muitas vezes os temor em inglês ne não nos damos conta, ou pior, usamos uma tradução cujo o sentido da palbra em portuges é outro - - -Cuidado com os artigos ----------------------- - -Algumas vezes encontramos textos referenciando classe ou métodos por exemplo, onde descrevem o nome destes mas não explicitam que se referem a uma classe ou método. Como durante a traduçao temos as marcações de RestruturedText, temos uma ajuda para saber se por exemplo usamos um artigo feminino ou masculino. Como no texto abaixo. - - Or use a common ancestor to hold the \:class:`~django.db.models.AutoField`\:: - -alguém poderia traduzir como usando o artigo "o" referindo-se ao "autoField": - - Ou use um acestral comum para manter o \:class:`~django.db.models.AutoField`\:: - -Mas não seria correto. Talvez para um leitor menos atento fique até estranho, -o que é bom pois o chamará atenção se usarmos um artigo feminino neste caso. - - Ou use um acestral comum para manter a \:class:`~django.db.models.AutoField`\:: - -quer dizer, `ou use um acestral comum para a manter a classe `~django.db.models.AutoField`` - -Depois do texto renderizado, a diretiva \`:class:` não é mostrada, e usar o artigo correto ajuda a lembrar que referenciamos uma classe ou método por exemplo. - - -Não tente explicar mais que o Autor original --------------------------------------------- - -Cuidado ao achar que um texto em inglês não está bem explicado, ou falta detalhes. Você pode ter razão, e a solução é sugerir melhorias no texto original. - -Se ao invés disso, tentar escrever um texto melhor na tradução, -além do problema raiz persistir, pode acontecer de estar sendo repetitivo. - -O erro no texto original pode existir, mas antes de afirmá-lo, procure ler o contexto todo e entender se aquele detalhe ou explicaç ao deveria estar ali, ou já foi comentado emoutra seção, -ou se é realmente papel do texto explicar em detalhes tal condição. - ---------------------------------- - -Notas do Cadu - -Parser: - Análisador sintática - é o processo de analisar uma sequência de entrada segundo uma grmática formal. - -auto-escaping : - auto substituição. - -template: - modelo (mas dentro do contexto do django pode ser confundido como o modelo da classe Model.) - -template tag: - tag de template - funções para serem usadas em templates - -set the : - defina a variaável ou atributo. - -Notas do @FilipeCifali - -Cloud: - nuvem - exemplos: cloud service - serviço em nuvem, cloud hosting - hospedagem em nuvem - ---------------------------------- - -topics[1355] - está confuso ao explicar que o modulo do modelo deve ser colocado no settings - - For example, if the models for your application live in the module ``myapp.models`` (the package structure that is created for an application by the \:djadmin:`manage.py startapp