links com fonte menor

Author: ramalho

print/xrefs/formatos.adoc

@@ -6,7 +6,7 @@ não é resolvido...
 
 [source, asciidoctor]
 ----
-O sinalizador da nova https://fpy.li/2f[sintaxe de strings de formato]
+O sinalizador da nova https://fpy.li/2f["sintaxe de strings de formato"]
 usada nas _f-strings_ e...
 ----
 
@@ -18,8 +18,8 @@ usada nas _f-strings_ e...
 Regex:
 
 ----
-  de: https://(fpy.li/.*?)\[(.*?)\]
-para: «$2» [$1]
+  de: https://(fpy.li/.*?)\[("?)(.+?)\2\]
+para: «$3» [.small]#[$1]#
 ----
 
 == Formatos de xref

vol1/Prefacio.adoc

@@ -10,7 +10,6 @@
 :sectnums!:
 
 [dedication]
-= Dedication
 __Para Marta, com todo o meu amor.__
 
 [[preface]]
@@ -20,10 +19,10 @@ __Para Marta, com todo o meu amor.__
 ____
 Eis um plano: se uma pessoa usar um recurso que você não entende, mate-a.
 É mais fácil que aprender algo novo, e em pouco tempo os únicos programadores sobreviventes
-usarão apenas um subconjunto minúsculo e fácil de entender de Python 0.9.6 <piscadela marota>.footnote:[Mensagem para o grupo da Usenet comp.lang.python em 23 de dezembro de 2002: https://fpy.li/p-1["Acrimony in c.l.p"] (EN).]
+usarão apenas um subconjunto minúsculo e fácil de entender de Python 0.9.6 <piscadela marota>.footnote:[Mensagem para o grupo da Usenet comp.lang.python em 23 de dezembro de 2002: «Acrimony in c.l.p» [.small]#&#91;fpy.li/p-1&#93;# (EN).]
 ____
 
-"Python é uma linguagem fácil de aprender e poderosa." Essas((("Python", "appreciating language-specific features"))) são as primeiras palavras do https://fpy.li/p-2[tutorial oficial de Python 3.10].
+"Python é uma linguagem fácil de aprender e poderosa." Essas((("Python", "appreciating language-specific features"))) são as primeiras palavras do «tutorial oficial de Python 3.10» [.small]#&#91;fpy.li/p-2&#93;#.
 Isso é verdade, mas há uma pegadinha: como a linguagem é fácil de entender e de começar a usar, muitos programadores praticantes de Python se contentam apenas com uma fração de seus poderosos recursos.
 
 Uma programadora experiente pode começar a escrever código Python útil em questão de horas. Conforme as primeiras horas produtivas se tornam semanas e meses, muitos desenvolvedores continuam escrevendo código Python com um forte sotaque das linguagens que aprenderam antes.
@@ -55,7 +54,7 @@ Os exemplos que exigem especificamente Python 3.10 estão indicados.
 Caso((("Python", "prerequisites to learning")))
 não tenha certeza se conhece Python o suficiente para acompanhar o livro,
 revise o
-https://fpy.li/4g[tutorial oficial de Python].
+«tutorial oficial de Python» [.small]#&#91;fpy.li/4g&#93;#.
 Tópicos tratados no tutorial não serão explicados aqui, exceto por alguns recursos mais novos.
 
 
@@ -69,10 +68,10 @@ de métodos especiais e truques de metaprogramação.
 Abstração prematura é tão ruim quanto otimização prematura.
 
 Para quem está aprendendo a programar, recomendo o livro
-https://fpy.li/4h[Pense em Python] de Allen Downey, disponível na Web.
+«Pense em Python» [.small]#&#91;fpy.li/4h&#93;# de Allen Downey, disponível na Web.
 
 Se já sabe programar e está aprendendo Python, o
-https://fpy.li/4g[tutorial oficial de Python] foi traduzido
+«tutorial oficial de Python» [.small]#&#91;fpy.li/4g&#93;# foi traduzido
 pela comunidade Python brasileira.
 
 
@@ -148,7 +147,7 @@ especialmente para quem teve mais experiência com linguagens estáticas compila
 que não oferecem um REPL.footnote:[_Read-Eval-Print Loop_, o nome acadêmico de um console interativo
 que funciona como um laço lendo código, avaliando, e exibindo resultados.]
 
-Um dos pacotes padrão de testagem de Python, o https://fpy.li/doctest[`doctest`], funciona simulando sessões de console e verificando se as expressões resultam nas resposta exibidas. Usei `doctest` para verificar a maior parte do código desse livro, incluindo as listagens do console.
+Um dos pacotes padrão de testagem de Python, o «`doctest`» [.small]#&#91;fpy.li/doctest&#93;#, funciona simulando sessões de console e verificando se as expressões resultam nas resposta exibidas. Usei `doctest` para verificar a maior parte do código desse livro, incluindo as listagens do console.
 Não é necessário usar ou sequer saber da existência do `doctest` para acompanhar o texto:
 a principal característica dos _doctests_ é que eles imitam transcrições de sessões
 interativas no console de Python, assim qualquer pessoa pode reproduzir as demonstrações facilmente.
@@ -159,7 +158,7 @@ Escrever os testes previamente é a base de desenvolvimento dirigido por testes
 
 Também((("pytest package")))((("unittest module"))) escrevi testes de unidade para alguns dos exemplos maiores usando _pytest_—que acho mais fácil de usar e mais poderoso que o módulo _unittest_ da bibliotexa padrão.
 Você vai descobrir que pode verificar a maior parte do código do livro digitando `python3 -m doctest example_script.py` ou `pytest` no console de seu sistema operacional.
-A configuração do _pytest.ini_, na raiz do https://fpy.li/code[repositório do código de exemplo], assegura que _doctests_ são coletados e executados pelo comando `pytest`.((("", startref="Papproach00")))
+A configuração do _pytest.ini_, na raiz do «repositório do código de exemplo» [.small]#&#91;fpy.li/code&#93;#, assegura que _doctests_ são coletados e executados pelo comando `pytest`.((("", startref="Papproach00")))
 
 
 === Ponto de vista: minha perspectiva pessoal
@@ -177,7 +176,7 @@ https://fluentpython.com::
 Contém textos em inglês para ambas edições do livro, além de um glossário.
 É um material que eu cortei para não ultrapassar o limite de 1.000 páginas.
 
-O repositório de exemplos de código está no https://fpy.li/code[GitHub].
+O repositório de exemplos de código está no «GitHub» [.small]#&#91;fpy.li/code&#93;#.
 
 === Convenções usadas no livro
 
@@ -213,7 +212,7 @@ Este elemento é um aviso ou alerta.
 
 === Usando os exemplos de código
 
-Todos((("code examples, obtaining and using"))) os scripts e a maior parte dos trechos de código que aparecem no livro estão disponíveis no repositório de código de Python Fluente, https://fpy.li/code[no GitHub].
+Todos((("code examples, obtaining and using"))) os scripts e a maior parte dos trechos de código que aparecem no livro estão disponíveis no repositório de código de Python Fluente, «no GitHub» [.small]#&#91;fpy.li/code&#93;#.
 
 Se você tiver uma questão técnica ou algum problema para usar o código, por favor mande um email para pass:[<a class="email" href="mailto:bookquestions@oreilly.com"><em>bookquestions@oreilly.com</em></a>].
 
@@ -302,7 +301,7 @@ Adoro ensinar Python porque ele é belo, simples e claro.
 
 Alex Martelli e Anna Ravenscroft foram os primeiros a verem o esquema desse livro, e me encorajaram a submetê-lo à O'Reilly para publicação.
 Seus livros me ensinaram Python idiomático e são modelos de clareza, precisão e profundidade em escrita técnica.
-Os https://fpy.li/p-7[6,200+ posts de Alex no Stack Overflow] (EN) são uma fonte de boas ideias sobre a linguagem e seu uso apropriado.
+Os «6,200+ posts de Alex no Stack Overflow» [.small]#&#91;fpy.li/p-7&#93;# (EN) são uma fonte de boas ideias sobre a linguagem e seu uso apropriado.
 
 Martelli e Ravenscroft foram também revisores técnicos deste livro, juntamente com Lennart Regebro e Leonardo Rochael. Todos nesta proeminente equipe de revisão técnica têm pelo menos 15 anos de experiência com Python, com muitas contribuições a projetos Python de alto impacto, em contato constante com outros desenvolvedores da comunidade. Em conjunto, eles me enviaram centenas de correções, sugestões, questões e opiniões, acrescentando imenso valor ao livro. Victor Stinner gentilmente revisou o _{ch_async}_, trazendo seu conhecimento especializado, como um dos mantenedores do `asyncio`, para a equipe de revisão técnica. Foi um grande privilégio e um prazer colaborar com eles por estes muitos meses.
 
@@ -312,7 +311,7 @@ Mario Domenech Goulart deu sugestões numerosas e detalhadas, desde a primeira v
 
 Ao longo dos anos, muitas pessoas me encorajaram a me tornar um autor, mas os mais persuasivos foram Rubens Prates, Aurelio Jargas, Rudá Moura e Rubens Altimari. Mauricio Bussab me abriu muitas portas, incluindo minha primeira experiência real na escrita de um livro. Renzo Nuccitelli apoiou este projeto de escrita o tempo todo, mesmo quando significou iniciar mais lentamente nossa parceria no pass:[<a href="https://fpy.li/p-8" class="orm:hideurl"><em>python.pro.br</em></a>].
 
-A maravilhosa comunidade brasileira de Python é inteligente, generosa e divertida. O https://fpy.li/p-9[grupo Python Brasil] tem milhares de membros, e nossas conferências nacionais e regionais reúnem centenas de pessoas. Mas os mais influemtes em minha jornada como pythonista foram Leonardo Rochael, Adriano Petrich, Daniel Vainsencher, Rodrigo RBP Pimentel, Bruno Gola, Leonardo Santagada, Jean Ferri, Rodrigo Senra, J. S. Bueno, David Kwast, Luiz Irber, Osvaldo Santana, Fernando Masanori, Henrique Bastos, Gustavo Niemayer, Pedro Werneck, Gustavo Barbieri, Lalo Martins, Danilo Bellini, e Pedro Kroger.
+A maravilhosa comunidade brasileira de Python é inteligente, generosa e divertida. O «grupo Python Brasil» [.small]#&#91;fpy.li/p-9&#93;# tem milhares de membros, e nossas conferências nacionais e regionais reúnem centenas de pessoas. Mas os mais influemtes em minha jornada como pythonista foram Leonardo Rochael, Adriano Petrich, Daniel Vainsencher, Rodrigo RBP Pimentel, Bruno Gola, Leonardo Santagada, Jean Ferri, Rodrigo Senra, J. S. Bueno, David Kwast, Luiz Irber, Osvaldo Santana, Fernando Masanori, Henrique Bastos, Gustavo Niemayer, Pedro Werneck, Gustavo Barbieri, Lalo Martins, Danilo Bellini, e Pedro Kroger.
 
 Dorneles Tremea foi um grande amigo, (e incrivelmente generoso com seu tempo e seu conhecimento), um hacker fantástico e o mais inspirador líder da Associação Python Brasil. Ele nos deixou cedo demais.
 
@@ -322,7 +321,7 @@ Martijn Faassen foi meu mentor de Grok e compartilhou ideias valiosas sobre Pyth
 
 Tenho gurus demais na comunidade Python como um todo para listar todos aqui, mas além daqueles já mencionados, eu tenho uma dívida com Steve Holden, Raymond Hettinger, A.M. Kuchling, David Beazley, Fredrik Lundh, Doug Hellmann, Nick Coghlan, Mark Pilgrim, Martijn Pieters, Bruce Eckel, Michele Simionato, Wesley Chun, Brandon Craig Rhodes, Philip Guo, Daniel Greenfeld, Audrey Roy e Brett Slatkin, por me ensinarem novas e melhores formas de ensinar Python.
 
-A maior parte dessas páginas foi escrita no meu _home office_ e em dois laboratórios: o CoffeeLab e o Garoa Hacker Clube. O https://fpy.li/p-10[CoffeeLab] é o quartel general dos geeks cafeinados na Vila Madalena, em São Paulo, Brasil. O https://fpy.li/p-11[Garoa Hacker Clube] é um espaço hacker aberto a todos: um laboratório comunitário onde qualquer um é livre para tentar novas ideias.
+A maior parte dessas páginas foi escrita no meu _home office_ e em dois laboratórios: o CoffeeLab e o Garoa Hacker Clube. O «CoffeeLab» [.small]#&#91;fpy.li/p-10&#93;# é o quartel general dos geeks cafeinados na Vila Madalena, em São Paulo, Brasil. O «Garoa Hacker Clube» [.small]#&#91;fpy.li/p-11&#93;# é um espaço hacker aberto a todos: um laboratório comunitário onde qualquer um é livre para tentar novas ideias.
 
 A comunidade Garoa me forneceu inspiração, infraestrutura e distração. Acho que Aleph gostaria desse liro.
 
@@ -340,20 +339,20 @@ _Python Fluente, Segunda Edição_
 Não é uma obra derivada de _Python Fluente_ (Novatec, 2015).
 
 A presente tradução foi autorizada pela O'Reilly Media para distribuição nos termos da licença
-https://fpy.li/4j[CC BY-NC-ND].
+«CC BY-NC-ND» [.small]#&#91;fpy.li/4j&#93;#.
 Os arquivos-fonte em formato _Asciidoc_ estão no repositório público
 https://github.com/pythonfluente/pythonfluente2e.
 
 Enquanto publicávamos a tradução ao longo de 2023,
 muitas correções foram enviadas por leitores como __issues__ (defeitos) ou __pull requests__ (correções)
-no https://fpy.li/4k[repositório]. Agradeceço a todas as pessoas que colaboraram!
+no «repositório» [.small]#&#91;fpy.li/4k&#93;#. Agradeceço a todas as pessoas que colaboraram!
 
 
 [NOTE]
 ====
 Correções e sugestões de melhorias são bem vindas!
 Para contribuir, veja os
-https://fpy.li/4m[__issues__]
+«__issues__» [.small]#&#91;fpy.li/4m&#93;#
 no repositório https://github.com/pythonfluente/pythonfluente2e.
 
 Contamos com sua colaboração. 🙏
@@ -386,7 +385,7 @@ no Brasil pela Editora Novatec em 2015, sob licença da O'Reilly.
 
 Entre 2020 e 2022, atualizei e expandi bastante o livro para a segunda edição.
 Sou muito grato à liderança da
-https://fpy.li/4n[Thoughtworks Brasil]
+«Thoughtworks Brasil» [.small]#&#91;fpy.li/4n&#93;#
 por terem me apoiado enquanto passei a maior parte de 2020 e 2021
 pesquisando, escrevendo, e revisando esta edição.
 
@@ -396,7 +395,7 @@ segunda edição em PT-BR com uma licença livre,
 como uma contribuição para comunidade Python lusófona.
 
 A O'Reilly autorizou que essa tradução fosse publicada sob a licença CC BY-NC-ND:
-https://fpy.li/4j[Creative Commons — Atribuição-NãoComercial-SemDerivações 4.0 Internacional].
+«Creative Commons — Atribuição-NãoComercial-SemDerivações 4.0 Internacional» [.small]#&#91;fpy.li/4j&#93;#.
 Com essa mudança contratual,
 a Editora Novatec não teve interesse em traduzir e publicar a segunda edição.
 
@@ -407,7 +406,7 @@ Hoje ele presta serviços editoriais,
 inclusive faz traduções com a excelente qualidade desta aqui.
 
 Contratei PC para traduzir. Estou fazendo a revisão técnica,
-gerando os arquivos HTML com https://fpy.li/4p[Asciidoctor]
+gerando os arquivos HTML com «Asciidoctor» [.small]#&#91;fpy.li/4p&#93;#
 e publicando em https://PythonFluente.com.
 Estamos trabalhando diretamente a partir do _Fluent Python, Second Edition_
 da O'Reilly, sem aproveitar a tradução da primeira edição, cujo copyright

vol1/amostra.adoc

@@ -16,6 +16,17 @@
 :toclevels: 2
 :!chapter-signifier:
 
+O sinalizador da nova «sintaxe de strings de formato» [fpy.li/2f]
+usada nas _f-strings_ e...
+
+O sinalizador da nova https://fpy.li/2f[sintaxe de strings de formato]
+usada nas _f-strings_ e...
+
+O sinalizador da nova «sintaxe de strings de formato» [.small]#[fpy.li/2f]#
+usada nas _f-strings_ e...
+
+O sinalizador da nova «sintaxe de strings de formato» [.small]##[fpy.li/2f]##
+usada nas _f-strings_ e...
 
 
 ----