Merge branch 'main' into update-docs

Author: ramalho

Livro.adoc

@@ -11,6 +11,7 @@ include::atributos-pt_BR.adoc[]
 :toc: left
 :toclevels: 2
 :!chapter-signifier:
+:front-cover-image: image:cover.jpg[fit=cover]
 
 include::Prefacio.adoc[]
 
@@ -77,4 +78,4 @@ include::capitulos/cap23.adoc[]
 
 include::capitulos/cap24.adoc[]
 
-include::Posfacio.adoc[]
+include::Posfacio.adoc[]

Posfacio.adoc

@@ -5,13 +5,13 @@
 
 [quote, Alan Runyan, co-fundador do Plone]
 ____
-O Python é uma linguagem para programação consensual entre adultos.
+Python é uma linguagem para programação consensual entre adultos.
 ____
 
-A((("Python", "community support for"))) definição sagaz do Alan expressa uma das melhores qualidades do Python: ele sai da frente e deixa você fazer o que for preciso. Isso também significa que a linguagem não dá ferramentas para restringir o que outros podem fazer com seu código e com os objetos que ele cria.
+A((("Python", "community support for"))) definição sagaz do Alan expressa uma das melhores qualidades de Python: ele sai da frente e deixa você fazer o que for preciso. Isso também significa que a linguagem não dá ferramentas para restringir o que outros podem fazer com seu código e com os objetos que ele cria.
 
-Aos 30, o Python segue ganhando popularidade.
-Mas, claro, não é perfeito. 
+Aos 30, Python segue ganhando popularidade.
+Mas, claro, não é perfeito.
 Entre minhas maiores irritações está o uso inconsistente do `CamelCase` footnote:[NT: termos com maiúsculas no início de cada palavra de uma expressão composta.],
 do `snake_case` footnote:[NT: termos com hífens separando palavras de uma expressão composta],
 e `joinedwords` footnote:[NT: composição direta de palavras] na biblioteca padrão.
@@ -25,7 +25,7 @@ Isso não se passou em um clube exclusivo. Qualquer pessoa pode se juntar à lis
 Outro exemplo de abertura: a((("Python Software Foundation (PSF)"))) Python Software Foundation (PSF) tem trabalhado para aumentar a diversidade na comunidade Python. Alguns resultados encorajadores já apareceram. A diretoria para 2013–2014 da PSF viu as primeiras diretoras eleitas: Jessica McKellar e Lynn Root. Em 2015, Diana Clarke presidiu a PyCon North America em Montreal, onde cerca de um terço dos palestrantes foram mulheres.
 A PyLadies((("PyLadies"))) se tornou um movimento verdadeiramente global, e me orgulha que tenhamos tantas seções da PyLadies no Brasil.
 
-Se você é um pythonista mas ainda não se envolveu com a comunidade, encorajo você a fazê-lo. Procure a PyLadies ou((("Python Users Group (PUG)"))) um Grupo de Usuários Python na sua vizinhança. Se nenhum existir, crie um. O Python está em todo lugar, então você não ficará sozinho. Viaje para eventos, se puder. Junte-se também a eventos online. Durante a pandemia de Covid-19, aprendi muito nos "encontros no hall" das conferências online.
+Se você é um pythonista mas ainda não se envolveu com a comunidade, encorajo você a fazê-lo. Procure a PyLadies ou((("Python Users Group (PUG)"))) um Grupo de Usuários Python na sua vizinhança. Se nenhum existir, crie um. Python está em todo lugar, então você não ficará sozinho. Viaje para eventos, se puder. Junte-se também a eventos online. Durante a pandemia de Covid-19, aprendi muito nos "encontros no hall" das conferências online.
 Venha a uma conferência da PythonBrasil--temos a presença de palestrantes estrangeiros há anos.
 Encontrar outros pythonistas traz benefícios reais além do compartilhamento de conhecimento.
 Como empregos reais e amizades reais.
@@ -47,13 +47,13 @@ Brandon Rhodes é um fantático professor de Python, e sua palestra https://fpy.
 
 A thread https://fpy.li/a-5["Evolution of Style Guides" (_A Evolução dos Guias de Estilo_)] (EN), iniciada por Ian Lee no Python-ideas, vale a leitura. Lee é o mantenedor do pacote https://fpy.li/a-6[`pep8`], que verifica código Python quanto à aderência ao PEP 8. Para verificar o código deste livro usei o https://fpy.li/a-7[`flake8`], que inclui o `pep8`, https://fpy.li/a-8[`pyflakes`], e o https://fpy.li/a-9[McCabe complexity plug-in (_plug-in de complexidade McCabe_ ou _complexidade ciclomática_)], de Ned Batchelder.
 
-Além do PEP 8, outros influentes guias de estilo são o https://fpy.li/a-10[_Google Python Style Guide_ ("Guia de Estilo Python do Google")] e o 
+Além do PEP 8, outros influentes guias de estilo são o https://fpy.li/a-10[_Google Python Style Guide_ ("Guia de Estilo Python do Google")] e o
 https://fpy.li/a-11[_Pocoo Styleguide_ ("Guia de Estilo Pocoo")], do mesmo grupo que nos deu o Flake, o Sphinx, a Jinja 2 e outras ótimas bibliotecas Python.
 
-https://fpy.li/a-12[_The Hitchhiker’s Guide to Python!_ ("O Guia do Mochileiro Python")] é um esforço coletivo sobre a escrita de código pythônico. Seu contribuidor mais prolífico é Kenneth Reitz, um herói da comunidade devido a seu maravilhoso e pythônico pacote `requests`. David Goodger apresentou um tutorial na PyCon US 2008 intitulado https://fpy.li/a-13["Code Like a Pythonista: Idiomatic Python" (_Programe como um Pythonista: Python Idiomático_)]. Se impressas, as notas do tutorial tem 30 páginas. Goodger criou tanto reStructuredText quanto ++docutils++—as bases do Sphinx, o excelente sistema de documentação do Python (que, por sinal, também é o https://fpy.li/a-14[sistema oficial de documentação] do MongoDB e de muitos outros projetos).
+https://fpy.li/a-12[_The Hitchhiker’s Guide to Python!_ ("O Guia do Mochileiro Python")] é um esforço coletivo sobre a escrita de código pythônico. Seu contribuidor mais prolífico é Kenneth Reitz, um herói da comunidade devido a seu maravilhoso e pythônico pacote `requests`. David Goodger apresentou um tutorial na PyCon US 2008 intitulado https://fpy.li/a-13["Code Like a Pythonista: Idiomatic Python" (_Programe como um Pythonista: Python Idiomático_)]. Se impressas, as notas do tutorial tem 30 páginas. Goodger criou tanto reStructuredText quanto ++docutils++—as bases do Sphinx, o excelente sistema de documentação de Python (que, por sinal, também é o https://fpy.li/a-14[sistema oficial de documentação] do MongoDB e de muitos outros projetos).
 
 Martijn Faassen enfrenta a questão diretamente em https://fpy.li/a-15["What is Pythonic?" (_O que é pythônico?_)]
 Na python-list há uma thread com https://fpy.li/a-16[o mesmo título].
 O post de Martijn é de 2005, e a thread de 2003, mas o ideal pythônico não mudou muito—e aliás, nem a própria linguagem mudou tanto. Uma ótima thread com "pythônico" no título é https://fpy.li/a-17["Pythonic way to sum n-th list element?" (_A forma pythônica de somar os "n" elementos de uma lista_)], que citei extensivamente no <<sequence_hacking_soapbox>>.
 
-A https://fpy.li/pep3099[PEP 3099 -- Things that will Not Change in Python 3000 (_PEP 3099 -- Coisas que não vão mudar no Python 3000_)] explica porque muitas coisas são como são, mesmo após uma revisão profunda como foi o Python 3. Por muito tempo, o Python 3 foi apelidado Python 3000, mas acabou chegando alguns séculos adiantado--para o desespero de alguns. A PEP 3099 foi escrita por Georg Brandl, compilando muitas opiniões expressas pelo _BDFL_ Guido van Rossum. A página https://fpy.li/a-18["Python Essays" (_Ensaios sobre Python_)] lista vários textos do próprio Guido.
+A https://fpy.li/pep3099[PEP 3099 -- Things that will Not Change in Python 3000 (_PEP 3099 -- Coisas que não vão mudar no Python 3000_)] explica porque muitas coisas são como são, mesmo após uma revisão profunda como foi Python 3. Por muito tempo, Python 3 foi apelidado Python 3000, mas acabou chegando alguns séculos adiantado--para o desespero de alguns. A PEP 3099 foi escrita por Georg Brandl, compilando muitas opiniões expressas pelo _BDFL_ Guido van Rossum. A página https://fpy.li/a-18["Python Essays" (_Ensaios sobre Python_)] lista vários textos do próprio Guido.