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
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.
#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:
| Atributo | Efeito |
|---|---|
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). |
bleed | Todo quadro que toca a moldura se estende até o refile e entra na sangria. |
direction=rtl, dir=ltr | O sentido de leitura desta página, seja qual for o da configuração (veja Sentido de leitura). |
spread | Distribui 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 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;
30e30%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 informacomicSplitOverflow. - 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
::panelpreenchem 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á umsplitescrito).
Algumas divisões:
| Divisão | Pá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 | *] / 35 | Uma 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.
| Atributo | Efeito |
|---|---|
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=contain | cover 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.5mm | Sem borda, ou uma borda com essa espessura. |
bg=#1b1b2f | O fundo do quadro: uma cor, um id da paleta ou none. |
bleed, bleed="top start", bleed=false | Veja 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=false | Espelha 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. |
text | O 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=bottom | Onde fica o texto de um quadro de texto no bloco. Sem ele: no alto. |
shrink, shrink=0.7 | Compõ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:
- Com
fit=cover, a janela visível tem as proporções da célula e é tão grande quanto o desenho permite. - Ela é posicionada de modo que a área segura fique dentro dela. Onde isso deixa margem, a janela é centralizada em
focusquando 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. - 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 entresw·W/HeW/(sh·H), ondesweshsã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}: textA 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:
| Atributo | Efeito |
|---|---|
{whisper}, style=whisper | O 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-start | Coloca 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=start | Sem 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=false | Une este balão ao anterior do mesmo personagem, ou o mantém separado, independentemente do que comics. indique. |
break | Deixa 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=-8 | Gira o balão ou a onomatopeia, em graus, no sentido horário. |
skew=-8 | Inclina 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.5 | Muda a escala do letreiramento de uma onomatopeia. |
color=#c0392b | A cor do letreiramento: uma cor hexadecimal ou um id da paleta. |
font="…" | A fonte desta linha. |
vertical, horizontal, mode=vertical | O 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.fontFamilyno corpocomics.lettering.fontSize(7,5 pt por padrão), alterado só pelofontScaledo 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 ⁉);doubleDashletreira 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.insetda 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, combreakou com umat=, 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 combreakpode 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 informacomicBalloonOverflow, indicando o quadro e o que ele cobre. Uma travessia pedida, combreakou com umat=, 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 umat=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:
| Idioma | Letreiramento | Onomatopeias |
|---|---|---|
| Latim, grego, cirílico e os demais | Comic Neue | Bangers |
| Japonês | Zen Antique | Dela Gothic One |
| Chinês simplificado | Noto Sans SC | ZCOOL KuaiLe |
| Chinês tradicional | LXGW WenKai TC | LXGW WenKai TC |
| Árabe, persa, urdu | Playpen Sans Arabic | Lalezar |
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.
| Estilo | Contorno | Rabicho | Outros detalhes |
|---|---|---|---|
speech | oval | curvo | A base de todos os estilos: preenchimento branco, contorno preto de 0,6 pt, 0,55 em de folga. |
thought | nuvem | bolhas | As bolhas apontam para a cabeça, não para a boca. |
whisper | oval, tracejado | curvo | Texto a 0,9. |
shout | explosão | cunha | Texto a 1,15, em negrito; contorno de 0,8 pt. |
radio | elétrico (zigue-zague) | zigue-zague | Uma voz que vem de um rádio, de um telefone ou de uma máquina. |
caption | retângulo | nenhum | Amarelo-claro, encostado no canto superior inicial, texto alinhado pelo início. |
inner | caixa arredondada | nenhum | Preenchimento cinza, itálico: a voz interior de um personagem. |
note | retângulo | nenhum | Encostado no canto inferior final, texto a 0,8. |
sfx | nenhum | nenhum | Texto 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 ésfxposiciona 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 comocomicBalloonOverflow; 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
:::| Atributo | Efeito |
|---|---|
span=column, span=page | Ocupa a coluna em que cai (o padrão) ou a área de conteúdo. |
placement=here | O 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, auto | Flutua como uma figura para o alto ou o pé da primeira página com espaço a partir desse ponto. |
width=60%, width=12cm | A 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, end | Onde 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=4cm | A altura da tira (um número sem unidade está em milímetros). |
aspect=4, aspect=4/1 | Largura 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.), 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=figure | Numera 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á, comartDirection: 'rtl', é lido da direita para a esquerda em qualquer idioma.'ltr'ou'rtl'impõe um sentido ao livro inteiro, e o atributodirectionde 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 | |
|---|---|
| Blocos | Um por célula, na ordem de leitura; o bloco de um quadro sobreposto vem depois do bloco em que se apoia. |
| Nomes | O id do quadro, senão p1, p2… na ordem dos quadros. |
| Identificadores | Os 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. |
| Contorno | Um 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 VDT | page.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-pdfpinta 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 umDiv, a cada quadro umFigurecom o texto alternativo (oaltdo quadro ou, se não houver, oaltTextdo recurso) e a cada balão umPdepois da figura do quadro, na ordem de leitura; uma onomatopeia é umSpancujo/ActualTextsã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ãopanelpor 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çãokindlePanelView: truederenderToEpubacrescenta 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
splitda 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
::panelvazio 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,::panele 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.
| Aviso | Causa | Solução |
|---|---|---|
Divisão de quadros ilegívelcomicSplitSyntax | 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 correspondemcomicPanelCount | 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 roteirocomicStrayText | 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 desconhecidocomicUnknownBalloonStyle | 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 encontradocomicUnknownArt | 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 quadrocomicPanelLetterbox | 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 seguracomicAnchorOutsideSafeArea | 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 cabecomicBalloonOverflow | 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 pontocomicUnknownSpeaker | 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 definidocomicPanelFrame | 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=2numa 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
alte semaltTexté “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
- Nate Piekos, Comic Book Grammar & Tradition (Blambot): tipos de balão, recordatórios, ênfase, o travessão duplo.
- John Roshell e Comicraft, Balloon Tales: rabichos e uniões, e o método das camadas, de traçar e depois preencher.
- Todd Klein, Digital lettering for comics.
- David Kurlander, Tim Skelly e David Salesin, Comic Chat, SIGGRAPH 96: posicionamento dos balões na ordem de leitura.
- IDPF, EPUB Region-Based Navigation 1.0, e Amazon KDP, Kindle Panel View.
#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.












