pythonfluente2e icon indicating copy to clipboard operation
pythonfluente2e copied to clipboard

[ERRATA] capítulo 7, diagramação

Open marianajo opened this issue 3 months ago • 2 comments

Versão do Preprint 2a pré-impressão

Tentei aqui apontar a presença de órfãs e viúvas e outros problemas de diagramação, visando a melhor experiência de leitura.

Página lógica 314

Defeito Viúva no topo da página.

  • [ ] Rearranjar o texto para que essa linha caiba na página anterior, ou que uma linha da página anterior seja movida para essa.

Página lógica 314

Defeito

  • [ ] Exemplo 108. Quebra de linha num lugar que prejudica a leitura. Recomendação: mover o item 3 para a próxima página, para que o código de entrada fique na mesma página que seu retorno.

Página lógica 315

Defeito

  • [ ] Quadro informativo "A ideia comum de sum...". A quebra fixa esquisita. Recomendação, começar o quadro informativo na próxima página. Não sei dizer se tecnicamente isso é uma órfã, mas parece que sim.

Página lógica 316

Defeito Primeiro parágrafo da seção 7.4.

  • [ ] Palavra "Python" órfã numa linha. Como você já não está usando texto justificado, não sei se há como corrigir isso bem no gerador que você utiliza atualmente.

Página lógica 317

Defeito Viúva no início da página.

  • [ ] Trazer para a página anterior OU adicionar a última linha da página anterior a esta.

Página lógica 317

Defeito

  • [ ] Título do quadro "A receita de Fredrik...". Palavra órfã no título.

Ao invés de diagramar o título como

A receita de Fredrik Lundh para refatoração de lambdas

Fazer de tal forma:

A receita de Fredrik Lundh para refatoração de lambdas

Ou até mesmo

A receita de Fredrik Lundh para
refatoração de lambdas


Página lógica 318 e 319

Defeito A quebra de texto no final da 318 deixa uma órfã nesta página e uma viúva na próxima página.

  • [ ] Rediagramar o texto a fim de remover ambos problemas de uma vez

Página lógica 319

Defeito

  • [ ] Título da seção 319. Palavra órfã "usuário" no título.

Ao invés de

Tipos invocáveis definidos pelo usuário

Diagramar como

Tipos invocáveis definidos pelo usuário


Página lógica 325

Defeito

  • [ ] Quebra no começo do código do exemplo 116. Acho que o ideal é mover todo o exemplo para a próxima página.

Página lógica 329

Defeito

  • [ ] Órfã no final da página.

Página lógica 333

Defeito

  • [ ] Viúva no início da página.
  • [ ] Órfã no fim da página

marianajo avatar Sep 04 '25 01:09 marianajo

@marianajo muito grato por essas sugestões de diagramação!

Essas correções que você sugere são muito bem-vindas mas eu só vou aplicá-las na última etapa da revisão, porque outras mudanças podem afetar a paginação do texto. As quebras nos títulos também são algo para depois, porque eu posso ajustar a fonte e daí as quebras serão diferentes.

Obrigado por organizar tão bem seu feedback, separando os issues logicamente e também colocando [ ] para facilitar o controle!

ramalho avatar Sep 04 '25 13:09 ramalho

Sim, imaginei isso mesmo. Geralmente a diagramação é o último passo. Achei melhor pecar pelo excesso e por isso também deixei numa issue separada. Conte comigo pra essa próxima etapa de revisão também!

marianajo avatar Sep 04 '25 18:09 marianajo