Pular para o conteúdo principal
Receita número 119

Receitas · Capítulo 2 · Tipo e texto

Haicais e tankas compostos na vertical

Os haicais de Bashō na prosa de viagem e onze tankas de três versos de Takuboku numa página 四六判: um verso por linha, recuados do alto, assinaturas no pé.

Nesta página
Gênero
Poesia
Saída
Canvas · PDF
Postext
Testada com o Postext 1.65.0
Requer ≥ 1.25.0 · postext-pdf ≥ 1.25.0
Licença
Atualizada em 11 de out. de 2026
Código MIT · Texto CC BY 4.0

p. 二–三 · 2–3 de 8

  • Amostra em inglês: ainda sem edição em português
  • Refile 127 × 188 mm
  • 1 coluna
  • Shippori Mincho 10/19
  • Noto Sans JP
  • 8 páginas
  • Nível
  • Postext 1.65.0
  • Diagramado em 91 ms
  • 155 linhas de código

Em poucas palavras

Um pequeno livro de poemas japoneses: o diário de viagem de Bashō com os haicais em linhas próprias, e os poemas curtos de Takuboku em três versos cada, que uma virada de página nunca corta.

O que você vai compor

Oito páginas de um pequeno livro de poesia numa página 四六判 de 127 × 188 mm, encadernada pela direita. A primeira parte são sete estações da Trilha estreita ao confim de Bashō, a prosa com os haicais; a segunda, onze tankas de Um punhado de areia, de Ishikawa Takuboku, cada um nos três versos em que ele o escreveu. A prosa corre de cima para baixo, 36 caracteres por linha, em Shippori Mincho de 10 pt com um passo generoso de 1,9 em. Cada haicai fica numa linha própria três caracteres abaixo, cada tanka dois, e o haicai de Sora vem assinado 曾良 perto do pé da linha. Um tanka nunca se divide entre duas páginas, e um * cor de caqui separa os grupos. O livro de poesia europeu é a Nº 015; poemas Tang em chinês vertical, a Nº 083.

Esta receita responde a

  • Como componho poesia: um verso por linha, espaço entre estrofes, recuo deslocado nos versos que quebram e sem hifenização?
  • Quais fontes compõem japonês, com os kanji nas formas japonesas, na tela e no PDF?

A resposta curta

script.js · linhas 33–48no código completo
// A haiku is a paragraph of one line, so a style sets where it starts: three characters down
// from the head of the line. Takuboku's tanka keep his three lines in a :::verse block, two
// down; 曾良 signs his haiku raised five characters from the foot (地から五字上げ).
const paragraphStyles = [
  { id: 'haiku', indent: em(3), firstLineIndent: em(0), marginTop: pt(0), marginBottom: pt(0) },
  // A poem's style gives its indent and the space under the poem: one blank line.
  { id: 'tanka', indent: em(2), marginTop: pt(0), marginBottom: pt(LEAD) },
  { id: 'by', textAlign: 'end', endIndent: em(5), firstLineIndent: em(0) },
  // The ornament between groups of poems, in the middle of its line, with a blank line after
  // it to match the one the group before it leaves.
  { id: 'ornament', textAlign: 'center', firstLineIndent: em(0), color: col('persimmon'),
    marginBottom: pt(LEAD) },
];
//   :::paragraphs{style="haiku"}       :::paragraphs{style="by"}
//   夏草や兵どもが夢の跡                   曾良
//   :::                                :::

Ingredientes

Tipografia
Shippori Mincho, Noto Sans JP (SIL OFL 1.1)
Materiais
Nenhum: todas as imagens são desenhadas em código

Preparo

#1 · Um verso é um parágrafo, e o seu estilo diz onde ele começa

O código está na resposta curta, mais acima. Um haicai é uma linha só, por isso é um parágrafo próprio dentro de um bloco :::paragraphs, e o estilo do bloco define o recuo: indent: em(3) põe um haicai três caracteres abaixo do alto da linha (o texto do Aozora os põe a dois; três dão mais respiro aos poemas), e firstLineIndent: em(0) impede que o recuo de um caractere do texto se some a ele. Os cerca de 17 caracteres de um haicai cabem em qualquer linha de 36, de modo que ele nunca quebra. A assinatura é um parágrafo à parte: textAlign: 'end' a apoia no pé da linha (地付き, jitsuki) e endIndent: em(5) a sobe cinco caracteres a partir dali (地から五字上げ), como faz a edição de onde vem este texto (Estilos de parágrafo).

#2 · Mantenha cada tanka numa só página

script.js · linhas 52–63no código completo
// The tanka of a group are one :::verse block, each a stanza of three lines with a blank
// line between: a line of verse a line of Markdown, one blank line of the grid between two
// tanka. keepStanzas=3 keeps a stanza of three lines whole, so a tanka is never cut at the
// foot of a page: it moves on to the next.
//   :::verse{style="tanka" keepStanzas=3}
//   東海の小島の磯の白砂に
//   われ泣きぬれて
//   蟹とたはむる
//
//   頬につたふ
//   …
//   :::

Os tankas de Takuboku formam um bloco :::verse, cada tanka uma estrofe: os três versos são três linhas do Markdown, e a linha em branco entre dois tankas do texto deixa uma linha em branco da grade entre os poemas. O estilo do poema dá o recuo de dois caracteres e a linha embaixo do grupo, e os versos pendem do alto como qualquer coluna. keepStanzas=3 mantém inteira cada estrofe de três versos: na página 5 o terceiro tanka não cabe embaixo do título da parte e dos dois primeiros, por isso abre inteiro a página 6 em vez de deixar para trás o primeiro verso. O ornamento entre dois grupos apresenta o seguinte, por isso passa com o primeiro tanka em vez de ficar sozinho no pé de uma página (:::verse).

#3 · Espace os nomes de lugar até a mesma largura

script.js · linhas 67–72no código completo
// The place names over the prose take two lines (2行取り), four characters down, and a
// two-character name is spaced out to three (字取り: 平泉 → 平 泉), so they all end level.
const place = {
  level: 2, fontFamily: MINCHO, fontWeight: 700, fontSize: pt(11),
  lineSpan: 2, indent: em(4), jidori: 3,
};

As estações do caminho de Bashō são títulos de nível 2 com a altura de duas linhas do texto (2行取り), para que a prosa e os haicais seguintes fiquem na grade. jidori: 3 espaça um nome mais curto até ocupar três dos próprios caracteres (字取り): 平泉 sai 平 泉, com um caractere inteiro entre eles, e todos os nomes terminam na mesma altura que 立石寺 e 最上川. Um nome que já tem três caracteres fica como está (Ajustes por nível).

#4 · Abra cada parte numa página própria

script.js · linhas 76–97no código completo
// A design on a vertical page is laid out in the flow frame: x runs down the column from
// the head of the type area, y across the page leftwards from its right edge.
const at = (down, across) => ({ anchor: { to: 'container', edge: 'top-left' },
  offset: { x: pt(down), y: pt(across) } });
const TITLE = 18; // pt
const part = {
  level: 1, breakBefore: { enabled: true, parity: 'any' }, // the next page, either side
  advancedDesign: { enabled: true, minHeight: lines(5), slot: { elements: [
    { kind: 'text', id: 'title', content: '{titleText}', fontFamily: MINCHO, fontWeight: 700,
      fontSize: pt(TITLE), lineHeight: 1, letterSpacing: pt(4), color: col('ink'),
      placement: at(3 * BODY, 1.5 * LEAD - TITLE / 2) },
    { kind: 'text', id: 'abridged', content: '(抄)', fontFamily: MINCHO, fontSize: pt(9),
      color: col('ink'), placement: { anchor: { to: '#title', edge: 'right-of' },
        offset: { x: pt(6), y: pt((TITLE - 9) / 2) } } },
    { kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.6),
      color: col('persimmon'), placement: { ...at(3 * BODY, 2.5 * LEAD),
        size: { width: pt(4 * TITLE) } } },
    { kind: 'text', id: 'poet', content: '{attr.author}', fontFamily: MINCHO, fontSize: pt(11),
      letterSpacing: pt(3), color: col('ink'),
      placement: at(CHARS * BODY - 4 * 11 - 3 * 3 - 2 * BODY, 3.5 * LEAD - 11 / 2) },
  ] } },
};

Cada parte é um título de nível 1 cujo design põe o título, um pequeno (抄), “seleção”, logo depois dele com anchor.to: '#title', um fio curto cor de caqui ao lado do título e o poeta perto do pé da linha. O design reserva cinco linhas, e o texto começa depois delas na mesma grade.

#5 · Escolha uma fonte que tenha os sinais antigos

script.js · linhas 279–285no código completo
const title = markdown.match(/^title: "(.*)"$/m)[1];
const heads = markdown.match(/^#+ [^{\n]*/gm).join('');
await loadFonts(FONTS, markdown); // the Latin files: the colophon
await loadCjkFonts({ [MINCHO]: ['400'] }, markdown, { vertical: true });
await loadCjkFonts({ [MINCHO]: ['700'] }, heads);
await loadCjkFonts({ [GOTHIC]: ['400'] },
  `${title}${heads}${markdown.match(/colophon="([^"]*)"/)[1]}一二三四五六七八九十`, { vertical: true });

A prosa de Bashō escreve palavras repetidas com o antigo sinal de iteração 〻 (日〻, 人〻), e textos mais antigos também usam o longo くの字点 〳〵. A Zen Old Mincho não tem nenhum dos dois: o canvas os pegaria de uma fonte do sistema e o PDF desenharia caixas vazias. Shippori Mincho, Noto Serif JP e Shippori Mincho B1 têm os dois, de modo que os poemas são compostos em Shippori Mincho (Fontes chinesas, japonesas e coreanas). O texto do Aozora também mantém as notas do editor sobre grafias antigas, とら{え|(へ)}て, que imprimem o kana esperado ao lado daquele que Bashō escreveu.

A receita completa

Sandbox
// ═══ Postext Cookbook · Nº 119 · Haiku and tanka set vertically ═══════════════════
// https://postext.dev/en/cookbook/haiku-and-tanka
// Code: MIT · Text: 芭蕉『おくのほそ道』, 啄木『一握の砂』, Aozora Bunko (PD) · Pictures: none
// Fonts: Shippori Mincho, Noto Sans JP (SIL OFL 1.1) · Needs postext ≥ 1.25.0
import {
  buildDocument, withLoadedFonts, renderPageToCanvas, loadVerticalAlternates,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';

const LANG = 'en'; // @lang: the language of the colophon; the poems are Japanese in both
const RECIPE = 'haiku-and-tanka';

// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, one persimmon, a soft poetry stock
const palette = {
  ink: '#22201d', // the poems
  persimmon: '#b5512c', // 柿: the part titles' rule and the ornaments
  muted: '#6a645c', // the hashira, the folios, the colophon
  paper: '#fbf8f1',
};
const col = (id) => ({ hex: palette[id], model: 'hex', paletteId: id });
const colorPalette = [
  ...Object.entries(palette).map(([id, hex]) => ({ id, name: id, value: { hex, model: 'hex' } })),
  { id: 'main-color', name: 'defaults', value: { hex: palette.persimmon, model: 'hex' } },
];
// #endregion
// Shippori Mincho: it has the 〻 of 日〻 and 人〻, which Zen Old Mincho lacks.
const [MINCHO, GOTHIC] = ['Shippori Mincho', 'Noto Sans JP'];
const [BODY, LEAD, CHARS, LINES] = [10, 19, 36, 14]; // pt, pt: 36字 × 14行, a 1.9 em pitch
const lines = (n) => pt(n * LEAD);

// #region answer: a haiku on one line three characters down, a tanka in three, 地付き names
// A haiku is a paragraph of one line, so a style sets where it starts: three characters down
// from the head of the line. Takuboku's tanka keep his three lines in a :::verse block, two
// down; 曾良 signs his haiku raised five characters from the foot (地から五字上げ).
const paragraphStyles = [
  { id: 'haiku', indent: em(3), firstLineIndent: em(0), marginTop: pt(0), marginBottom: pt(0) },
  // A poem's style gives its indent and the space under the poem: one blank line.
  { id: 'tanka', indent: em(2), marginTop: pt(0), marginBottom: pt(LEAD) },
  { id: 'by', textAlign: 'end', endIndent: em(5), firstLineIndent: em(0) },
  // The ornament between groups of poems, in the middle of its line, with a blank line after
  // it to match the one the group before it leaves.
  { id: 'ornament', textAlign: 'center', firstLineIndent: em(0), color: col('persimmon'),
    marginBottom: pt(LEAD) },
];
//   :::paragraphs{style="haiku"}       :::paragraphs{style="by"}
//   夏草や兵どもが夢の跡                   曾良
//   :::                                :::

O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)

Variações

#Separe as três frases do haicai

Antologias escolares às vezes põem um espaço ideográfico entre os 5, 7 e 5 sons, para quem está aprendendo a forma; o espaço é um caractere do texto.

-{夏草|なつくさ}や{兵|つはもの}どもが夢の跡
+{夏草|なつくさ}や {兵|つはもの}どもが 夢の跡

#Deixe um tanka longo se dividir

Sem keepStanzas, um tanka pode começar no pé de uma página e continuar na seguinte pelas regras de viúvas e órfãs, como faria uma antologia compacta de mil poemas.

-:::verse{style="tanka" keepStanzas=3}
+:::verse{style="tanka"}

Erros comuns

Erro comum

Marque um texto japonês como 'ja', nunca com zh-Hans nem LANG

As edições de uma receita são en e es, mas uma amostra japonesa é japonesa nas duas: `locale: LANG` a marcaria como inglês ou espanhol, e uma marcação chinesa a comporia pelas regras chinesas (pontuação Kaiming, kana pequeno livre para começar linha, 图 no lugar de 図, formas chinesas dos glifos no PDF). Desde o postext 1.30 a marcação é também o idioma em que o texto é composto (em que é medido, pintado e incorporado), então qualquer marcação que não seja 'ja' dá outras formas de glifo que não as japonesas (as chinesas, sob uma marcação chinesa) e outras quebras de linha. Escreva 'ja': isso escolhe a região do Japão (quebra de linha e pontuação da JLReq, pontos de ênfase em gergelim, espaçamento dos furigana, rótulos 図 e 表) e desativa a hifenização. O lint reprova um texto com kana sob uma marcação zh ou ko. Quebra de linha em japonês (kinsoku) →

Erro comum

Fontes chinesas são carregadas em fatias, pelo bloco cjk

O Fontsource serve uma família chinesa, japonesa ou coreana em cerca de cem arquivos por peso, cada um com um intervalo de caracteres. loadFonts baixa só o arquivo latin, então na tela os caracteres chineses vêm de uma fonte do sistema e são medidos errado, e o fontsourceProvider entrega ao PDF esse arquivo latin, que os imprime como caixas vazias. Inclua o bloco cjk do kit, chame loadCjkFonts(FONTS, markdown) depois de loadFonts (uma vez por voz, com o texto que ela compõe, quando o livro usa várias fontes CJK) e passe a renderToPdf fontProvider: cjkPdfProvider: os dois pegam os arquivos que contêm os caracteres do texto. Fontes chinesas, japonesas e coreanas →

Erro comum

Um livro encadernado pela direita mostra as páginas duplas com showBook

Em um livro encadernado pela direita (texto árabe, hebraico ou persa, chinês vertical, ou page.binding 'right') a página 1 continua sendo a ímpar, mas fica à esquerda da lombada, e os pares se leem [3 | 2]. showPages dispõe todos os livros como se fossem encadernados pela esquerda; showBook, do bloco book (o bloco cjk traz a mesma função), lê doc.binding e espelha os pares. capture.hero continua nomeando uma página dupla em ordem de leitura, [par, ímpar]: [2, 3]. Livros encadernados pela direita →

Erro comum

Um intervalo do Fontsource pode citar caracteres que o seu arquivo não tem

O Fontsource dá a cada arquivo um unicode-range, e loadCjkFonts carrega os arquivos cujos intervalos cobrem a amostra, mas um intervalo pode prometer mais do que o arquivo contém. O fragmento da Zen Old Mincho para U+3028–303F não tem 〻 nem as marcas de repetição longas 〳〴〵, e a fonte também não tem as vogais com mácron ō ū ā; o arquivo latin-ext da Shippori Mincho B1 tem poucos caracteres, e nenhum deles é ō, ū ou ā. Nada falha enquanto a receita roda: na tela, esses caracteres vêm de uma fonte do sistema e são medidos com ela, e o PDF imprime a caixa .notdef da fonte, que só a verificação C25 aponta depois. Procure na fonte um sinal raro ou uma palavra em rōmaji antes de escolhê-la (fontTools sobre o arquivo do Fontsource) e componha esse texto com uma fonte que o tenha: Shippori Mincho B1 e Noto Serif JP têm 〻 e 〳〴〵; Noto Serif JP e Noto Sans JP, as vogais com mácron. Fontes chinesas, japonesas e coreanas →

Créditos

Texto
Fontes
Shippori Mincho (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
SandboxPDF