pythonfluente / pythonfluente2e Goto Github PK

Olá pessoal, obrigado pelo incrível trabalho nessa tradução.

Gostaria de sugerir a criação de pdf quando este material for atualizado utilizando o AsciiDoctor-pdf.
Mais informações aqui: https://docs.asciidoctor.org/pdf-converter/latest/convert-to-pdf/#convert-an-asciidoc-document-to-a-pdf

Acho que seria legal colocar um aviso no README.md de que o projeto necessita do asciidoctor para compilar o livro.

• 6.5.1, legenda do exemplo 13:

Exemplo 13. Buses haunted by ghost passengers

Deveria estar em inglês mesmo?

• 6.5.1, abaixo do exemplo 13:

você pode inspecionar o objeto HauntedBusinit e ver os estudantes fantasma assombrando o atributo __defaults__:

Por fim, podemos verificar que bus2.passengers é um apelido vinculado ao primeiro elemento do atributo HauntedBus.init.defaults

Nos dois casos a sintaxe de métodos especiais de Python se confunde com a sintaxe para renderização de palavras em itálico em AsciiDoc. Para contornar isso, basta escrever HauntedBus.\\__init__ e HauntedBus.\\__init__.\\__defaults__ no documento.

Obs.: O livro parece não estar atualizado com os últimos commits.

Levando em conta a questão de distribuição e disponibilidade do conteúdo, penso que poderia haver uma opção de geração de um arquivo EPUB para uso em e-readers. Não sei o quão complexo seria para adicionar um botão ao website do livro que retornasse o e-book.

Visto que o livro é totalmente escrito em asciidoctor, existe uma funcionalidade da linguagem que transforma em epub, vide Documentação. Talvez, após a finalização da tradução do livro, gerar um epub localmente e subir no próprio repositório (se o arquivo não ficar tão grande e/ou compromenta o projeto).

Estou lendo o livro pelo site e notei que os blocos de código estão todos monocromáticos. Seria possível adicionar highlight de sintaxe?

Eu não conheço o Asciidoctor, mas na documentação deles tem uma página sobre o assunto:
https://docs.asciidoctor.org/asciidoctor/latest/syntax-highlighting/

Posso contribuir se precisar, só preciso de orientação

Seria excelente se o HTML gerado pelo asciidoctor tivesse um JS para baixar uma imagem somente quando a pessoa está vendo aquela parte da página. Assim economiza banda.

Opa!
Durante a live com o Bruno outro dia eu sugeri de vocês usarem uma conta do GitBook para publicar o conteúdo.
Não tenho relação com eles mas o serviço é excelente e seria ótimo term um layout otimizado na publicação.
Como ele permite seções seria uma grande vantagem para a publicação facilitando a leitura, adicionalmente features como tema escuro, poder converter em epub e pdf.

Link dos caras: https://www.gitbook.com

Sou fã do seu trabalho então se sua obra pode ficar mais otimizada para chegar em mais pessoas, seria muito legal poder contribuir!

• https://pythonfluente.com/#context_managers_sec
  "Imprime uma str, depois o valor [...]" -> 'Exibe uma str, depois o valor [...]"
  "Se a exceção não é None e seu tipo é ZeroDivisionError, imprime uma mensagem…​" -> "Se a exceção não é None e seu tipo é ZeroDivisionError, exibe uma mensagem…​"

• https://pythonfluente.com/#_o_repl
  Talvez aqui seja melhor manter imprime mesmo... " (read-eval-print-loop, loop-lê-calcula-imprime)"

• https://pythonfluente.com/#_experimentando_com_executor_map
  "Essa função simplesmente imprime quaisquer argumentos [...]" -> ""Essa função simplesmente exibe quaisquer argumentos [...]"

O asciidoctor é especializado em gerar livros, então por padrão ele lê varios arquivos .adoc e combina todos em um único arquivo .html.

Seria bom separar em vários .html, um por capítulo.

Desafios:

• manter as referências cruzadas entre diferentes capítulos
• gerar o sumário (TOC)

Não encontrei forma de fazer isso no asciidoctor. Se souber como, conta aí.

Uma alternativa é usar fazer o parsing do HTML único e gerar os HTML por capítulo alterando os HREF das referências cruzadas e das entradas na TOC. O HTML gerado pelo asciidoctor é muito bem estruturado.

Olá pessoal,

Gostaria de sugerir alguns termos em português para evitar o uso de estrangeirismos.

Segue abaixo uma lista de alguns termos em português que poderiam ser usados em vez de seus equivalentes em inglês:

• performance -> desempenho
• container -> contêiner
• query -> consulta
• factory -> fábrica
• stack -> pilha

Termos sem um equivalente em português:

• status -> estado ??
• aliasing ->
• função callback -> função de retorno ??
• caching ->
• hashable -> hasheável ??
• deadlock -> bloqueio mútuo, impasse ??

O que vocês acham?

• Seção 6.3, logo após Exemplo 3:

Entretanto, suponha que um impostor — vamos chamá-lo de Dr. Alexander Pedachenko — alegar ser Charles L. Dodgson

Possível erro de concordância verbal: alegar deveria ser alega?

• Seção 6.3, legenda da Figura 2:

charles and lewis estão vinculados aos mesmo objeto; (...)

Uso da palavra and em vez de e; aos deveria ser ao.

• Seção 6.3.1.:

Objetos sentinela são outro exemplo de singletons que testamos com is Aqui está uma maneira de criar e testar um objeto sentinela:

Falta ponto final antes de Aqui está.

• Seção 6.3.2., Exemplo 5:

Obtem o ID da lista na posição t1[-1].

Falta acento agudo na palavra Obtem (Obtém).

• Seção 6.4. :

Mas se existirem itens mutaveis, isso pode gerar surpresas desagradáveis.

Falta acento agudo na palavra mutaveis (mutáveis).

• Seção 6.4.:

Em Exemplo 6 criamos uma lista contendo outra lista e uma tupla, e então fazemos algums mudanças para ver como isso afeta os objetos referenciados.

Erro na palavra algums, deveria ser algumas.

• Seção 6.4., dica acima do exemplo 6:

Mas é uma a ferramenta é fantástica, então vale a pena gastar seu tempo copiando e colando o código.

Mas é uma a ferramenta é fantástica está estranho, seria Mas é uma ferramenta fantástica?

• Seção 6.4, legenda da Figura 4:

(...) mas a operação l2[2] += (10, 11) criou yma nova tupla com conteúdo (...)

Erro na palavra yma que deveria ser uma.

• Seção 6.4.1:

Para ilustrar o uso de copy() e deepcopy(). Exemplo 8 define uma classe simples, Bus (...)

Uso de de ponto final em vez de vírgula após deepcopy()?

• Seção 6.4.1, acima do Exemplo 9:

Agora, no Exemplo 9 interativo, vamos criar um objeto bus (bus1) e dois clones --uma cópia rasa (bus2) e uma cópia profunda (bus3)—para ver o quê acontece quando bus1 deixa um passageiro.

Falta de espaços entre os travessões.

• Seção 6.4.1, Exemplo 9:

4. bus3 é uma cópia profunda de bus1, então seu atributo passengers se refere a outra lista.

Faltou acrescentar o estilo de "código" na palavra passengers.

• Seção 6.4.1, legenda do Exemplo 10:

(...) ainda assim, deepcopy` consegue copiar a.

Crase solta após a palavra deepcopy.

Por enquanto li só até a seção 6.4., posso continuar depois. Fico muito feliz em contribuir nem que seja um pouquinho num projeto tão grandioso como esse! Peço desculpas adiantadas se corrigi algo erroneamente.

Não deveria ser classes bases abstratas?

Usamos classes base abstratas (ABCs) para definir interfaces passíveis de checagem explícita de tipo durante a execução

O uso do plural para bases está presente na documentação do python em português, citada logo em seguida no texto. Esse padrão, usando base e não bases está presente durante todo o texto.

Falta um ponto ao final de:

(o sequenciamento de DNA cada vez mais barato e rápido vem tornando a cladística muito prática em muito mais casos)

Trocar a virgula por um ponto:

e especificamente não precisa herdar dela!), Isso é um longo caminho andado

Tem um ponto sobrando nesse pedaço:

tipicamente praticada pela maioria do programadores orientados a .objetos.

Não tem ABC demais nesse texto?

Os métodos concretos em cada ABC de collections.abc ABC são implementados

Na versão em inglês só aparece uma vez: The concrete methods in each collections.abc ABC are implemented

Ficou um pouco estranho a frase:

funciona executando uma busca sequencial na sequência

Palavra repetida

mas se sua a sua sequência concreta mantém seus itens e ordenados

Pequena correção: disponível

você precisa saber o quê está dispinível

Talvez trocar por: Mas as mais usadas estão em collections.abc

Mas a maioria das mais usadas estão em collections.abc

Figura é feminino: A Figura...

O Figura 4 é um diagrama de classe resumido

Sobrou um texto em inglês para ser retirado:

Isso é explicado no box seguinte. The next box explains.

Trocar a virgula antes de Assim por um ponto:

são ferramentas para criar frameworks, Assim, apenas uma pequena minoria

Pequeno erro: escritos

O nome da ABC Tombola e de seus métodos abstratos estão escritoa em itálico

TÓPICO 1.3.1: Emulando tipos numéricos

Como está:

"O [Exemplo 2] implementa dois operadores: e*, para demonstrar o uso básico de +add e mul. No dois casos, ..."

Como deveria ser:

"O [Exemplo 2] implementa dois operadores: +' e *, para demonstrar o uso básico de add e mul. Nos dois casos, ..."

Seria incrível uma versao em EPUB ou PDF para facilitar a leitura num tablet ou Kindle sem internet…

Olá, gostaria de discutir sobre a possibilidade de utilizar o asciidoctor para gerar uma versão do livro no modo escuro, onde o fundo seria com uma cor mais suave para leituras prolongadas.

Acredito que gerar um arquivo HTML separado seja mais fácil, mas também pode-se verificar a possibilidade de adicionar um botão no HTML que permite alterar entre o modo escuro e claro.

Estou lendo o livro e percebi um pequeno erro no primeiro parágrafo da seção 2.8., no primeiro + que deveria aparecer em um bloco de código inline. No entanto, a próxima frase inteira fica como código.

Renderização do site

Visualização no GitHub

Código fonte

Aparentemente no asciidoctor a notação `+ é usada pra determinar um bloco inline literal monospace:

https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/#literals-and-source-code

Seria possível resolver usando um caractere de escape? `\+?

Opa galeret,
qual é a forma adotada no livro: uma array ou um array? Vejo ocorrências dos dois.
Me avisem qual é; posso ajudar com um PR.
Agradeço!

Há uma inconsistência na capitalização dos capítulos. Em alguns deles, cada palavra começa com maiúscula (como no inglês). Em outras, apenas a primeira letra é maiúscula (como é o certo em português brasileiro).

Caso alguém queira contribuir com isso, o jeito correto já aceito pelos autores é do jeito brasileiro citado acima e de acordo com o Paulo me respondeu no Twitter:

Sim, nós começamos de um jeito, aí mudamos de ideia no meio do caminho e ainda não voltamos 
para revisar os primeiros. O padrão atual é capitalizar apenas a primeira letra (exceto, claro,
para nomes próprios, tipo "Python").