En poques paraules
El començament d'un clàssic japonès com a llibre de butxaca: el text va en columnes de dalt a baix, es llegeix de dreta a esquerra i porta kana petits al costat dels caràcters més difícils.
Què compondràs
Nou pàgines d'un llibre de butxaca japonès (文庫, bunko) amb les dues primeres nits de Deu nits de somnis de Natsume Sōseki, en una pàgina A6 de 105 × 148 mm enquadernada per la dreta. La portada queda sola a l'esquerra del llom; des de la pàgina 2 el text baixa de dalt a baix en línies que es llegeixen des de la dreta, 38 caràcters per línia i 15 línies per pàgina, en Shippori Mincho B1 de 9 pt amb un pas d'1,75 em. Les lectures que Aozora Bunko dona per als kanji difícils van al seu costat en kana de mig cos, el títol de cada nit ocupa tres línies de la retícula i les pàgines de l'esquerra porten el títol del llibre pel tall, sobre un foli en numerals kanji. El llibre de butxaca europeu amb la mateixa estructura és la Núm. 104, i la novel·la xinesa en vertical, la Núm. 075.
Aquesta recepta respon a
- Com componc una novel·la japonesa en vertical, enquadernada per la dreta, com un bunko de butxaca?
- Com poso furigana damunt dels kanji, una lectura per caràcter o una per a tota la paraula?
- Com converteixo un text d'Aozora Bunko en un llibre de Postext?
- Com faig que un títol japonès ocupi tres línies del text (3行取り) perquè el text continuï a la retícula?
La resposta curta
// 'vertical-rl' sets each line top to bottom and the lines from right to left; with the
// binding left to 'auto' the book opens from the right, so page 1 is a left-hand page and
// the spreads read [3 | 2]. locale 'ja' gives the cjk settings Japan's values: they are
// written out below so you can see them, and leaving them out sets the same page.
const page = {
sizePreset: 'custom', width: mm(105), height: mm(148), dpi: 200, // 文庫判 A6
backgroundColor: col('paper'),
// 天 above 地; left is the spine side (the right edge of a left-hand page). The grid
// grows the margins of each pair alike, so the head stays deeper than the foot.
margins: { top: mm(15), bottom: mm(11), left: mm(9), right: mm(12), mirror: true },
pageNumbering: { format: 'japanese-informal' }, // folios 一, 二 … 十, 十一
};
const layout = { layoutType: 'single', writingMode: 'vertical-rl' };
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
lineBreak: 'ja-very-strict', // 行頭禁則: no 、。」ー or small kana at the head of a line
hangingPunctuation: 'allow', // ぶら下げ: a 、。 that would open a line hangs below the last
paragraphStartBracket: 'half', // ③: a 「 that opens a paragraph fills the indent cell
ruby: { align: 'jis', overhang: 'kana' }, // JIS 1:2:1, a reading may run onto kana only
};
Ingredients
- Funcions
- Text verticalFurigana: lectures en kana sobre els kanjiTítols que ocupen línies del text (gyōdori)Llibres enquadernats per la dretaTall de línies japonès (kinsoku)Espaiat de la puntuació japonesa (yakumono)Retícula de caràctersNumerals japonesos i comptadors en kanaImportar textos d'Aozora BunkoKana, kanji i rōmajiFonts xineses, japoneses i coreanesRuby: lectures en pinyin i zhuyinCapçaleres i folisCapçaleres segons el tipus de pàginaMarges simètricsEstils de títolNivells de títolColor del paperPaleta de color semànticaExportació a PDF
- També fa servir
- Tall de línies en xinèsAmplada de la puntuació xinesaAtributs de títolObertures dissenyadesFonts incrustades al PDFPreliminars en romansCapçaleres per seccióCapítols sense número
- Tipografia
- Shippori Mincho B1, Noto Sans JP (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Gira la pàgina, compta-la en caràcters i etiqueta-la ja
El codi és la resposta curta de més amunt. layout.writingMode: 'vertical-rl' compon cada pàgina com una pàgina horitzontal girada un quart de volta en el sentit de les agulles del rellotge, i page.binding, que es queda en 'auto', enquaderna per la dreta un llibre vertical: la pàgina 1 continua sent la senar, però cau a l'esquerra del llom, i mirror: true posa el seu marge interior a la dreta (Escriptura vertical, Enquadernació). La retícula de caràcters fa que la caixa de text mesuri 38 caràcters de 9 pt cap avall (120,7 mm) i 15 línies de 15,75 pt d'amplada (83,3 mm). Els marges de page són mínims i la retícula engrandeix cada parell en la mateixa mesura, de manera que el cap continua 4 mm més fondo que el peu. Si demanes més línies de les que caben entre els marges, la retícula en treu una sense avisar a la pàgina (cjkGridClamped a doc.configWarnings): el llom de 9 mm i el tall de 12 mm són els que deixen lloc a les 15.
locale: 'ja' deixa la resta tal com la componen els llibres japonesos, així que les quatre línies de cjk escrites aquí no canvien res: mostren el que tria l'etiqueta. ja-very-strict és la regla d'inici de línia de JIS X 4051 (行頭禁則): cap línia no comença amb 、。」, ー ni amb un kana petit com っ. hangingPunctuation: 'allow' deixa que un 、 o un 。 que obriria la línia següent pengi sota l'últim caràcter (ぶら下げ), que és el que fan els bunko en lloc d'estrènyer la línia. paragraphStartBracket: 'half' és el patró ③ de JLReq: un paràgraf que comença amb 「 posa el claudàtor a la segona meitat del seu sagnat d'un caràcter, i el primer caràcter del diàleg queda on comença qualsevol altre paràgraf (Tipografia de l'Àsia oriental). Els llibres xinesos ho fan diferent en tots dos casos: per defecte no pengen cap signe i sagnen el paràgraf dos caràcters, tant si comença amb claudàtor com si no.
#2 · Dona a cada títol tres línies de la retícula
// lineSpan sets the heading in a band of three body lines, its characters centred in it, so
// the text after it stands on the grid's lines. Aozora marks the titles 5字下げ (中見出し);
// indent counts body characters, whatever the heading's own size.
const night = {
level: 1, fontFamily: MINCHO, fontWeight: 600, fontSize: pt(12.5),
lineSpan: 3, indent: em(5), // JLReq §4.1.3
breakBefore: { enabled: false }, // the nights run on
};
Un títol japonès ocupa un nombre enter de línies del text, 行取り (gyōdori), perquè les línies que el segueixen quedin en la mateixa retícula que les anteriors. lineSpan: 3 compon 第一夜 en una franja de tres línies de 15,75 pt amb els caràcters centrats; el cos de 12,5 pt del títol no mou la retícula, i a la pàgina 6 第二夜 ocupa les tres primeres línies de la pàgina, de manera que el text que el segueix comença a la quarta línia de la retícula. indent: em(5) compta caràcters del text (五字下げ), que és com el text d'Aozora marca un 中見出し i com JLReq compta els sagnats dels títols (Configuració per nivell).
#3 · Porta el text i les lectures d'Aozora Bunko
Les dues nits surten de la fitxa 799 d'Aozora Bunko, convertida amb aozora.py, de l'skill postext-port. El convertidor llegeix el fitxer com a CP932, converteix cada lectura escrita 仰向《あおむき》 en una lectura de grup {仰向|あおむき}, una sola tira de kana sobre tota la paraula, i cada [#5字下げ]…[#「第一夜」は中見出し] en un títol. En un document ja les lectures segueixen JIS X 4051: una lectura més curta que la seva base es reparteix al llarg d'ella en proporció 1:2:1, i una de més llarga pot envair un kana veí, però mai un kanji (Marques, ruby i warichu). L'interlineat d'1,75 em deixa 6,75 pt entre línies, prou per a lectures de 4,5 pt.
#4 · Posa el hashira al tall i els folis en kanji
// anchor 'outer' is the fore-edge: the left margin of an odd page, the right of an even one
// in a book bound on the right. The 柱 starts two characters below the head of the text.
const foreEdge = (id, content, parity, edge, y, pages) => ({
kind: 'text', id, content, parity, pages, writingMode: 'vertical-rl',
fontFamily: GOTHIC, fontSize: pt(7), letterSpacing: pt(1), color: col('muted'),
overflow: 'clip', placement: { anchor: { to: 'outer', edge }, offset: { y: em(y) } },
});
const header = { elements: [
foreEdge('hashira', '{title}', 'odd', 'top', 2, 'body'), // never on the opening page
foreEdge('folio', '{pageNumber}', 'all', 'bottom', -2, 'all'),
] };
const none = { elements: [] };
En un bunko vertical la capçalera (柱, hashira) és petita i va al marge exterior. anchor.to: 'outer' hi col·loca un element, al marge esquerre d'una pàgina senar i al dret d'una de parella en un llibre enquadernat per la dreta, i writingMode: 'vertical-rl' el compon de dalt a baix (Elements de text verticals). El títol 夢十夜 va només a les pàgines de l'esquerra (parity: 'odd'), i pages: 'body' l'apartaria de qualsevol pàgina que obrís un capítol. pageNumbering.format: 'japanese-informal' imprimeix els folis 二, 三 … 九 (Numeració).
#5 · Centra la portada en el format
// A design on a vertical page is laid out in the flow frame: x runs down the page and y
// across it, leftwards from the right edge. Anchored to the page (the trim), the frame and
// the title stand on the page's axis, 52.5 mm in, whichever side the spine is on.
const at = (down, across) => ({ anchor: { to: 'page', edge: 'top-left' },
offset: { x: mm(down), y: mm(across) } });
const AXIS = 105 / 2; // mm
const TITLE = 28 * PT; // mm: 夢十夜 in 28 pt, three characters and two 8 pt gaps down
const frame = { kind: 'box', id: 'frame', placement: { ...at(30, AXIS - 23),
size: { width: mm(88), height: mm(46) } }, // 88 mm down, 46 mm across
style: { borderColor: col('vermilion'), borderWidth: pt(0.75) } };
const titlePage = {
id: 'title', numbered: false, toc: false, span: 'page', header: none, footer: { elements: [
// The colophon across the foot, in the edition's language: each \n in the attribute
// starts a line; the box hangs from the foot of the page, centred.
// Noto Sans JP: Shippori Mincho B1 has no ō or ū for the rōmaji.
{ kind: 'text', id: 'colophon', content: '{attr.colophon}', fontFamily: GOTHIC,
fontSize: pt(5.25), lineHeight: 1.45, color: col('muted'), overflow: 'wrap',
align: 'center', placement: { anchor: { to: 'page', edge: 'bottom' },
offset: { y: mm(-4) }, size: { width: mm(84) } } }] },
breakBefore: { enabled: true, parity: 'any' },
advancedDesign: { enabled: true, minHeight: lines(LINES), slot: { elements: [
frame,
{ kind: 'text', id: 'book', content: '{titleText}', fontFamily: MINCHO, fontWeight: 800,
fontSize: pt(28), lineHeight: 1, letterSpacing: pt(8), color: col('ink'),
placement: at(44, AXIS - TITLE / 2) },
{ kind: 'text', id: 'author', content: '{author}', fontFamily: MINCHO, fontSize: pt(11),
letterSpacing: pt(4), color: col('ink'), placement: at(92, AXIS + TITLE / 2 + 4) },
] } },
};
La portada és un títol de primer nivell amb estil propi, # 夢十夜 {style="title" …}, amb un disseny que ocupa la pàgina. Els seus elements s'ancoren a la pàgina i no a la caixa de text, perquè la caixa d'una pàgina amb marges simètrics queda descentrada 1,5 mm: x baixa per la pàgina i y la travessa des de la vora dreta, així que AXIS és la meitat de l'amplada de la pàgina, sigui quin sigui el costat del llom. El colofó del peu va en Noto Sans JP: Shippori Mincho B1 no té ō ni ū, i el PDF dibuixaria caixes buides a «Sōseki».
#6 · Carrega cada pes amb els caràcters que compon
// Fontsource cuts a Japanese face into about 120 files; loadCjkFonts fetches the ones the
// text touches (gotcha: cjk-fonts-slices). vertical: true loads the face's vertical forms
// for the canvas: 、。「」ー and small kana such as っ stand differently down a line.
const title = markdown.match(/^title: "(.*)"$/m)[1];
const author = markdown.match(/^author: "(.*)"$/m)[1];
const heads = markdown.match(/^# [^{\n]*/gm).join('');
await loadFonts(FONTS, markdown); // the Latin files: the colophon, with ō and ū
await loadCjkFonts({ [MINCHO]: ['400'] }, markdown, { vertical: true });
await loadCjkFonts({ [MINCHO]: ['600', '800'] }, `${heads}${title}${author}`);
await loadCjkFonts({ [GOTHIC]: ['400'] }, `${title}一二三四五六七八九十`, { vertical: true });
Fontsource serveix cada gruix d'una font japonesa en uns 120 fitxers, cadascun amb un tram de caràcters, i loadCjkFonts baixa els que toca el text que rep. El gruix del text rep tota la mostra amb vertical: true, que a més carrega les formes verticals de la font per al canvas: 、。「」 i ー, i els kana petits, que en vertical van a la cantonada superior dreta de la seva casella. renderToPdf rep cjkPdfProvider, que incrusta aquests mateixos fitxers com a subconjunts.
La recepta completa
// ═══ Postext Cookbook · Nº 117 · A bunko novel set vertically, with furigana ════════
// https://postext.dev/en/cookbook/bunko-novel-furigana
// Code: MIT · Text: 夏目漱石『夢十夜』, Aozora Bunko 799 (public domain) · Pictures: none
// Fonts: Shippori Mincho B1, Noto Sans JP (SIL OFL 1.1) · Needs postext ≥ 1.28.0
import {
buildDocument, withLoadedFonts, renderPageToCanvas, loadVerticalAlternates,
} from 'https://esm.sh/postext';
import { renderToPdf, decompressWoff2 } from 'https://esm.sh/postext-pdf';
const LANG = 'es'; // @lang: the language of the colophon; the novel is Japanese in both
const RECIPE = 'bunko-novel-furigana';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: sumi ink on a cream bunko stock, one vermilion
const palette = {
ink: '#1f1b18', // the text: a warm sumi black
vermilion: '#a8392b', // 朱: the frame of the title page
muted: '#6b635b', // the hashira and the folios
paper: '#fbf7ee', // bunko paper is cream, not white
};
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.vermilion, model: 'hex' } },
];
// #endregion
const [MINCHO, GOTHIC] = ['Shippori Mincho B1', 'Noto Sans JP'];
const [BODY, LEAD, CHARS, LINES] = [9, 15.75, 38, 15]; // pt, pt: 38字 × 15行 at 1.75 em
const lines = (n) => pt(n * LEAD); // n lines across the page
const PT = 25.4 / 72; // mm in a point
// #region answer: a bunko page, 38 characters down 15 lines, bound on the right
// 'vertical-rl' sets each line top to bottom and the lines from right to left; with the
// binding left to 'auto' the book opens from the right, so page 1 is a left-hand page and
// the spreads read [3 | 2]. locale 'ja' gives the cjk settings Japan's values: they are
// written out below so you can see them, and leaving them out sets the same page.
const page = {
sizePreset: 'custom', width: mm(105), height: mm(148), dpi: 200, // 文庫判 A6
backgroundColor: col('paper'),
// 天 above 地; left is the spine side (the right edge of a left-hand page). The grid
// grows the margins of each pair alike, so the head stays deeper than the foot.
margins: { top: mm(15), bottom: mm(11), left: mm(9), right: mm(12), mirror: true },
pageNumbering: { format: 'japanese-informal' }, // folios 一, 二 … 十, 十一
};
const layout = { layoutType: 'single', writingMode: 'vertical-rl' };
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
lineBreak: 'ja-very-strict', // 行頭禁則: no 、。」ー or small kana at the head of a line
L'script.js compost funciona tal com és: enganxa'l com a script de mòdul en qualsevol pàgina o obre la recepta a CodePen. Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)
Variants
#Marca les paraules que l'original destaca
Les dues primeres nits de Sōseki no tenen 傍点, però molts textos d'Aozora sí, i el convertidor els escriu :dots[…]{style=sesame}. En un document ja, *…* dona les mateixes marques de sèsam al costat de la línia, mai cursiva.
-こんな夢を見た。
+こんな*夢*を見た。#Posa tots els claudàtors un caràcter més avall
El patró ① conserva el sagnat d'un caràcter i posa el claudàtor al darrere, com fan moltes novel·les per a lectors joves.
- paragraphStartBracket: 'half', // ③: a 「 that opens a paragraph fills the indent cell
+ paragraphStartBracket: 'indent', // ①: the bracket after the one-character indent#Estreny en lloc de penjar
Amb hangingPunctuation: 'none', un 、 o un 。 que obriria la línia entra a l'anterior estrenyent-ne els claudàtors i les comes (追い込み), o l'últim caràcter d'aquella línia baixa amb ell (追い出し), i cap signe no queda sota la línia.
- hangingPunctuation: 'allow', // ぶら下げ: a 、。 that would open a line hangs below the last
+ hangingPunctuation: 'none',Errors freqüents
Error freqüent
Etiqueta un text japonès 'ja', mai zh-Hans ni LANG
Les edicions d'una recepta són en i es, però una mostra japonesa és japonesa en totes dues: `locale: LANG` l'etiquetaria com a anglès o castellà, i una etiqueta xinesa la compondria amb les regles xineses (puntuació Kaiming, kana petit lliure de començar línia, 图 en lloc de 図, formes xineses dels caràcters al PDF). Des de postext 1.30 l'etiqueta és a més la llengua en què es compon el text (en què es mesura, es pinta i s'incrusta), de manera que qualsevol etiqueta que no sigui 'ja' dona altres formes de glif que les japoneses (les xineses, amb una etiqueta xinesa) i altres talls de línia. Escriu 'ja': tria la regió del Japó (tall i puntuació de la JLReq, punts de sèsam, repartiment dels furigana, etiquetes 図 i 表) i desactiva la partició de mots. El lint falla un text amb kana sota una etiqueta zh o ko. Tall de línies japonès (kinsoku) →
Error freqüent
Les fonts xineses es carreguen per fragments, amb el bloc cjk
Fontsource serveix una família xinesa, japonesa o coreana en un centenar de fitxers per pes, cadascun amb un interval de caràcters. loadFonts només baixa el fitxer latin, així que a la pantalla els caràcters xinesos surten d'una font del sistema i es mesuren malament, i fontsourceProvider lliura al PDF aquest fitxer latin, que els imprimeix com a caixes buides. Afegeix el bloc cjk del kit, crida loadCjkFonts(FONTS, markdown) després de loadFonts (una vegada per veu, amb el text que compon, si el llibre fa servir diverses fonts xineses) i passa a renderToPdf fontProvider: cjkPdfProvider: tots dos agafen els fitxers que contenen els caràcters del text. Fonts xineses, japoneses i coreanes →
Error freqüent
Un llibre enquadernat per la dreta mostra els seus plecs amb showBook
En un llibre enquadernat per la dreta (text àrab, hebreu o persa, xinès vertical, o page.binding 'right') la pàgina 1 continua sent senar, però queda a l'esquerra del llom, i els plecs es llegeixen [3 | 2]. showPages compon tots els llibres com si s'enquadernessin per l'esquerra; showBook, del bloc book (el bloc cjk porta la mateixa funció), llegeix doc.binding i reflecteix els plecs. capture.hero continua anomenant un plec en ordre de lectura, [parella, senar]: [2, 3]. Llibres enquadernats per la dreta →
Error freqüent
Llegeix els fitxers d'Aozora com a CP932, no com a Shift_JIS
Els fitxers de text d'Aozora Bunko són en Windows-31J (CP932). Llegits com a Shift_JIS a seques, el guió ―― surt com a guions U+2014, ~ com el guió ondulat 〜, i alguns caràcters de NEC i IBM fallen. Llegeix-los com a cp932 i després converteix el marcatge: el ruby entre 《》, les notes [#…] i els gaiji ※[#…] no són Markdown i s'imprimeixen tal qual si s'hi deixen. aozora.py, de la skill, fa totes dues coses. Importar textos d'Aozora Bunko →
Error freqüent
Un interval de Fontsource pot anomenar caràcters que el seu fitxer no té
Fontsource dona a cada fitxer un unicode-range, i loadCjkFonts carrega els fitxers els intervals dels quals cobreixen la mostra, però un interval pot prometre més del que el seu fitxer té. El fragment de Zen Old Mincho per a U+3028–303F no té 〻 ni les marques de repetició llargues 〳〴〵, i la font tampoc no té les vocals amb macró ō ū ā; el fitxer latin-ext de Shippori Mincho B1 porta uns quants caràcters i cap no és ō, ū ni ā. No falla res mentre corre la recepta: a la pantalla aquests caràcters surten d'una font del sistema i es mesuren amb ella, i el PDF imprimeix la caixa .notdef de la font, que només la comprovació C25 assenyala després. Busca a la font una marca rara o una paraula en rōmaji abans de triar-la (fontTools sobre el fitxer de Fontsource) i compon aquest text amb una que la tingui: Shippori Mincho B1 i Noto Serif JP tenen 〻 i 〳〴〵; Noto Serif JP i Noto Sans JP, les vocals amb macró. Fonts xineses, japoneses i coreanes →
Error freqüent
Una pàgina vertical té dos marcs: el del text girat i el del full
Un document vertical-rl compon el text com una pàgina horitzontal girada un quart de volta en el sentit de les agulles del rellotge, i el disseny d'un títol (els elements d'advancedDesign.slot) es col·loca en aquest marc girat: x baixa per la pàgina, y la travessa cap a l'esquerra des de la vora dreta, i l'amplada d'un element es mesura cap avall. Els elements de la capçalera i el peu continuen al full: x avança cap a la dreta des de la vora esquerra i y baixa des de dalt. Un marc dibuixat a la capçalera i un títol col·locat al disseny prenen, per tant, els desplaçaments en eixos diferents. En una portada vertical, ancora els elements a `page` i mesura des de les seves vores: ancorats a `container`, els elements del peu queden uns quants mil·límetres (uns 5 mm) fora del centre de la caixa de text. Text vertical →
Crèdits
- Recepta
- Ignacio Ferro
- Text
- 夏目漱石『坊っちゃん』 (Botchan, 1906), the opening of chapter one; Aozora Bunko card 752, from 「ちくま日本文学全集 夏目漱石」 (Chikuma Shobō, 1992), input 真先芳秋, proofreading 柳沢成雄, converted with aozora.py · Natsume Sōseki; Aozora Bunko volunteers · domini públic
- Fonts
- Shippori Mincho B1 (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
- Codi
- MIT, com Postext
Editar aquest text ↗ (s'obre en una pestanya nova)Carpeta de la recepta a GitHub ↗ (s'obre en una pestanya nova)


