reiniciar numeração de exemplos e figuras em cada capítulo

ramalho · ramalho · commit b0c3f02b8fbd · 2025-09-02T12:39:29.000-03:00
diff --git a/online/cap01.adoc b/online/cap01.adoc
@@ -1,5 +1,7 @@
 [[ch_data_model]]
 == O modelo de dados de Python
+:example-number: 0
+:figure-number: 0
 
 [quote, Jim Hugunin, criador do Jython&#x002C; co-criador do AspectJ&#x002C; e arquiteto do .Net DLR—Dynamic Language Runtime]
 ____
diff --git a/online/cap02.adoc b/online/cap02.adoc
@@ -1,5 +1,7 @@
 [[ch_sequences]]
 == Uma coleção de sequências
+:example-number: 0
+:figure-number: 0
 
 [quote, Leo Geurts&#x002C; Lambert Meertens&#x002C; and Steven Pembertonm, <em>ABC Programmer's Handbook</em> (Bosko Books) p.8]
 ____
@@ -1112,7 +1114,7 @@ da Universidade de Stanford, escreveu o
 https://fpy.li/2-11[_lis.py_]:
 um interpretador de um subconjunto do dialeto Scheme da linguagem de programação Lisp,
 em 132 belas linhas de código Python legível.
-Peguei o código fonte de Norvig (publicado sob a licença MIT) e o atualizei para Python 3.10,
+Peguei o código-fonte de Norvig (publicado sob a licença MIT) e o atualizei para Python 3.10,
 para exemplificar o _pattern matching_.
 Nessa seção, vamos comparar uma parte fundamental do código de Norvig—que usa `if/elif` e
 desempacotamento—com uma nova versão usando `match/case`.
diff --git a/online/cap03.adoc b/online/cap03.adoc
@@ -1,5 +1,7 @@
 [[ch_dicts_sets]]
 == Dicionários e conjuntos
+:example-number: 0
+:figure-number: 0
 
 [quote, Lalo Martins, pioneiro do nomadismo digital e pythonista]
 ____
diff --git a/online/cap04.adoc b/online/cap04.adoc
@@ -1,5 +1,7 @@
 [[ch_str_bytes]]
 == Texto em Unicode versus Bytes
+:example-number: 0
+:figure-number: 0
 
 [quote, Esther Nam e Travis Fischer]
 ____
@@ -511,9 +513,9 @@ print('Olá, Mundo!')
 
 [TIP]
 ====
-Agora que o código fonte de Python 3 não está mais limitado ao ASCII,
+Agora que o código-fonte de Python 3 não está mais limitado ao ASCII,
 e por default usa a excelente codificação UTF-8, a melhor "solução" para
-código fonte em codificações antigas como `'cp1252'` é converter tudo para UTF-8 de uma vez,
+código-fonte em codificações antigas como `'cp1252'` é converter tudo para UTF-8 de uma vez,
 e não se preocupar com os comentários `coding`.
 Se seu editor não suporta UTF-8, é hora de trocar de editor.
 ====
@@ -572,7 +574,7 @@ https://fpy.li/4-8["Chardet--The Universal Character Encoding Detector (_Chardet
 trabalha para descobrir cada uma das mais de 30 codificações suportadas.
 _Chardet_ é uma biblioteca Python que pode ser usada em seus programas,
 mas que também inclui um utilitário de linha de comando, `chardetect`.
-Veja como ele analisa o código fonte desse capítulo:
+Veja como ele analisa o código-fonte desse capítulo:
 
 [source,bash]
 ----
@@ -1569,7 +1571,7 @@ Você pode usar a função `name()` para criar aplicações que permitem aos usu
 A <<cf_demo_fig>> demonstra o script de linha de comando _cf.py_,
 que recebe como argumentos uma ou mais palavras,
 e lista os caracteres que tem aquelas palavras em seus nomes Unicode oficiais.
-O código fonte completo de _cf.py_ aparece no <<ex_cfpy>>.
+O código-fonte completo de _cf.py_ aparece no <<ex_cfpy>>.
 
 [[cf_demo_fig]]
 .Usando _cf.py_ para encontrar gatos sorridentes.
diff --git a/online/cap05.adoc b/online/cap05.adoc
@@ -1,5 +1,7 @@
 [[ch_dataclass]]
 == Fábricas de classes de dados
+:example-number: 0
+:figure-number: 0
 
 [quote, Martin Fowler & Kent Beck]
 ____
diff --git a/online/cap06.adoc b/online/cap06.adoc
@@ -1,5 +1,7 @@
 [[ch_refs_mut_mem]]
 == Referências, mutabilidade, e memória
+:example-number: 0
+:figure-number: 0
 
 [quote, Adaptado de “Alice Através do Espelho e o que Ela Encontrou Lá”, de Lewis Caroll]
 ____
diff --git a/online/cap07.adoc b/online/cap07.adoc
@@ -1,5 +1,7 @@
 [[ch_func_objects]]
 == Funções como objetos de primeira classe
+:example-number: 0
+:figure-number: 0
 
 [quote, Guido van Rossum, BDFL de Python]
 ____
@@ -782,7 +784,7 @@ functools.partial(<function tag at 0x10206d1e0>, 'img', class_='pic-frame')  <4>
 <1> Importa `tag` do <<tagger_ex>> e mostra seu ID.
 <2> Cria a função `picture` a partir de `tag`, fixando o primeiro argumento posicional em `'img'` e o argumento nomeado `class_` em `'pic-frame'`.
 <3> `picture` funciona como esperado.
-<4> `partial()` devolve um objeto `functools.partial`.footnote:[O https://fpy.li/7-9[código fonte] de _functools.py_ revela que `functools.partial` é implementada em C e é usada por default.
+<4> `partial()` devolve um objeto `functools.partial`.footnote:[O https://fpy.li/7-9[código-fonte] de _functools.py_ revela que `functools.partial` é implementada em C e é usada por default.
 Se ela não estiver disponível, uma implementação em Python puro de `partial` está disponível desde Python 3.4.]
 <5> Um objeto `functools.partial` tem atributos que fornecem acesso à função original e aos argumentos fixados.
 
diff --git a/online/cap08.adoc b/online/cap08.adoc
@@ -1,5 +1,7 @@
 [[ch_type_hints_def]]
 == Dicas de tipo em funções
+:example-number: 0
+:figure-number: 0
 
 [quote, Guido van Rossum&#44; Jukka Lehtosalo&#44; and Łukasz Langa, PEP 484—Type Hints]
 ____
@@ -555,7 +557,7 @@ birds.py:16: error: "Bird" has no attribute "quack"
 Found 1 error in 1 file (checked 1 source file)
 ----
 
-Só de analisar o código fonte, Mypy percebe que `alert_bird` é problemático:
+Só de analisar o código-fonte, Mypy percebe que `alert_bird` é problemático:
 a dica de tipo declara o parâmetro `birdie` como do tipo `Bird`,
 mas o corpo da função chama `birdie.quack()` — e a classe `Bird` não tem esse método.
 
@@ -1300,7 +1302,7 @@ e a forma de encontrar o caractere chamado `'DIGIT EIGHT'`:
 {'8'}
 ----
 
-O <<charindex_ex>> mostra o código fonte de _charindex.py_ com a função `name_index`.
+O <<charindex_ex>> mostra o código-fonte de _charindex.py_ com a função `name_index`.
 Além de uma dica de tipo `dict[]`, este exemplo tem três outros aspectos que estão aparecendo pela primeira vez no livro.
 
 
@@ -1946,7 +1948,7 @@ a solução para anotar o parâmetro `series` de `top` era dizer "O tipo nominal
 desde que ele implemente o método `+__lt__+`."
 Em Python, o duck typing sempre permitiu dizer isso de forma implícita,
 deixando os checadores de tipos estáticos sem ação.
-Um verificador de tipo não consegue ler o código fonte em C do CPython,
+Um verificador de tipo não consegue ler o código-fonte em C do CPython,
 ou executar experimentos no console para descobrir que `sorted` só requer que seus elementos suportem `<`.
 
 Agora podemos tornar o duck typing explícito para os verificadores estáticos de tipo.
diff --git a/online/cap09.adoc b/online/cap09.adoc
@@ -1,5 +1,7 @@
 [[ch_closure_decorator]]
 == Decoradores e Clausuras
+:example-number: 0
+:figure-number: 0
 
 [quote, PEP 318—Decorators for Functions and Methods ("Decoradores para Funções e Métodos"—EN)]
 ____
diff --git a/online/cap10.adoc b/online/cap10.adoc
@@ -1,5 +1,7 @@
 [[ch_design_patterns]]
 == Padrões de projetos com funções de primeira classe
+:example-number: 0
+:figure-number: 0
 
 [quote, Ralph Johnson, co-autor do clássico "Padrões de Projetos"]
 ____
diff --git a/online/cap11.adoc b/online/cap11.adoc
@@ -1,6 +1,7 @@
 [[ch_pythonic_obj]]
 == Um objeto pythônico
-
+:example-number: 0
+:figure-number: 0
 
 [quote, Martijn Faassen, criador de frameworks Python e JavaScript]
 ____
diff --git a/online/cap12.adoc b/online/cap12.adoc
@@ -1,5 +1,7 @@
 [[ch_seq_methods]]
 == Métodos especiais para sequências
+:example-number: 0
+:figure-number: 0
 
 [quote, Alex Martelli]
 ____
diff --git a/online/cap13.adoc b/online/cap13.adoc
@@ -1,5 +1,7 @@
 [[ch_ifaces_prot_abc]]
 == Interfaces, protocolos, e ABCs
+:example-number: 0
+:figure-number: 0
 
 ++++
 <blockquote>
@@ -319,7 +321,7 @@ O truque é que `set_card` pressupõe que o `deck` tem um atributo chamado `+_ca
 e seu valor deve ser uma sequência mutável.
 A função `set_cards` é então anexada à classe `FrenchDeck` class como o método especial `+__setitem__+`.
 Isso é um exemplo de _monkey patching_:
-modificar uma classe ou módulo durante a execução, sem tocar no código fonte.
+modificar uma classe ou módulo durante a execução, sem tocar no código-fonte.
 O "monkey patching" é poderoso, mas o código que executa a modificação
 fica muito intimamente acoplado ao programa sendo modificado,
 muitas vezes trabalhando com atributos privados e não-documentados.
diff --git a/online/cap14.adoc b/online/cap14.adoc
@@ -1,5 +1,7 @@
 [[ch_inheritance]]
 == Herança: para o bem ou para o mal
+:example-number: 0
+:figure-number: 0
 
 [quote, Alan Kay, Os Primórdios de Smalltalk]
 ____
diff --git a/online/cap15.adoc b/online/cap15.adoc
@@ -1,5 +1,7 @@
 [[ch_more_types]]
 == Mais dicas de tipo
+:example-number: 0
+:figure-number: 0
 
 [quote, Guido van Rossum, um fã do Monty Python]
 ____
diff --git a/online/cap16.adoc b/online/cap16.adoc
@@ -1,5 +1,7 @@
 [[ch_op_overload]]
 == Sobrecarga de operadores
+:example-number: 0
+:figure-number: 0
 
 [quote, James Gosling, Criador de Java]
 ____
diff --git a/online/cap17.adoc b/online/cap17.adoc
@@ -1,5 +1,7 @@
 [[ch_generators]]
 == Iteradores, geradores e corrotinas clássicas
+:example-number: 0
+:figure-number: 0
 
 //++++
 //<blockquote>
diff --git a/online/cap18.adoc b/online/cap18.adoc
@@ -1,5 +1,7 @@
 [[ch_with_match]]
 == Instruções with, match, e blocos else
+:example-number: 0
+:figure-number: 0
 
 [quote, Raymond Hettinger, um eloquente evangelista de Python]
 ____
@@ -256,7 +258,7 @@ include::../code/18-with-match/mirror_gen.py[tags=MIRROR_GEN_DEMO_1]
 ====
 <1> A única diferença do <<looking_glass_demo_1>> é o nome do gerenciador de contexto:`looking_glass` em vez de `LookingGlass`.
 
-O decorador `contextlib.contextmanager` envolve a função em uma classe que implementa os métodos `+__enter__+` e `+__exit__+`.footnote:[A classe real se chama `_GeneratorContextManager`. Se você quiser saber exatamente como ela funciona, leia seu https://fpy.li/18-10[código fonte] na __Lib/contextlib.py__ de Python 3.10.]
+O decorador `contextlib.contextmanager` envolve a função em uma classe que implementa os métodos `+__enter__+` e `+__exit__+`.footnote:[A classe real se chama `_GeneratorContextManager`. Se você quiser saber exatamente como ela funciona, leia seu https://fpy.li/18-10[código-fonte] na __Lib/contextlib.py__ de Python 3.10.]
 
 O método `+__enter__+` daquela classe:
 
@@ -416,7 +418,7 @@ A iteração é feita com recursão.
 Observe que não há atribuições nos exemplos em Python e Scheme. O uso extensivo de recursão e o uso mínimo de atribuição são marcas registradas do estilo funcional de programação.footnote:[Para tornar a iteração por recursão prática e eficiente, o Scheme e outras linguagens funcionais implementam _chamadas de cauda apropriadas (ou otimizadas)_. Para ler mais sobre isso, veja o <<soapbox_with_match>>.]
 
 Agora vamos revisar o código da versão Python 3.10 do _lis.py_.
-O código fonte completo, com testes, está
+O código-fonte completo, com testes, está
 no diretório
 https://fpy.li/18-15[_18-with-match/lispy/py3.10/_],
 do repositório https://fpy.li/code[_fluentpython/example-code-2e_] no Github.((("", startref="scheme18")))((("", startref="LPIschemesyn18")))
diff --git a/online/cap19.adoc b/online/cap19.adoc
@@ -1,5 +1,7 @@
 [[ch_concurrency_models]]
 == Modelos de concorrência em Python
+:example-number: 0
+:figure-number: 0
 
 [quote, Rob Pike, Co-criador da linguagem Go]
 ____
diff --git a/online/cap20.adoc b/online/cap20.adoc
@@ -1,5 +1,7 @@
 [[ch_executors]]
 == Executores concorrentes
+:example-number: 0
+:figure-number: 0
 
 ++++
 <blockquote>
diff --git a/online/cap21.adoc b/online/cap21.adoc
@@ -1,5 +1,7 @@
 [[ch_async]]
 == Programação assíncrona
+:example-number: 0
+:figure-number: 0
 
 ++++
 <blockquote>
diff --git a/online/cap22.adoc b/online/cap22.adoc
@@ -1,6 +1,7 @@
 [[ch_dynamic_attrs]]
 == Atributos dinâmicos e propriedades
-
+:example-number: 0
+:figure-number: 0
 
 [quote, Martelli&#x2c; Ravenscroft &#x26; Holden, Why properties are important (Porque propriedades são importantes)]
 ____
diff --git a/online/cap23.adoc b/online/cap23.adoc
@@ -1,5 +1,7 @@
 [[ch_descriptors]]
 == Descritores de Atributos
+:example-number: 0
+:figure-number: 0
 
 [quote, Raymond Hettinger, guru de Python e um de seus desenvolvedores principais]
 ____
diff --git a/online/cap24.adoc b/online/cap24.adoc
@@ -1,5 +1,7 @@
 [[ch_class_metaprog]]
 == Metaprogramação de classes
+:example-number: 0
+:figure-number: 0
 
 [quote, Brian W. Kernighan and P. J. Plauger, The Elements of Programming Style]
 ____
@@ -299,7 +301,7 @@ include::../code/24-class-metaprog/checked/initsub/checkedlib.py[tags=MOVIE_TYPE
 .Subclasses de `Checked` e a verificação estática de tipos
 [WARNING]
 ====
-Em um arquivo de código fonte _.py_ contendo uma instância `movie` da classe `Movie`, como definida no <<checked_demo1_ex>>, o Mypy marca essa atribuição como um erro de tipo:
+Em um arquivo de código-fonte _.py_ contendo uma instância `movie` da classe `Movie`, como definida no <<checked_demo1_ex>>, o Mypy marca essa atribuição como um erro de tipo:
 
 [source, python]
 ----
diff --git a/print/1/experimento-1/cap02.adoc b/print/1/experimento-1/cap02.adoc
@@ -1103,7 +1103,7 @@ secondary-sortas="lis.py", id="PMinterp02")))((("Scheme language", id="scheme02"
 da Universidade de Stanford, escreveu o
 https://fpy.li/2-11[_lis.py_]:
 um interpretador de um subconjunto do dialeto Scheme da linguagem de programação Lisp, em 132 belas linhas de código Python legível.
-Peguei o código fonte de Norvig (publicado sob a licença MIT) e o atualizei para Python 3.10, para exemplificar o _pattern matching_.
+Peguei o código-fonte de Norvig (publicado sob a licença MIT) e o atualizei para Python 3.10, para exemplificar o _pattern matching_.
 Nessa seção, vamos comparar uma parte fundamental do código de Norvig—que usa `if/elif` e desempacotamento—com uma nova versão usando `match/case`.
 
 As duas funções principais do _lis.py_ são `parse` e `evaluate`.footnote:[A última é chamada `eval` no código original;
diff --git a/print/1/experimento-1/cap04.adoc b/print/1/experimento-1/cap04.adoc
@@ -506,9 +506,9 @@ print('Olá, Mundo!')
 
 [TIP]
 ====
-Agora que o código fonte de Python 3 não está mais limitado ao ASCII,
+Agora que o código-fonte de Python 3 não está mais limitado ao ASCII,
 e por default usa a excelente codificação UTF-8, a melhor "solução" para
-código fonte em codificações antigas como `'cp1252'` é converter tudo para UTF-8 de uma vez,
+código-fonte em codificações antigas como `'cp1252'` é converter tudo para UTF-8 de uma vez,
 e não se preocupar com os comentários `coding`.
 E se seu editor não suporta UTF-8, é hora de trocar de editor.
 ====
@@ -566,7 +566,7 @@ https://fpy.li/4-8["Chardet--The Universal Character Encoding Detector (_Chardet
 trabalha para descobrir cada uma das mais de 30 codificações suportadas.
 _Chardet_ é uma biblioteca Python que pode ser usada em seus programas,
 mas que também inclui um utilitário de linha de comando, `chardetect`.
-Aqui está a forma como ele analisa o código fonte desse capítulo:
+Aqui está a forma como ele analisa o código-fonte desse capítulo:
 
 [source,bash]
 ----
@@ -1555,7 +1555,7 @@ Você pode usar a função `name()` para criar aplicações que permitem aos usu
 A <<cf_demo_fig>> demonstra o script de linha de comando _cf.py_,
 que recebe como argumentos uma ou mais palavras,
 e lista os caracteres que tem aquelas palavras em seus nomes Unicode oficiais.
-O código fonte completo de _cf.py_ aparece no <<ex_cfpy>>.
+O código-fonte completo de _cf.py_ aparece no <<ex_cfpy>>.
 
 [[cf_demo_fig]]
 .Usando _cf.py_ para encontrar gatos sorridentes.
diff --git a/vol1/cap01.adoc b/vol1/cap01.adoc
@@ -1,5 +1,7 @@
 [[ch_data_model]]
 == O modelo de dados de Python
+:example-number: 0
+:figure-number: 0
 
 [quote, Jim Hugunin, criador do Jython&#x002C; co-criador do AspectJ&#x002C; e arquiteto do .Net DLR—Dynamic Language Runtime]
 ____
diff --git a/vol1/cap02.adoc b/vol1/cap02.adoc
@@ -1,5 +1,7 @@
 [[ch_sequences]]
 == Uma coleção de sequências
+:example-number: 0
+:figure-number: 0
 
 [quote, Leo Geurts&#x002C; Lambert Meertens&#x002C; and Steven Pembertonm, <em>ABC Programmer's Handbook</em> (Bosko Books) p.8]
 ____
@@ -1113,7 +1115,7 @@ da Universidade de Stanford, escreveu o
 «_lis.py_» [.small]#&#91;fpy.li/2-11&#93;#:
 um interpretador de um subconjunto do dialeto Scheme da linguagem de programação Lisp,
 em 132 belas linhas de código Python legível.
-Peguei o código fonte de Norvig (publicado sob a licença MIT) e o atualizei para Python 3.10,
+Peguei o código-fonte de Norvig (publicado sob a licença MIT) e o atualizei para Python 3.10,
 para exemplificar o _pattern matching_.
 Nessa seção, vamos comparar uma parte fundamental do código de Norvig—que usa `if/elif` e
 desempacotamento—com uma nova versão usando `match/case`.
diff --git a/vol1/cap03.adoc b/vol1/cap03.adoc
@@ -1,5 +1,7 @@
 [[ch_dicts_sets]]
 == Dicionários e conjuntos
+:example-number: 0
+:figure-number: 0
 
 [quote, Lalo Martins, pioneiro do nomadismo digital e pythonista]
 ____
diff --git a/vol1/cap04.adoc b/vol1/cap04.adoc
diff --git a/vol1/cap05.adoc b/vol1/cap05.adoc
diff --git a/vol1/cap06.adoc b/vol1/cap06.adoc
diff --git a/vol1/cap07.adoc b/vol1/cap07.adoc
diff --git a/vol1/cap08.adoc b/vol1/cap08.adoc
