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
// 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
- Funcionalidades
- Estilos de parágrafoVerso linha a linhaTexto verticalTítulos sobre linhas do texto (gyōdori)Livros encadernados pela direitaRecuos, alinhamento e espaço entre parágrafosFurigana: leituras em kana sobre os kanjiQuebra de linha em japonês (kinsoku)Numerais japoneses e contadores em kanaKana, kanji e rōmajiGrade de caracteresFontes chinesas, japonesas e coreanasImportação do Aozora BunkoEstilos de títuloAberturas desenhadasTextos, fios e caixas nos designs de páginaCabeços e fóliosMargens espelhadasPaleta de cores semânticaExportação para PDF
- Também usa
- Quebra de linha em chinêsAtributos de títuloCor do papelCabeços por tipo de páginaFontes incorporadas ao PDFElementos pré-textuais em romanosRubi: leituras em pinyin e zhuyinCabeços por seção
- 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
// 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
// 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
// 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
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
// ═══ 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
- Receita
- Ignacio Ferro
- Texto
- 松尾芭蕉『おくのほそ道』 (The Narrow Road to the Deep North, 1702), seven sections, the editor’s notes left out; Aozora Bunko card 61619, from 「芭蕉 おくのほそ道」 (Iwanami, 1975) after 杉浦正一郎’s Iwanami Bunko edition (1957), input 砂場清隆, proofreading 木下聡, converted with aozora.py · Matsuo Bashō; Sugiura Shōichirō (editor, 1911–1957); Aozora Bunko volunteers · domínio público
- 石川啄木『一握の砂』 (A Handful of Sand, 1910), eleven tanka; Aozora Bunko card 816, converted with aozora.py · Ishikawa Takuboku; Aozora Bunko volunteers · domínio público
- Fontes
- Shippori Mincho (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


