Pular para o conteúdo principal

Capítulo 9 · Parte II · O ofício

Quadrinhos

Como o Postext compõe quadrinhos e mangás a partir de Markdown: páginas de quadrinhos cortadas por uma árvore de divisões, desenhos dos quadros recortados em torno da área segura, letreiramento gerado a partir de um roteiro (fala, pensamento, sussurro, grito, rádio, recordatórios, onomatopeias), estilos de balão, âncoras dos personagens nos desenhos, tiras no meio do texto, páginas duplas, leitura da direita para a esquerda e letreiramento vertical, traduções e as saídas em canvas, PDF, HTML e EPUB

Atualizado 2026-10-1941 minenescadefritptzhjaar

Em poucas palavras

Esta página explica como fazer uma história em quadrinhos com o Postext. Os desenhos são os quadros, e tudo o que os personagens dizem, pensam ou ouvem é escrito como texto no arquivo Markdown. O Postext coloca os quadros na página e desenha sozinho os balões, os recordatórios e as onomatopeias em volta das palavras. Para traduzir a HQ, você reescreve só as palavras, e o Postext faz o letreiramento de novo no outro idioma: o japonês em colunas, o árabe da direita para a esquerda. A página trata também das tiras dentro de um livro, das páginas que ocupam duas páginas lado a lado, das saídas e dos limites que ainda existem.

Os desenhos são os quadros; tudo o que é dito, pensado, narrado ou ouvido é texto no Markdown.

Uma história em quadrinhos no Postext é um conjunto de desenhos e um roteiro. Os desenhos são recursos bitmap ou SVG comuns, feitos sem nenhum texto por cima. O roteiro fica no Markdown do capítulo: um bloco :::page corta uma página em quadros, dá a cada quadro o desenho e lista, linha por linha, os balões, os recordatórios e as onomatopeias daquele quadro. O Postext distribui os quadros, recorta cada desenho para a célula dele sem cortar o que importa, compõe o texto na fonte de letreiramento do livro em um único corpo, desenha um balão em volta dele, aponta o rabicho para quem fala e posiciona os balões na ordem de leitura onde não cubram nenhum rosto. Uma tradução é outro arquivo Markdown com os mesmos quadros e outras palavras; o Postext refaz o letreiramento do zero, em colunas para o japonês e da direita para a esquerda para o árabe.

Os quadrinhos só entram em ação quando usados: um documento sem :::page nem :::strip é diagramado exatamente como antes. As configurações ficam na seção comics da configuração, e a marcação está resumida em Formato do documento › Quadrinhos.

Quadrinhos no Postext: páginas, quadros e balões letreirados pelo motor, à mão ou com IAAssistir no YouTube (abre em uma nova aba) · O player é carregado do YouTube quando você aperta o play.

#Páginas de quadrinhos

Um bloco :::page é uma página de quadrinhos. Ele abre com uma linha :::page{…}, contém uma linha ::panel por quadro, cada uma seguida do roteiro daquele quadro, e fecha com um ::: sozinho:

:::page{split="30 [30 | 20 | *] / *" gutter=4mm}
::panel{art=lh-arrive}
caption: Every summer, Maya spent a week at the lighthouse.
maya: Grandpa! I'm here!
::panel{art=lh-radio}
tomas: Just in time. The radio's gone deaf,
tomas: and there's a storm on the way.
::panel{art=lh-maya}
maya{thought}: That valve looks loose…
::panel{art=lh-beam bleed}
sfx{rotate=-8}: KRAK
tomas{shout}: Hold on to the rail!
:::

O bloco sempre começa em uma página nova e ocupa a página inteira. O texto depois da linha de fechamento começa na página seguinte; por isso, dois blocos :::page seguidos formam duas páginas de quadrinhos, e um :::pagebreak entre eles não acrescenta nenhuma página. O motor lê o corpo por conta própria, linha por linha, como lê :::verse: blocos Markdown, contêineres e outras diretivas não são reconhecidos dentro dele, e <!-- comments --> são ignorados, inclusive quando ocupam várias linhas.

O papel da página é 'comic' (VDTPage.role). Ela não leva cabeços nem fólio, já que uma página de quadrinhos é só quadros, mas conta na numeração das páginas; comics.runningHeads: true os imprime. Os quadros são cortados a partir da moldura, que é a área de conteúdo da página dentro das margens, a não ser que comics.frame.margins dê às páginas de quadrinhos margens próprias.

Os atributos da linha de abertura:

AtributoEfeito
split="…"Como a moldura é cortada em células (veja Dividir a página). Sem ele, os quadros são empilhados em fileiras de mesma altura.
gutter=4mm, gutter="4mm 2mm"O espaço entre as fileiras e, quando há um segundo valor, entre quadros lado a lado. Um número sem unidade está em milímetros. Sem ele: comics.gutter (4 mm e 2 mm).
style=…Um estilo de quadro nomeado para todos os quadros da página (comics.panelStyles).
bleedTodo quadro que toca a moldura se estende até o refile e entra na sangria.
direction=rtl, dir=ltrO sentido de leitura desta página, seja qual for o da configuração (veja Sentido de leitura).
spreadDistribui a página por duas páginas lado a lado (veja Páginas duplas).

#Dividir a página

O atributo split descreve a página como uma árvore de cortes. Uma lista de tamanhos separados por / empilha células de cima para baixo (fileiras); uma lista separada por | as coloca lado a lado, a partir do lado por onde a página é lida. Um tamanho seguido de uma lista entre colchetes corta essa célula de novo no outro eixo. A página do exemplo acima, 30 [30 | 20 | *] / *, é uma fileira com 30 % da altura da moldura, cortada em quadros com 30 % e 20 % da largura dela e um terceiro que fica com o resto, sobre uma segunda fileira que ocupa o resto da página:

A divisão 30 [30 | 20 | *] / *A moldura de uma página cortada pela divisão 30 [30 | 20 | *] / *. Uma primeira fileira ocupa 30 % da altura e é cortada em três quadros: 30 % da largura, 20 % e o resto. Uma segunda fileira, abaixo, ocupa o resto da página como um único quadro. As sarjetas ficam centradas nas linhas de divisão. Ao lado da página, a divisão aparece desenhada como uma árvore: uma lista de fileiras com dois itens; o primeiro contém uma lista entre colchetes de três colunas. As folhas são os quadros 1 a 4 na ordem de leitura.123430 %20 %*30 %*sarjetasplit="30 [30 | 20 | *] / *"// fileiras, de cima para baixo30** o resto[ | ]| colunas, a partir do início3020*1234quadros na ordem de leitura
Os tamanhos são porcentagens da célula mãe; * fica com o que sobra. Os quadros são numerados na ordem de leitura, que é a ordem da árvore.

A gramática completa:

split := list
list  := item ( "/" item )*  |  item ( "|" item )*
item  := size [ "[" list "]" ]
size  := number ["%"] [ "~" number ["%"] ]  |  "*"  |  (nothing)
  • Tamanhos são porcentagens da célula mãe ao longo do eixo da lista; 30 e 30% são a mesma coisa. Um *, ou um tamanho vazio, fica com uma parte igual do que os tamanhos escritos deixam. O último item de uma lista sempre vai até o fim, seja qual for o tamanho indicado.
  • Um separador por lista. Misturar / e | na mesma lista, deixar um [ sem fechar ou pôr uma lista entre colchetes no mesmo eixo da mãe é um erro de sintaxe (comicSplitSyntax): a parte legível é usada.
  • Passou do total. Tamanhos que somam mais de 100 % são reduzidos de modo que cada * mantenha 5 %, e a página informa comicSplitOverflow.
  • A ordem de leitura é a ordem da árvore: as fileiras de cima para baixo e, dentro de cada fileira, os quadros a partir do lado inicial. As linhas ::panel preenchem as células nessa ordem. Uma página com mais quadros do que células deixa de fora os quadros que sobram; uma com menos deixa as últimas células vazias (comicPanelCount, informado só quando há um split escrito).

Algumas divisões:

DivisãoPágina
*Uma página splash: um único quadro.
33 / 33 / *Três fileiras.
* / * / * / *Quatro fileiras iguais, o yonkoma de uma tira cômica de quatro quadros.
50 [* | *] / 50 [* | * | *]Dois quadros sobre três.
30 / 35 [* | * | *] / *Um quadro largo, três em linha, um quadro largo.
60 | * [50 / *]Um quadro alto no lado inicial e dois empilhados ao lado.
* [40~55 | *] / 35Uma fileira de ação cortada por uma linha inclinada, sobre uma fileira com 35 % de altura.

#Cortes inclinados

Um tamanho escrito a~b produz uma linha inclinada: a borda final da célula vai de a % no início do eixo transversal até b % na outra ponta. Para quadros lado a lado, o início é o topo; por isso, 40~55 | * traça uma linha de 40 % da largura no alto até 55 % embaixo; para fileiras, o início é o lado por onde a página é lida. Os tamanhos se somam em cada ponta separadamente, e as células continuam sendo polígonos convexos. Os cantos arredondados valem só para quadros retangulares; um quadro inclinado mantém os cantos vivos.

#Sarjetas

A sarjeta fica centrada em cada linha de divisão, metade de cada lado, de modo que uma linha escrita a 30 % fica exatamente a 30 % da célula. As linhas inclinadas mantêm a sarjeta do eixo delas, medida na perpendicular à linha. Os valores padrão seguem a página habitual: 4 mm entre fileiras e 2 mm entre os quadros de uma fileira (comics.gutter.horizontal e vertical, ou o atributo gutter da página).

#Sangria

Um quadro com sangria passa da moldura: cada lado dele que toca a moldura é levado até o refile, e até a sangria além dele quando a página tem uma (page.cutLines.bleed). O atributo bleed da página aplica sangria a todos os quadros; o bleed de um quadro aplica só a ele, bleed="top start" só a esses lados (top, bottom, start, end, left, right), e bleed=false a impede. Um estilo de quadro com bleed: true aplica sangria aos quadros dele.

#Recuo interno e quadros sobrepostos

pad deixa um quadro menor do que a célula: de um a quatro valores, na ordem das margens do CSS com lados lógicos (superior, final, inferior, inicial), cada um uma medida ou uma porcentagem da célula. ::panel{art=x pad="0 15%"} dá um quadro mais estreito que a fileira, centralizado nela.

Um quadro com inset="x y w h" não ocupa uma célula: ele é colocado sobre o quadro anterior, naquela posição e tamanho em porcentagens da caixa desse quadro, como um pequeno retrato num canto ou um close sobre um plano geral. O roteiro dele é letreirado dentro dele.

:::page{split="*"}
::panel{art=storm-wide}
caption{at=bottom-start}: The storm broke at midnight.
::panel{art=maya-window inset="62% 6% 32% 30%"}
maya{whisper}: Grandpa?
:::

#Quadros e desenhos

Uma linha ::panel{…} inicia um quadro; o roteiro dele vai até a próxima linha ::panel ou até a linha de fechamento. Um quadro sem art é desenhado vazio na cor de fundo dele, que é como se faz um quadro só de texto. O texto antes do primeiro ::panel é letreirado como recordatório do primeiro quadro e informado como comicStrayText.

AtributoEfeito
art=<id>O desenho do quadro: o id de um recurso bitmap ou SVG. Um id desconhecido deixa o quadro vazio e informa comicUnknownArt.
fit=cover, fit=containcover recorta o desenho para preencher a célula, nunca dentro da área segura; contain o mostra inteiro, com faixas do fundo do quadro. Sem ele: o do estilo de quadro (cover).
focus="70% 40%"O ponto do desenho que fica centralizado quando a área segura deixa margem para escolher.
style=…Um estilo de quadro nomeado para este quadro.
border=none, border=0.5mmSem borda, ou uma borda com essa espessura.
bg=#1b1b2fO fundo do quadro: uma cor, um id da paleta ou none.
bleed, bleed="top start", bleed=falseVeja Sangria.
pad="…"Veja Recuo interno e quadros sobrepostos.
inset="x y w h"Coloca este quadro sobre o anterior em vez de lhe dar uma célula.
pop=<id>Um recorte desenhado por cima da borda (veja Desenho que sai do quadro).
mirror, mirror=falseEspelha o desenho deste quadro, ou o mantém como foi desenhado quando a página espelha os desenhos (veja Sentido de leitura).
alt="…"O texto alternativo do quadro, para o PDF marcado, o HTML e o EPUB. Sem ele: o altText do recurso.
id=…Um id para o quadro, que as saídas HTML e EPUB usam como âncora.
textO corpo do quadro é Markdown composto no bloco do quadro em vez de um roteiro de letreiramento (veja Quadros de texto).
box=<id>Veste o quadro com um estilo de boxe (veja Estilos de boxe).
valign=middle, valign=bottomOnde fica o texto de um quadro de texto no bloco. Sem ele: no alto.
shrink, shrink=0.7Compõe o texto de um quadro de texto menor até caber no bloco, até a metade do tamanho ou a escala indicada (também shrink=70%). Sem ele: até 90 %, e depois cortado.

#Recortar o desenho para a célula

Os desenhos dos quadros são feitos sem levar em conta a forma da célula em que vai parar: a página pode ser dividida de novo, um divisor pode ser arrastado, uma tradução pode pedir uma fileira mais alta. A área segura do desenho (Resource.safeArea, veja Formato do documento › Área segura) indica o que precisa continuar visível, e o recorte é calculado para cada célula:

  1. Com fit=cover, a janela visível tem as proporções da célula e é tão grande quanto o desenho permite.
  2. Ela é posicionada de modo que a área segura fique dentro dela. Onde isso deixa margem, a janela é centralizada em focus quando o quadro define um; caso contrário, as margens fora da área segura são cortadas na proporção dos tamanhos delas, de modo que um tema à esquerda do centro continua à esquerda do centro.
  3. Se nenhuma janela com as proporções da célula consegue conter a área segura (uma célula muito larga para um tema alto), o desenho é mostrado com a área segura inteira e o resto da célula é preenchido com o fundo do quadro. A página informa comicPanelLetterbox. Uma célula mantém inteira a área segura de um desenho W × H enquanto a largura dela dividida pela altura fica entre sw·W/H e W/(sh·H), onde sw e sh são a largura e a altura da área segura em frações.

Um desenho sem área segura é recortado em torno do centro, ou em torno de focus. Um SVG sem tamanho intrínseco preenche a célula tal como é. Os renderizadores recortam no polígono da célula e desenham o desenho inteiro no tamanho dele, sem recorte; por isso, o recorte nunca reamostra a imagem.

#Estilos de quadro

A aparência de um quadro vem de comics.panel (uma borda preta de 1 pt, fundo branco, cover), de um estilo nomeado em comics.panelStyles que uma página ou um quadro escolhe com style=, e do border e do bg do próprio quadro. Uma borda pode ser solid, none ou rough: um traço feito à mão que treme um pouco, igual em todas as compilações, já que o tremor é gerado a partir do quadro. Veja Configuração › Quadrinhos para todos os campos.

#Desenho que sai do quadro

Uma borda rompida, quando um personagem ou um objeto sai do quadro, exige dois desenhos: o desenho do quadro, recortado na célula como de costume, e um recorte transparente da parte que sai, indicado com pop. O recorte é cortado e posicionado exatamente como o desenho (ele deve ter o mesmo tamanho do desenho) e desenhado depois da borda, sem recorte, de modo que cobre a borda e a sarjeta. Os recortes de uma página são desenhados depois de todos os quadros; por isso, o que alcança o quadro ao lado também aparece sobre ele, e sob todos os balões.

::panel{art=gull-sky pop=gull-cutout bleed="top"}
sfx{at="70% 20%"}: SKRAAW

#Letreiramento

Abaixo de cada linha ::panel vem o roteiro do quadro, um balão por linha:

key{attributes}: text

A chave é um id de personagem (letras, algarismos, _, . e -), o mesmo em todas as traduções; ela corresponde às âncoras dos desenhos e ao elenco. Três chaves são reservadas: caption (um recordatório de narração), sfx (uma onomatopeia, sem balão) e note (uma nota do editor). Os dois-pontos podem ser o : de largura total que um método de entrada chinês ou japonês digita. O texto é Markdown em linha: *emphasis* e **strong** saem em negrito itálico, a convenção do letreiramento (só negrito nas escritas sem itálico), :tcy[12] compõe algarismos atravessados numa coluna vertical, :ruby compõe a leitura em meio corpo sobre a base (ao lado dela numa coluna), e :ltr / :rtl mantêm um trecho no próprio sentido dentro de um balão do sentido oposto. Uma linha recuada com dois espaços ou uma tabulação continua o balão de cima (unida por um espaço, ou sem nenhum entre dois caracteres chineses ou japoneses); uma barra invertida no fim de uma linha quebra ali o texto do balão. Linhas em branco são ignoradas, e uma linha que não é uma linha de roteiro é letreirada como recordatório e informada como comicStrayText.

::panel{art=lh-radio}
tomas: Just in time.
  The radio's gone deaf,\
  and there's a storm on the way.
biscuit{to="40% 70%"}: Mrrp?
note: Valve radios warm up for a minute before they speak.

Os atributos de uma linha de roteiro:

AtributoEfeito
{whisper}, style=whisperO estilo de balão. Uma palavra solta entre as chaves indica um estilo: thought, whisper, shout, radio, inner, ou um dos estilos do próprio livro. Um nome desconhecido informa comicUnknownBalloonStyle, e a linha fica com o estilo da chave dela.
at="62% 40%"Fixa o centro do balão nesse ponto do desenho do quadro (da célula, quando o quadro não tem desenho). O ponto está em frações do desenho; por isso, continua no mesmo lugar do desenho apesar de recortes e de arrastos dos divisores.
at=top-startColoca o balão num canto ou numa borda do quadro: top-start, top-end, bottom-start, bottom-end, top, bottom. Recordatórios e notas ficam encostados na borda.
to="40% 70%"Aponta o rabicho para esse ponto do desenho em vez da âncora do personagem. O rabicho se volta para ele e para antes de chegar, como faz diante de uma boca.
tail=none, tail=startSem rabicho, ou um rabicho em direção a um personagem fora do quadro, daquele lado (top, bottom, start, end, left, right). start e end seguem o sentido de leitura da página; left e right são lados do desenho do quadro. tail=auto é o padrão.
join, join=falseUne este balão ao anterior do mesmo personagem, ou o mantém separado, independentemente do que comics.lettering.joinSameSpeaker indique.
breakDeixa o balão atravessar a borda do quadro para a sarjeta ou o quadro seguinte. A travessia não é informada como transbordamento, já que foi pedida; o que o balão cobre do outro lado (um rosto, o balão de outro quadro) continua sendo, e o centro dele fica dentro do próprio quadro.
rotate=-8Gira o balão ou a onomatopeia, em graus, no sentido horário.
skew=-8Inclina as letras esse número de graus (positivo para a frente, como o itálico; negativo para trás), antes de qualquer giro: texto escrito sobre um objeto visto em perspectiva, o título na capa de um livro, uma placa. Com rotate, o letreiramento acompanha ao mesmo tempo a borda superior do objeto e as laterais. Um estilo de balão o define para todas as linhas dele com skew.
size=1.5Muda a escala do letreiramento de uma onomatopeia.
color=#c0392bA cor do letreiramento: uma cor hexadecimal ou um id da paleta.
font="…"A fonte desta linha.
vertical, horizontal, mode=verticalO modo de escrita desta linha, acima do modo do livro: vertical a compõe numa coluna numa edição horizontal (um ドン não traduzido), horizontal numa linha numa edição vertical (uma placa escrita na horizontal). Uma coluna num livro de outro idioma segue as regras do próprio texto (com kana, as do japonês) e usa a entrelinha do letreiramento vertical. Num livro vertical, uma linha sem caracteres chineses ou japoneses é composta na horizontal mesmo assim, a não ser que diga vertical.

#Como um balão é feito

O letreiramento segue os hábitos do letreiramento de quadrinhos, e não os de uma caixa de texto:

  • Um corpo por livro. Todo balão é composto em comics.lettering.fontFamily no corpo comics.lettering.fontSize (7,5 pt por padrão), alterado só pelo fontScale do estilo (um sussurro a 0,9, um grito a 1,15). O texto nunca é reduzido para caber: um balão que não cabe muda de forma, muda de lugar, atravessa a borda ou é informado.
  • Primeiro o texto, depois o balão. As palavras são quebradas em linhas primeiro, buscando um losango: linhas curtas em cima e embaixo, a mais longa no meio, nenhuma última linha muito mais curta que as outras, nenhuma linha terminando em artigo ou preposição quando outra quebra é igualmente boa. Depois o contorno é desenhado em volta das linhas, com a mesma folga de todos os lados.
  • Regras da casa. Três pontos viram reticências (continuam três pontos numa fonte que desenha as reticências como um ponto só); textTransform: 'uppercase' compõe o texto em maiúsculas (as escritas sem caixa ficam como estão, e o ß alemão vira SS); em japonês e chinês, o ponto final que fecha um balão é retirado (dropFinalStop) e os ! e ? ASCII viram as formas de largura total nas colunas, dois deles numa só célula (!? como ⁉); doubleDash letreira um travessão como --, como fazem os quadrinhos americanos.
  • Posicionamento. Os balões de um quadro são posicionados na ordem de leitura dentro do quadro, a comics.lettering.inset da borda (1,5 mm). O primeiro fica perto do topo, no lado inicial, e cada um dos seguintes não deve ficar mais alto que o anterior, a menos que esteja mais adiante no sentido de leitura. Os balões ficam longe dos rostos e das zonas a evitar que os desenhos marcam, longe das bocas dos personagens e uns dos outros, ficam acima ou ao lado do personagem em vez de abaixo, e os rabichos deles não devem se cruzar. Um rabicho nunca atravessa o letreiramento de outro balão. Um balão que sai do quadro, com break ou com um at=, respeita o que os quadros em volta protegem como respeita o que é do próprio quadro: os recordatórios e balões deles, os rabichos desses balões e os rostos e zonas a evitar dos desenhos; o balão de um quadro que tem outro inserido por cima não cobre o inserido. Os recordatórios e as notas com canto vêm primeiro, depois os balões fixados, depois o resto. O posicionamento é determinístico: a mesma página sempre dá os mesmos balões.
  • Na folha. O letreiramento nunca passa do refile. Num quadro com sangria, os balões ficam na parte do quadro dentro da moldura, onde o refile não pode cortá-los; só uma onomatopeia fixada com at= ou marcada com break pode entrar na sangria ao lado do quadro.
  • Quando não cabe. Um balão que não pode ser posicionado sem problemas pode primeiro atravessar a borda (só com break), depois cobrir uma zona a evitar (nunca um rosto), depois assumir uma forma mais larga ou mais estreita. A forma assumida para caber não parte uma palavra chinesa (comics.lettering.strictPlacement, ligado por padrão): uma palavra cortada em duas linhas custa mais do que um balão lido fora de ordem; por isso, o balão se move antes. Uma fala longa numa célula estreita é composta mais ou menos com a largura da célula e invade a sarjeta, em vez de ficar como uma coluna fina sobre o rosto do personagem. Se o balão ainda se sobrepõe a algo, ele é colocado onde faz menos estrago e a página informa comicBalloonOverflow, indicando o quadro e o que ele cobre. Uma travessia pedida, com break ou com um at=, não conta como uma dessas falhas: o aviso então indica só o que o balão cobre. Uma fala mais curta, um quadro maior ou um at= resolvem o problema.

#Rabichos

O rabicho de um balão de fala aponta para a boca do personagem, e as bolhas de um balão de pensamento, para a cabeça (veja Personagens e âncoras). Ele sai do contorno voltado para o personagem, faz uma leve curva e para antes da boca. Quando a âncora do personagem fica fora do quadro por causa do recorte, ou o desenho não marca nenhuma âncora para esse personagem, o rabicho aponta para fora do quadro, em direção à âncora ou à borda mais próxima, e termina na borda. Um balão assim fica junto à borda de onde vem a voz, com um rabicho curto: um rabicho que atravessa o quadro inteiro é lido como uma seta; por isso, é o balão que se move, em vez de o rabicho crescer. to="x% y%" aponta um rabicho para outro ponto do desenho, e tail=start (ou top, bottom, end, left, right) para um personagem fora do quadro daquele lado. Recordatórios, notas e onomatopeias não têm rabicho.

#Balões unidos

Duas falas seguidas do mesmo personagem são unidas, como se letreira a pausa de quem fala: com joinSameSpeaker: 'butt' (o padrão), os dois corpos se sobrepõem e compartilham um só contorno; com 'connector', um gargalo estreito liga os dois; com 'none', eles continuam sendo dois balões com dois rabichos. Só o primeiro balão de um grupo tem rabicho. Uma linha pode pedir um comportamento próprio com join ou join=false.

#Onomatopeias

Uma linha sfx não tem balão: o texto é composto em tamanho grande (2,4 vezes o corpo do letreiramento) na fonte de onomatopeias do idioma do documento, em negrito se essa fonte tiver negrito (Bangers, Dela Gothic One, ZCOOL KuaiLe e Lalezar não têm e ficam no peso regular), com um halo branco em volta das letras para que se leia sobre o desenho. Ela é posicionada perto da âncora sfx do quadro quando o desenho marca uma (uma âncora cujo id é sfx) ou, se não, onde não cubra nenhum rosto. rotate, size, color e font a alteram, e at a fixa. No letreiramento vertical, ela é composta numa coluna de no máximo cinco caracteres. As onomatopeias são pintadas depois de todos os balões da página.

Uma linha pode definir um modo de escrita próprio. Uma edição horizontal de um mangá que mantém uma onomatopeia em japonês a compõe numa coluna:

sfx{vertical size=2.6 font="Dela Gothic One"}: ドン

#Configurações de letreiramento

comics.lettering reúne a fonte, o corpo, a entrelinha, a cor e as regras da casa do livro inteiro. Por padrão, a fonte segue o idioma do documento, e a fonte das onomatopeias também:

IdiomaLetreiramentoOnomatopeias
Latim, grego, cirílico e os demaisComic NeueBangers
JaponêsZen AntiqueDela Gothic One
Chinês simplificadoNoto Sans SCZCOOL KuaiLe
Chinês tradicionalLXGW WenKai TCLXGW WenKai TC
Árabe, persa, urduPlaypen Sans ArabicLalezar

Todas estão no Google Fonts e são carregadas pelo nome, como qualquer outra fonte. Com a altura de linha padrão, os balões verticais e os chineses ou japoneses são compostos com entrelinha de 1,5, e os árabes com 1,45. O letreiramento japonês, chinês e árabe nunca é inclinado, seja qual for o estilo, e o árabe nunca recebe espaçamento entre letras.

#O elenco

comics.cast lista os personagens: um id (a chave do personagem), um name e, opcionalmente, o estilo de balão em que ele fala (balloonStyle, um robô que sempre fala em radio), a color do texto e o fill do balão que o distinguem, e uma fontFamily. O nome é o que as saídas anunciam: o visualizador HTML e o EPUB refluível imprimem “Nome: palavras” em cada fala. Um personagem que está no elenco nunca é informado como desconhecido.

comics: {
  cast: [
    { id: 'maya', name: 'Maya' },
    { id: 'tomas', name: 'Grandpa Tomás' },
    { id: 'beacon', name: 'The beacon', balloonStyle: 'radio', fill: { hex: '#e8f4ff', model: 'hex' } },
  ],
}

#Estilos de balão

Um estilo de balão é um tipo de balão: o contorno, o rabicho e o letreiramento dele. Há nove embutidos, e uma linha de roteiro escolhe um com uma palavra solta entre chaves (ben{whisper}: …). As chaves reservadas tiram o estilo do próprio nome (caption:, sfx:, note:), e todas as outras linhas usam speech, ou o balloonStyle do personagem no elenco.

EstiloContornoRabichoOutros detalhes
speechovalcurvoA base de todos os estilos: preenchimento branco, contorno preto de 0,6 pt, 0,55 em de folga.
thoughtnuvembolhasAs bolhas apontam para a cabeça, não para a boca.
whisperoval, tracejadocurvoTexto a 0,9.
shoutexplosãocunhaTexto a 1,15, em negrito; contorno de 0,8 pt.
radioelétrico (zigue-zague)zigue-zagueUma voz que vem de um rádio, de um telefone ou de uma máquina.
captionretângulonenhumAmarelo-claro, encostado no canto superior inicial, texto alinhado pelo início.
innercaixa arredondadanenhumPreenchimento cinza, itálico: a voz interior de um personagem.
noteretângulonenhumEncostado no canto inferior final, texto a 0,8.
sfxnenhumnenhumTexto a 2,4 na fonte de onomatopeias, em negrito se ela tiver, com um halo branco de 1,5 pt.

comics.balloonStyles os altera e acrescenta outros. Uma entrada com o id de um estilo embutido é aplicada por cima desse estilo; uma entrada com um id novo parte de speech:

comics: {
  balloonStyles: [
    { id: 'caption', fill: { hex: '#ffffff', model: 'hex' }, textTransform: 'uppercase' },
    { id: 'shout', burstPoints: 18, burstDepth: 0.3 },
    { id: 'eerie', shape: 'wavy', stroke: { hex: '#5b4a8a', model: 'hex' }, italic: true },
    { id: 'writing', shape: 'none', tail: 'none', fontFamily: 'Caveat', color: { hex: '#3b2a1a', model: 'hex' } },
  ],
}
ghost{eerie}: Leave this house…
caption{at=bottom-end}: Three streets away.

Os contornos são oval (uma superelipse ajustada às linhas, roundness 2,2), rounded, rectangle, cloud (recortes arredondados contados a partir do perímetro), burst (burstPoints pontas, com profundidade burstDepth), wavy, electric e none. dash desenha um contorno tracejado, double um contorno duplo, e wobble (0–1) o faz tremer como se fosse feito à mão, sempre do mesmo jeito para o mesmo balão. Os rabichos são curved, wedge, bubbles, zigzag e none. Todos os campos, com os valores padrão, estão em Configuração › Quadrinhos.

Os renderizadores desenham um balão do jeito que um letrista o arte-finaliza: todos os contornos de um grupo são traçados primeiro com o dobro da espessura, depois preenchidos, e depois o texto é composto. Por isso, dois corpos unidos e o rabicho deles saem como uma só forma, sem nenhuma linha entre eles.

#Personagens e âncoras

Os rabichos apontam para as pessoas, e os balões ficam longe dos rostos, porque os desenhos indicam onde estão as pessoas. Um recurso bitmap ou SVG pode levar âncoras: um ponto por personagem, escrito uma vez, em frações do desenho (de 0 a 1 a partir do canto superior esquerdo), como a área segura.

const arrive: Resource = {
  id: 'lh-arrive', typeId: 'figure', kind: 'bitmap', createdAt: 0, updatedAt: 0,
  bitmap: { fileId: 'lh-arrive.jpg', format: 'jpeg', width: 1100, height: 733 },
  altText: 'A girl in a yellow raincoat walks up a coastal path towards a lighthouse.',
  safeArea: { x: 0.2, y: 0.08, width: 0.42, height: 0.82 },
  anchors: [
    { id: 'maya', x: 0.29, y: 0.52, head: { x: 0.27, y: 0.47 }, face: { x: 0.22, y: 0.42, width: 0.12, height: 0.16 } },
    { id: 'biscuit', x: 0.4, y: 0.68 },
  ],
  avoid: [{ x: 0.51, y: 0.09, width: 0.1, height: 0.43 }], // o farol
  faces: [{ x: 0.7, y: 0.5, width: 0.06, height: 0.1 }], // um caminhante na trilha, que não diz nada
};
  • id é a chave de personagem que o roteiro usa (maya: …). Uma âncora cujo id é sfx posiciona as onomatopeias do quadro.
  • x, y é a boca, para onde aponta o rabicho de um balão de fala.
  • head é para onde apontam as bolhas de um balão de pensamento. Sem ele: a boca.
  • face é um retângulo que nenhum balão cobre. Uma âncora sem ele recebe uma caixa de proteção de alguns ems acima e em volta da boca, para que os balões continuem longe de um rosto que não foi delimitado.
  • avoid (no recurso) lista outros retângulos que nenhum balão cobre: uma mão, um objeto-chave, uma placa. Sob pressão, um balão pode cobrir uma zona a evitar, nunca um rosto.
  • faces (no recurso) lista, como retângulos, os rostos de quem não fala: alguém que passa, as pessoas atrás dos personagens. Cada um tem a regra do rosto de um personagem. Nenhum balão o cobre em nenhum último recurso, e o que mesmo assim o cobre (um balão fixado) é avisado como comicBalloonOverflow; o cabelo acima dele fica protegido; nenhum rabicho é desenhado sobre ele nem sobre a figura que está embaixo quando há outro caminho. Uma âncora da qual nenhuma linha fala também protege o rosto, mas continua sendo um personagem para todo o resto (a boca é um ponto em que nenhum balão toca, e ela é conferida com a área segura): faces é a marca para quem só está na cena.

Como as âncoras são frações do desenho, elas acompanham o recorte: o motor leva cada uma, através do recorte e do espelhamento do quadro, até a página, de modo que arrastar um divisor, mudar a divisão ou traduzir nunca tira um rabicho do personagem dele. Uma âncora que o recorte deixa fora do quadro faz o rabicho apontar para fora do quadro, na direção dela. A área segura protege as âncoras disso: uma âncora fora dela é informada como comicAnchorOutsideSafeArea, uma dica de autoria, já que um recorte pode cortá-la. Uma chave de personagem que nenhum desenho da página marca e nenhuma entrada do elenco cita é informada como comicUnknownSpeaker, o que costuma revelar um id digitado errado; páginas cujos desenhos não marcam nenhuma âncora não informam nada, de modo que uma HQ pode ser letreirada sem âncoras.

As âncoras e as zonas a evitar pertencem ao desenho e são as mesmas em todos os idiomas. No Sandbox, elas são marcadas no editor de imagens do painel Recursos: o campo Área segura e letreiramento abre um diálogo com três modos, Área segura, Personagens e Zonas a evitar. Um clique no desenho adiciona ali um personagem; a boca, a cabeça e o rosto são arrastados até o lugar certo e o id é digitado ao lado; arrastar sobre uma parte vazia do desenho traça uma zona a evitar. O modo Zonas a evitar também marca os rostos de quem não fala: um botão adiciona um, e uma chave em cada linha transforma uma zona num rosto assim, ou o contrário. Cada marca pode ser movida com as setas do teclado (Shift para passos maiores) e excluída com Delete, e o diálogo tem um desfazer próprio.

#Tiras

Um bloco :::strip tem o corpo de uma página de quadrinhos, mas fica no meio do texto, como uma caixa da largura de uma coluna ou da página, cortada em quadros: a tira diária de um jornal, uma piada de quatro quadros numa revista, uma HQ curta dentro de um livro em prosa.

:::strip{split="* | * | * | *" aspect=4 span=page placement=top}
::panel{art=pip-1}
pip: Otto, the ice is melting.
::panel{art=pip-2}
otto{thought}: Not the bakery…
::panel{art=pip-3}
::panel{art=pip-4}
sfx: SPLOSH
:::
AtributoEfeito
span=column, span=pageOcupa a coluna em que cai (o padrão) ou a área de conteúdo.
placement=hereO padrão: composta no texto onde está escrita. Uma tira nunca é dividida; uma que não cabe passa inteira para a coluna ou a página seguinte, levando junto um título logo acima dela. Uma tira da largura da página escrita here numa página de várias colunas corta as colunas onde está, como faz uma caixa da largura da página: o texto acima dela termina nivelado em todas as colunas, a tira atravessa a página, e o texto continua nas colunas abaixo dela. Quando o resto da página não comporta a tira, ela abre a página seguinte.
placement=top, bottom, autoFlutua como uma figura para o alto ou o pé da primeira página com espaço a partir desse ponto.
width=60%, width=12cmA largura da tira: uma fração da medida que ela ocupa (a coluna, ou a área de conteúdo com span=page) ou uma medida (um número sem unidade está em milímetros). Nunca mais larga que essa medida. Sem ela, a tira ocupa a medida inteira.
align=start, center, endOnde uma tira mais estreita fica dentro da medida. O padrão é center. start e end seguem o sentido do texto: o início é a borda direita numa página da direita para a esquerda e o alto de uma coluna numa página vertical.
height=4cmA altura da tira (um número sem unidade está em milímetros).
aspect=4, aspect=4/1Largura dividida pela altura, sendo a largura a da própria tira. Sem ele, a tira assume as proporções que deixam os quadros dela quadrados (quatro quadros em linha: 4).
caption="…"Uma legenda abaixo da tira (ou acima, com captionStyle.position: 'above'), composta na largura da tira com o estilo de legenda das figuras. O texto é Markdown em linha, escrito no idioma de cada edição.
type=figureNumera uma tira com legenda como recurso desse tipo: a legenda começa com o rótulo e o número do tipo (“Figura 3.”), e a tira conta na sequência desse tipo, na ordem de leitura, junto com os recursos do tipo. Sem type, ou com um tipo que nenhum tipo de recurso tem, a legenda é simples e a tira não é contada.
id=…Dá nome a uma tira numerada: :ref{id="…"} imprime o rótulo e o número dela, como faz com uma figura, e cria um link para ela.

Uma tira sem split coloca os quadros lado a lado. A caixa da tira é a moldura dela: as sarjetas, os estilos de quadro e o letreiramento são os da configuração, e nada tem sangria. Uma tira mais alta que uma coluna é reduzida à altura da coluna, legenda incluída. Depois dela, o texto continua na linha seguinte da grade de linhas de base, com o espaço que layout.inlineResourceGap pede, como depois de uma figura no texto. Numa página vertical, a tira é diagramada na caixa dela, girada; por isso, um yonkoma * / * / * / * com aspect=0.25 desce por uma coluna vertical, e a legenda vem depois dela como uma coluna de texto.

:::strip{split="* | * | *" width=70% caption="Pip and Otto on the ice." type=figure id=pip-ice}
::panel{art=pip-1}
::panel{art=pip-2}
::panel{art=pip-3}
:::
 
As :ref{id="pip-ice"} shows, the ice was thin.

A legenda recebe tudo o que o estilo de legenda define: a fonte e o corpo, as cores do rótulo e do texto, o peso e a inclinação do rótulo, o espaço entre a tira e a legenda, o alinhamento e a barra por trás dela. O captionStyle próprio de um tipo se aplica às tiras numeradas nele.

No VDT, uma tira é um bloco de type: 'resource' com um campo comic e sem resourceBlock; as coordenadas dela são relativas à caixa do bloco na folha, e uma tira mais estreita, ou uma que fica sob a legenda, fica dentro dessa caixa (nesse caso comic.frame não começa no canto dela). A legenda são as próprias lines do bloco, compostas nas fontes e cores da legenda, e stripCaption indica quais linhas são essas, onde ficam, o tipo e o número, e a barra. pageComics(page) dá a HQ de uma página e as tiras das colunas e dos flutuantes dela, todas transpostas para a folha.

#Páginas duplas

:::page{spread} distribui uma única árvore de divisões por duas páginas lado a lado, para um panorama ou uma batalha que precisa do livro aberto inteiro. A moldura são as duas áreas de conteúdo unidas através da lombada, sem as margens internas; a divisão, as sarjetas e o recorte funcionam como numa página simples, e um quadro ou um desenho pode atravessar a lombada.

:::page{spread split="25 [* | * | *] / *" bleed}
::panel{art=market-1}
::panel{art=market-2}
::panel{art=market-3}
::panel{art=market-panorama}
caption: The Saturday market, from the clock tower.
:::

Uma página dupla começa num verso, a página par, para que as duas metades fiquem frente a frente: uma página em branco é acrescentada antes dela quando a HQ começaria num recto, inclusive bem no início de um livro, onde a página 1 fica sozinha. Num livro com encadernação à esquerda, o verso é a página da esquerda; num livro com encadernação à direita (árabe, japonês e chinês verticais, uma HQ lida da direita para a esquerda), é a da direita. Cada página leva a própria metade: os quadros que chegam ao lado dela, cortados na lombada, e o desenho de um quadro que atravessa a lombada aparece nas duas páginas. Os quadros com sangria sangram pela cabeça, pelo pé e pelas bordas externas, nunca na lombada. Nada é letreirado numa faixa de 8 mm em volta da lombada, onde a encadernação o engoliria: um balão fixado ali desliza para o lado mais próximo. Cada balão fica na página que contém o centro dele.

#Sentido de leitura

Uma HQ ocidental é lida da esquerda para a direita: o primeiro quadro de uma fileira fica à esquerda. Mangás e quadrinhos árabes são lidos da direita para a esquerda. O Postext obtém o sentido de comics.readingDirection:

  • 'auto' (o padrão): o sentido do idioma da edição. Da direita para a esquerda num documento da direita para a esquerda, de modo que uma edição árabe espelha as páginas; num documento vertical; e em japonês e chinês tradicional (ja, zh-Hant, zh-TW, zh-HK, zh-MO), de modo que uma edição japonesa de uma HQ ocidental é lida da direita para a esquerda, como os mangás. Em qualquer outro idioma, incluídos o chinês simplificado e o coreano (manhua e manhwa hoje são lidos da esquerda para a direita), é o sentido para o qual os desenhos foram feitos, comics.artDirection ('ltr' por padrão): um mangá, com artDirection: 'rtl', é lido da direita para a esquerda em qualquer idioma.
  • 'ltr' ou 'rtl' impõe um sentido ao livro inteiro, e o atributo direction de uma página o impõe a essa página.

A encadernação acompanha os quadrinhos. Com page.binding: 'auto', um livro cuja seção comics é lida da direita para a esquerda é encadernado à direita: a página 1 fica sozinha à esquerda da lombada, as páginas duplas são lidas [3 | 2], os visualizadores viram as páginas para a esquerda, o PDF pede a ordem de páginas da direita para a esquerda e o EPUB declara uma progressão de páginas da direita para a esquerda. A seção comics decide pelo livro inteiro; por isso, um capítulo sem páginas de quadrinhos é encadernado como os outros; a direction própria de uma página não muda a lombada de lugar. Um documento cujas páginas de quadrinhos seguem os valores padrão, sem seção comics, mantém a encadernação do texto (basta comics: {} para encaderná-lo no sentido de leitura dos quadrinhos). page.binding: 'left' ou 'right' continua tendo prioridade. Veja Encadernação.

O mesmo texto de origem gera as duas diagramações. Uma página da direita para a esquerda distribui os quadros de cada fileira a partir da direita; por isso, o quadro 1 fica no alto à direita; as inclinações se espelham junto, assim como os lados lógicos de bleed, pad e as palavras-chave de canto (um recordatório em top-start fica no alto à direita). As fileiras mantêm a ordem de cima para baixo, e a ordem de leitura do roteiro não muda. O letreiramento também espelha as regras: o primeiro balão de um quadro tende para a direita, e o seguinte só pode ficar mais alto se estiver mais à esquerda.

Os desenhos não são espelhados, a não ser que se peça: comics.mirrorArt: true vira cada desenho de uma página lida no sentido oposto ao de artDirection, que é o que as edições ocidentais de mangá fizeram durante muito tempo, e ::panel{mirror=false} mantém um desenho como foi feito (texto desenhado no próprio desenho, um espadachim destro). As âncoras e as áreas seguras acompanham a virada. Um rabicho que sai do quadro apontado com tail=left ou tail=right também: esses valores indicam um lado do desenho, enquanto tail=start e tail=end seguem o sentido de leitura da página. Com o desenho como foi feito, tail=right termina na borda direita em todas as edições; com o desenho virado, na esquerda. Em geral, é melhor deixar o espelhamento desligado: a ordem dos quadros já segue o leitor, e um desenho virado muda o que o artista desenhou.

A escrita dos balões segue o idioma, não a ordem dos quadros. Com comics.lettering.writingMode: 'auto', o japonês e o chinês tradicional são letreirados em colunas verticais lidas da direita para a esquerda, com no máximo maxColumnChars caracteres (8), com as regras de kinsoku do japonês, os algarismos atravessados na coluna com :tcy e a pontuação nas formas verticais; um documento composto em escrita vertical é letreirado na vertical em qualquer idioma. O chinês simplificado, o coreano e todos os outros idiomas são letreirados na horizontal, e 'horizontal' ou 'vertical' impõe um ou outro. O árabe é letreirado da direita para a esquerda, com as palavras latinas e os algarismos no próprio sentido, nunca inclinado e nunca com espaçamento entre letras.

#Traduzir uma história em quadrinhos

Uma tradução é um arquivo Markdown com as mesmas linhas :::page e ::panel e as mesmas chaves de personagem, e outras palavras. Os desenhos, com as áreas seguras, as âncoras e as zonas a evitar, as divisões e as fixações (os pontos at= estão em frações dos desenhos) são compartilhados por todas as edições. Cada edição faz o próprio letreiramento: o texto é medido no idioma e na fonte dela, quebrado em linhas próprias, e cada balão é moldado e posicionado de novo em volta dele.

:::page{split="30 [30 | 20 | *] / *"}
::panel{art=lh-arrive}
caption: Todos los veranos, Maya pasaba una semana en el faro.
maya: ¡Abuelo! ¡Ya estoy aquí!
::panel{art=lh-radio}
tomas: Llegas justo a tiempo. La radio se ha quedado sorda,
tomas: y viene tormenta.
:::

O que muda de uma edição para outra decorre do locale do documento: as fontes padrão de letreiramento e de onomatopeias, o letreiramento vertical para o japonês e o chinês tradicional, os pontos finais retirados do chinês e do japonês, a entrelinha e o sentido das páginas de uma edição árabe. O texto fica cerca de um quinto mais longo em espanhol ou francês do que em inglês, e bem mais curto em chinês ou japonês; os balões crescem e encolhem com ele, e comicBalloonOverflow indica os quadros em que uma tradução precisa de uma fala mais curta ou de uma fixação. Onomatopeias são palavras como quaisquer outras: traduza-as, ou mantenha a original e acrescente uma pequena embaixo, como legenda.

#Páginas de quadrinhos e páginas compostas

Uma página de quadrinhos é uma página composta cujo modelo é escrito pela divisão: o valor de split é uma forma abreviada que gera os blocos da página. Cada célula da divisão, tirado o pad do quadro, é um bloco, e também o é cada quadro inset, uma camada acima do bloco em que se apoia. Um bloco leva o desenho, a borda e o fundo do quadro; o letreiramento continua a ser posicionado quadro a quadro, como descrito acima. Uma página de desenhos e roteiro é composta exatamente como antes.

O que a divisão gera
BlocosUm por célula, na ordem de leitura; o bloco de um quadro sobreposto vem depois do bloco em que se apoia.
NomesO id do quadro, senão p1, p2… na ordem dos quadros.
IdentificadoresOs quadrinhos são cm<n>, sendo n o ordinal do bloco de quadrinhos no capítulo (páginas e tiras contadas juntas, a partir de 0); um bloco é cm<n>:<nome>; um balão é cm<n>:<nome>:b<k>, sendo k a linha dele no roteiro do quadro. São os mesmos em todos os idiomas do capítulo e depois de qualquer nova paginação.
ContornoUm bloco cortado por uma linha inclinada mantém o polígono da célula: o conteúdo dele é recortado nesse polígono, e um ponto só atinge o bloco do lado de dentro.
No VDTpage.comic.frames: registros VDTFrame, cada um com panel, o índice do quadro que leva, e um configPath vazio, porque o bloco vem do Markdown e não da configuração.

#Quadros de texto

Um quadro com a marca text recebe Markdown em vez de um roteiro de letreiramento, e o corpo dele é despejado no bloco do quadro como um slot é despejado num bloco de uma página composta:

:::page{split="30 / *"}
::panel{text box=recuadro}
A tempestade já durava três dias quando a lâmpada do faroleiro se apagou.
 
Maya subiu sozinha os **cento e doze** degraus.
::panel{art=lh-stairs}
maya: Vovô?
:::

O corpo é composto no estilo de texto do livro, dentro da borda do quadro e da margem do letreiramento (comics.lettering.inset), a partir do alto do bloco (valign=middle ou valign=bottom o descem). É texto de verdade: parágrafos, títulos, listas, ênfase, links e chips, que o leitor pode selecionar e buscar, que um leitor de tela lê e para o qual aponta o mapa de origem. O corpo vai até a próxima linha ::panel; por isso, não pode conter blocos :::; essas linhas são omitidas. O texto é pintado sobre o fundo e o desenho do quadro e sob o letreiramento da página. Um PDF marcado o lê dentro dos quadrinhos, no lugar do quadro, antes do desenho do quadro seguinte; o EPUB refluível o lê depois dos quadros da página.

O texto que não cabe no bloco é composto menor, até 90 %, e depois cortado na borda do bloco e avisado como comicPanelFrame (motivo textOverflow). Com shrink, o texto é composto menor até caber, até a metade do tamanho ou a escala indicada (shrink=0.7, shrink=70%). Num livro da direita para a esquerda o texto é composto no bloco a partir da direita, e num livro vertical na vertical, como o próprio texto do livro (até o postext 1.38 era composto no fluxo depois dos quadrinhos). Numa tira, os quadros de texto são compostos nos blocos como numa página de quadrinhos (desde o postext 1.40): o texto é colocado quando a tira já tem lugar na página, e por isso fica no quadro dele quer a tira esteja na coluna, em toda a largura da página ou flutuando numa faixa. Numa página dupla (:::page{spread}), um quadro de texto é composto na página que contém a maior parte dele, e o texto deixa livres os 8 mm em torno da lombada.

#Estilos de boxe

box=<id> veste um quadro com um estilo de boxe de calloutStyles, os estilos com que as páginas compostas desenham os blocos: o quadro toma o fundo do estilo, a cor e a espessura da borda e o raio dos cantos, e os border e bg próprios do quadro continuam valendo. Num quadro de texto a caixa é desenhada em volta do texto como a de um bloco, com o recuo interno do estilo, e o quadro não desenha borda nem fundo próprios. Numa célula inclinada, um texto com caixa se limita à caixa de lados retos mais larga que cabe na célula; um texto sem caixa ocupa a célula inteira, e cada linha fica mais curta onde a diagonal a cruza: composto a partir do alto, desde o postext 1.39; centralizado ou no pé, desde o postext 1.40 (a diagonal é então lida onde as linhas ficam depois de alinhadas). Um texto que não consegue se assentar assim, porque a diagonal deixa pouco espaço às linhas, se limita à caixa de lados retos. Um box que não corresponde a nenhum estilo de boxe deixa o quadro no estilo de quadro dele e é avisado como comicPanelFrame (motivo unknownBox).

#Os blocos no mapa de origem e no Sandbox

sourceAt, elementsForSource e findElement (Páginas compostas › Mapa de origem) respondem também pelos quadrinhos: o glifo de um balão, o balão (nível box), o desenho de um quadro (resource), o bloco dele (frame) e os quadrinhos (template), com os identificadores acima. As palavras de um quadro de texto respondem como o resto do texto, depois a linha, o parágrafo e a caixa, o bloco e os quadrinhos. No Sandbox as palavras de um quadro de texto recebem o cursor e a seleção como o resto do texto, um clique num quadro de texto fora das palavras leva o cursor ao texto dele, e um duplo clique seleciona uma palavra, como em qualquer texto. Linhas da divisão, quadros e balões se editam como antes.

#Saída dos quadrinhos

Todas as saídas pintam a mesma HQ: fundos dos quadros, desenhos recortados nos quadros, bordas, desenhos que saem do quadro, depois os balões de cada grupo unido (contornos traçados, depois preenchidos, depois o texto) e, por último, as onomatopeias.

  • Canvas. O canvas do Sandbox, as páginas 3D do Folio e as miniaturas pintam todos por meio de renderPageToCanvas.
  • PDF. O postext-pdf pinta as páginas de quadrinhos com contornos vetoriais e as fontes de letreiramento incorporadas, e os desenhos SVG com uma matriz de impressão em PDF (svg.pdfFileId) são incorporados como essa matriz. Um PDF marcado dá a cada página de quadrinhos um Div, a cada quadro um Figure com o texto alternativo (o alt do quadro ou, se não houver, o altText do recurso) e a cada balão um P depois da figura do quadro, na ordem de leitura; uma onomatopeia é um Span cujo /ActualText são as palavras dela. Fundos, bordas e contornos são artefatos. A saída passa nas verificações PDF/UA-1 do veraPDF.
  • HTML. Cada quadro é um <figure> com um SVG em linha (o recorte, o desenho, a borda, o desenho que sai do quadro) com o texto alternativo do quadro, seguido dos balões como elementos <p> na ordem de leitura. Um balão de fala começa com o nome do personagem num span visualmente oculto, para que um leitor de tela diga “Maya: Grandpa! I'm here!”; uma onomatopeia é anunciada como uma imagem cujo rótulo são as palavras dela. O visualizador HTML do Sandbox, cujas páginas têm a largura de uma tela e a altura de uma rolagem, compõe uma página de quadrinhos como a página impressa ajustada à janela (comics.viewerLeaf), nunca refluída.
  • EPUB de layout fixo. As páginas são as do livro impresso. O livro também traz navegação por regiões (regions.xhtml, EPUB Region-Based Navigation 1.0): uma região panel por quadro na ordem de leitura, com os balões, recordatórios e onomatopeias aninhados nela, para que um sistema de leitura possa percorrer o livro quadro a quadro. A progressão das páginas segue o sentido de leitura dos quadrinhos. A opção kindlePanelView: true de renderToEpub acrescenta o Kindle Panel View: uma área de toque por quadro e uma cópia ampliada que preenche a tela, com os metadados que o Kindle exige.
  • EPUB refluível. Uma página de quadrinhos não tem ali uma página a manter; por isso, cada quadro vira o desenho dele, recortado exatamente como na página, seguido das falas como texto: “Maya: Grandpa! I'm here!”, os recordatórios como parágrafos, as onomatopeias em itálico.

A legenda de uma tira é pintada com o texto, como a de uma figura. Num PDF marcado, ela é o Caption do Div da tira, lido depois dos quadros (antes deles quando fica acima da tira). No HTML, no EPUB de layout fixo e no EPUB refluível, a tira e a legenda formam um único <figure>, e a legenda é o <figcaption> dele; numa página vertical ou da direita para a esquerda, onde o desenho da tira fica sobre a folha, o HTML mantém a legenda no texto, à parte.

#Editar quadrinhos no Sandbox

No canvas, nas páginas HTML e no modo de seleção do Folio, uma página de quadrinhos pode ser editada com o ponteiro, e cada edição é gravada de volta no Markdown do capítulo (o guia do Sandbox tem os detalhes):

  • Divisores. Sobre uma sarjeta, o ponteiro vira um cursor de redimensionamento. Arrastá-lo move a linha de divisão; ao soltar, a nova porcentagem é gravada no valor split da página (o atributo é acrescentado quando a página não tem um), e a página é diagramada de novo. Shift prende a passos de 5 %, Alt move só a ponta mais próxima, inclinando a linha, e nenhuma célula fica mais estreita que 5 %. Durante o arrasto, um quadro cujo desenho ficaria com faixas é marcado. Cada divisor também é um separador focalizável: as setas do teclado o movem 1 % (5 % com Shift), Enter grava a posição e Escape a desfaz.
  • Quadros. Uma pequena barra de ferramentas sobre um quadro o divide com uma linha horizontal ou vertical, acrescentando depois dele um ::panel vazio para a nova célula, ou o junta com o próximo quadro: a linha de divisão some, e o quadro resultante fica com o desenho do primeiro e com os dois roteiros.
  • Balões. Arrastar um balão o fixa: a linha de roteiro dele recebe at="x% y%" em porcentagens do desenho do quadro, e um grupo unido se move inteiro. Enquanto ele se move, o balão fica laranja onde cobriria um rosto ou uma zona a evitar ou sairia do quadro, e a dica indica qual. As setas do teclado deslocam um balão em foco 1 %, e um clique duplo num balão fixado remove a fixação.
  • Rabichos. Arrastar a ponta de um rabicho grava na linha to="x% y%", o ponto para onde o rabicho aponta; um clique duplo na ponta o remove, e o rabicho volta a apontar para o personagem. A partir de um balão em foco, T passa para o rabicho dele, cujo alvo as setas do teclado movem.
  • Teclado. Um quadro em foco é dividido com H (uma linha horizontal) ou V (uma linha vertical) e juntado com o próximo quadro com M.
  • Tiras. Todas as ferramentas também funcionam em blocos :::strip, numa coluna, flutuando ou na largura da página, mais estreitos que a medida ou sob uma legenda, e gravam na linha de abertura da própria tira.
  • Desenhos. A área segura, os personagens e as zonas a evitar de um desenho são marcados no painel Recursos (veja Personagens e âncoras).
  • Configurações. O painel Design tem um grupo Quadrinhos: sentido de leitura, moldura e sarjetas, o quadro padrão e os estilos de quadro, o letreiramento e os estilos de balão, cada um com uma visualização.
  • Editor. O editor de texto colore :::page, ::panel e as linhas de roteiro, e o painel Verificações lista os avisos de quadrinhos nas linhas a que se referem.

#Avisos de quadrinhos

Cada aviso indica a linha ou o atributo a que se refere, e o painel Verificações do Sandbox o lista ali, com o título da primeira coluna.

AvisoCausaSolução
Divisão de quadros ilegível
comicSplitSyntax
Um valor de split não pode ser lido por inteiro: um caractere solto, um [ sem fechar, / e | misturados numa lista, ou uma lista entre colchetes no mesmo eixo da mãe. A parte legível é usada; um valor sem nada legível dá um único quadro.Corrija o valor de acordo com a gramática: um só tipo de separador por lista, e colchetes para mudar de eixo.
Tamanhos de quadro acima de 100 %
comicSplitOverflow
Os tamanhos de uma lista somam mais de 100 %. Eles são reduzidos, e cada * mantém 5 %.Diminua os tamanhos, ou troque um deles por *.
Quadros e células não correspondem
comicPanelCount
A página tem mais linhas ::panel do que a divisão dela tem células (os quadros que sobram ficam de fora), ou menos (as últimas células ficam vazias).Acrescente ou remova células na divisão, ou quadros no roteiro. Uma linha ::panel vazia dá uma célula vazia de propósito.
Texto fora de uma linha do roteiro
comicStrayText
Texto antes da primeira linha ::panel, ou uma linha sem key: que não continua a linha de cima. Ele é letreirado como recordatório.Comece a linha com uma chave (caption:, maya:), ou recue-a com dois espaços para continuar o balão de cima.
Estilo de balão desconhecido
comicUnknownBalloonStyle
Uma linha indica entre chaves um estilo que nem os estilos embutidos nem comics.balloonStyles definem, muitas vezes um erro de digitação ({wisper}). A linha fica com o estilo da chave dela.Corrija o nome, ou acrescente o estilo a comics.balloonStyles.
Desenho do quadro não encontrado
comicUnknownArt
O art ou o pop de um quadro não corresponde a nenhum recurso, ou corresponde a um recurso que não é bitmap nem SVG. O quadro é desenhado vazio.Corrija o id, ou acrescente o desenho aos recursos do livro.
Desenho mostrado inteiro no quadro
comicPanelLetterbox
As proporções da célula estão longe demais das do desenho: nenhum recorte com essa forma contém a área segura inteira; por isso, o desenho é mostrado com a área segura inteira, entre faixas do fundo do quadro.Mova o divisor para dar outras proporções à célula (o Sandbox marca essas posições durante o arrasto), desenhe uma área segura menor ou use outro desenho.
Ponto de personagem fora da área segura
comicAnchorOutsideSafeArea
A âncora de um desenho fica fora da área segura dele; por isso, um recorte pode deixar o personagem de fora e o rabicho passaria a apontar para fora do quadro.Aumente a área segura para incluir a boca, ou mova a âncora. Não há nada a corrigir se a intenção é que o personagem às vezes fique fora do quadro.
O balão não cabe
comicBalloonOverflow
Depois de todas as alternativas, um balão ainda cobre um rosto, outro balão, uma zona a evitar ou uma boca, o rabicho dele atravessa outro balão, ou ele sai do quadro (uma travessia pedida com break ou com um at= não conta). O aviso indica o quadro e o que está coberto. Enquanto um balão é arrastado no Sandbox, o rosto ou a zona a evitar que ele cobriria, ou a borda que ele ultrapassaria, aparece antes de soltá-lo.Encurte a fala ou divida-a em duas, dê mais espaço ao quadro, fixe o balão com at= ou deixe-o atravessar a borda com break. O texto nunca é reduzido.
Personagem sem ponto
comicUnknownSpeaker
Uma chave de personagem que nenhum desenho da página marca com uma âncora e nenhuma entrada do elenco cita, quase sempre uma chave digitada errado. Os rabichos dela apontam para fora do quadro. Só aparece em páginas cujos desenhos marcam âncoras; é apenas informativo.Corrija a chave, marque o personagem no desenho ou acrescente uma entrada em comics.cast para um personagem que nunca aparece.
O quadro não sai como definido
comicPanelFrame
reason indica qual: unknownBox, um box não corresponde a nenhum estilo de boxe (o quadro mantém o estilo de quadro dele); textOverflow, o texto de um quadro de texto é mais alto que o bloco (o resto é cortado, e o aviso dá o excesso em mm); strip ou spread, um quadro de texto numa tira ou numa página dupla, só até o postext 1.39; flow, um quadro de texto num documento vertical ou da direita para a esquerda, só até o postext 1.38.Corrija o nome ou acrescente o estilo de boxe; encurte o texto, acrescente shrink ou dê ao quadro uma célula maior.

Os avisos voltam no contentWarnings do documento, com o intervalo de origem da linha ou do atributo a que se referem (veja Configuração › Avisos no documento).

Uma configuração de quadrinhos que aceita uma entre poucas palavras e recebe outra, como shape: 'ovl' num estilo de balão ou readingDirection: 'rlt', é lida com o valor padrão e aparece no painel Verificações como Valor de configuração desconhecido (unknownConfigValue), com o valor que o motor usou e a palavra mais próxima. As configurações verificadas são readingDirection, artDirection, o borderStyle e o fit de um estilo de quadro, o writingMode, o textTransform, o dropFinalStop e o joinSameSpeaker do letreiramento, e o shape, o tail, o target, o position, o align e o textTransform de um estilo de balão.

#A partir do código

Uma HQ não precisa de nada além de buildDocument: os recursos trazem os desenhos com as áreas seguras, as âncoras e as zonas a evitar, e a configuração pode trazer comics. O letreiramento mede o texto com as fontes carregadas; por isso, as fontes de letreiramento precisam ser carregadas antes da diagramação, como qualquer fonte: comicFontFamilies(config, markdown) lista as fontes de que os quadrinhos de um documento precisam (a fonte de letreiramento, as fontes de cada estilo de balão, as do elenco e as que as linhas do roteiro indicam com font=), e markdownHasComics(markdown) indica se um texto tem páginas de quadrinhos ou tiras. No PDF, o provedor de fontes recebe o pedido dessas fontes como de qualquer outra.

A HQ diagramada fica no VDT: page.comic (VDTComicPage) guarda a moldura, o sentido de leitura, os quadros na ordem de leitura (polígono, borda, fundo, o recorte do desenho como art.source e art.box), os divisores (com o intervalo de origem do valor split em que gravam) e os balões (caminho do contorno, blocos de texto, ponta do rabicho, tipo, personagem). A gramática das divisões é exportada para editores: parseComicSplit, serializeComicSplit, moveComicSplitLine, splitComicCell e mergeComicCells leem e reescrevem um valor split, mantendo os * sempre que possível. comicArtCrop e comicCropFeasibleRange calculam um recorte, e comicArtPointToPage leva um ponto de um desenho até a página.

#Limites conhecidos

  • Só árvores de divisão. Uma divisão corta cada célula em duas com uma linha que a atravessa inteira; por isso, não é possível escrever diagramações em que nenhuma linha cruza a página toda, como um cata-vento de quatro quadros em volta de um quinto. Os quadros sobrepostos e os desenhos que saem do quadro cobrem a maior parte do que essas diagramações pretendem.
  • Formas de quadro. Os quadros são polígonos convexos; quadros redondos ou irregulares, quadros sem borda, desenhos girados ou ampliados e linhas de movimento são feitos nos próprios desenhos, não pelo Postext.
  • Letreiramento. O rubi sobre uma base da direita para a esquerda fica de fora, e as outras anotações saem como texto simples dentro dos balões. O posicionamento é por quadro: os rabichos são impedidos de se cruzar por custo, não desviados uns dos outros, e o fluxo de um quadro para o seguinte não é equilibrado. Falas longas em células muito pequenas são informadas, não resolvidas. A proteção sobre um rosto não marcado é dimensionada a partir da boca e do ponto da cabeça (alguns ems quando a âncora não tem cabeça); por isso, num close, ela pode proteger mais a boca do que o rosto; marque o rosto.
  • As tiras não podem ocupar um número de colunas menor que o da página (columns=2 numa página de três), e só são lidas no nível superior de um capítulo (não dentro de um boxe, de uma tabela ou de uma nota de rodapé). Uma citação na legenda de uma tira sai como foi escrita.
  • Páginas duplas. Um quadro arredondado cortado na lombada perde todos os cantos arredondados. Uma HQ da direita para a esquerda num livro com encadernação à esquerda continua abrindo na página da esquerda; por isso, o primeiro quadro dela cai na segunda página da página dupla.
  • O desenho que sai do quadro usa o recorte do desenho do quadro; por isso, o recorte transparente precisa ter o mesmo tamanho do desenho.
  • Quadros de texto numa página dupla: um quadro que cruza a lombada tem o texto na página que contém a maior parte dele, sem levá-lo para o outro lado da dobra. Um texto centralizado ou no pé de uma célula inclinada cuja diagonal deixa pouco espaço se limita à caixa de lados retos mais larga que cabe na célula.
  • Saídas. O texto alternativo de reserva de um quadro sem alt e sem altText é “Panel N”, em inglês. A navegação por regiões descreve os quadros inclinados pelas caixas delimitadoras. O Kindle Panel View copia a HQ de uma página uma vez por quadro, o que aumenta o arquivo, e não foi verificado no Kindle Previewer.

#Referências

#Exemplos nas Receitas

Receitas que usam o que esta página explica, cada uma sob a seção que mais lhe corresponde. Cada receita mostra as páginas ao lado do script completo.