En poques paraules
Un conte clàssic japonès amb explicacions breus dels seus vells topònims. Els números petits van al costat del text, i les explicacions de les dues pàgines obertes s'apleguen a la vora exterior de la pàgina de l'esquerra.
Què compondràs
Quatre pàgines d'una edició 四六判 de Jocs d'infants (たけくらべ, 1895–96) de Higuchi Ichiyō, el seu primer capítol, amb set notes sobre el vell barri de Yoshiwara que descriu. Les notes són 傍注 (bōchū), les notes laterals dels clàssics japonesos de butxaca: un (1) petit va a la dreta de la línia després de la paraula que explica, i les notes citades a les dues pàgines d'una doble pàgina es componen al tall de la pàgina de l'esquerra, sota un filet d'un terç de línia, en un cos una cinquena part més petit. El lector troba cada nota sense girar full. El text, de 42 caràcters per 17 línies en Shippori Mincho de 9,25 pt, conserva l'únic paràgraf llarguíssim d'Ichiyō i les seves marques de sèsam sobre ぎつちよんちよん. Les notes a peu de columna d'una novel·la europea són la Núm. 071.
Aquesta recepta respon a
- Com componc les notes d'un llibre japonès: (1) al final del capítol, al peu de la pàgina o al costat del text a la doble pàgina?
- Com faig notes a peu de pàgina?
- Com marco un text japonès amb punts de sèsam o una línia lateral en lloc de cursiva?
La resposta curta
// placement 'spread' gathers the notes cited on the two pages of a spread at the end of the
// left-hand page's text, the fore-edge in a book bound on the right, under a rule a third of
// the line long, and numbers them per spread. The marker (1) stands small at the right of
// the line, its digits upright, and the note opens with its number and a full note-em.
const footnotes = {
placement: 'spread', // 傍注; 'chapterEnd' sets 後注 after the chapter instead
numbering: 'spread',
markerPosition: 'right', markerTemplate: '({n})', // written out: 'ja' sets them so
numberGap: 'em', hangingIndent: em(2), // turnovers clear the number
fontSize: em(0.8), lineHeight: em(1.5),
separator: { width: 1 / 3, lineWidth: pt(0.5), color: col('plum') },
};
// Ichiyō's sesame marks (傍点) over ぎつちよんちよん: the mark Japan uses, right of the line.
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
emphasisMark: { style: 'sesame', position: 'over' },
};
Ingredients
- Funcions
- Notes dels llibres japonesosNotes a peu de pàginaMarques d'èmfasi japoneses (bōten)Text verticalLlibres enquadernats per la dretaFurigana: lectures en kana sobre els kanjiNúmeros drets en text verticalNumerals japonesos i comptadors en kanaTítols que ocupen línies del text (gyōdori)Retícula de caràctersTall de línies japonès (kinsoku)Importar textos d'Aozora BunkoFonts xineses, japoneses i coreanesCapçaleres i folisCapçaleres segons el tipus de pàginaEstils de títolObertures dissenyadesMarges simètricsPaleta de color semànticaExportació a PDF
- També fa servir
- Tall de línies en xinèsPunts d'èmfasi i línies de nom i de títolAtributs de títolColor del paperFonts incrustades al PDFPreliminars en romansRuby: lectures en pinyin i zhuyin
- Tipografia
- Shippori Mincho, Noto Sans JP (SIL OFL 1.1)
- Recursos
- Cap: totes les imatges es dibuixen en codi
Elaboració
#1 · Aplega les notes del plec al tall de la pàgina de l'esquerra
El codi és la resposta curta de més amunt. footnotes.placement: 'spread' compon les notes citades a les pàgines 2 i 3 al final del text de la pàgina 3, que en un llibre enquadernat per la dreta és el seu tall, i numbering: 'spread' comença en (1) les notes de cada doble pàgina (Notes a peu de pàgina). Una nota citada a la pàgina de la dreta espera a la de l'esquerra; si les notes deixessin a la pàgina de l'esquerra menys d'una línia de text, les que sobren es queden al peu de la pàgina de la dreta, com permet JLReq. Un document ja ja compon les crides d'un llibre vertical com ({n}) a la dreta de la línia, a 0,7 em i amb les xifres dretes, no ajagudes: les dues línies escrites aquí ho mostren. numberGap: 'em' deixa un caràcter sencer de nota després del número i hangingIndent: em(2) alinea les línies següents al darrere.
#2 · Escriu les crides on les posa el japonès
El Markdown escriu 見返り柳[^1] després de la paraula que explica la nota, i les notes com a paràgrafs [^1]: … al final del capítol. La crida segueix la paraula que explica; si tanca una frase, va abans del seu 。 (…先生[^1]。), i el motor mai no deixa que un 。 o una crida comencin línia. Les set notes es van escriure per a aquesta recepta: què eren el 見返り柳 i la お齒ぐろ溝, on era 大音寺前, què es venia al 酉の市, en un japonès modern i planer.
#3 · Conserva les marques de sèsam de l'original
cjk.emphasisMark decideix què imprimeixen *…* i :dots[…] en aquest llibre: punts de sèsam, a la dreta d'una línia vertical. Un document ja ja els fa servir; escrits, activen el kenten a la llista de funcions. El text d'Aozora marca ぎつちよんちよん amb 傍点, i aozora.py el va escriure :dots[ぎつちよんちよん]{style=sesame}; els llibres xinesos posen els punts sota la línia (Marques, ruby i warichu).
#4 · Comença en un plec
// Page-anchored design on a vertical page: x runs down the page from its top edge, y across
// it leftwards from its right edge. The title stands on the page's axis, the author lower.
const PT = 25.4 / 72; // mm in a point
const page = (down, across) => ({ anchor: { to: 'page', edge: 'top-left' },
offset: { x: mm(down), y: mm(across) } });
const TITLE = 26; // pt
// parity 'any': the story opens on the next page, either side (the default waits for a recto).
const story = { level: 1, breakBefore: { enabled: true, parity: 'any' },
advancedDesign: { enabled: true, minHeight: lines(LINES), slot: { elements: [
{ kind: 'text', id: 'title', content: '{titleText}', fontFamily: MINCHO, fontWeight: 700,
fontSize: pt(TITLE), lineHeight: 1, letterSpacing: pt(TITLE / 2), color: col('ink'),
placement: page(42, 127 / 2 - (TITLE * PT) / 2) },
{ kind: 'rule', id: 'rule', direction: 'horizontal', thickness: pt(0.6), color: col('plum'),
placement: { ...page(42, 127 / 2 + (TITLE * PT) / 2 + 5), size: { width: mm(24) } } },
{ kind: 'text', id: 'author', content: '{author}', fontFamily: MINCHO, fontSize: pt(12),
letterSpacing: pt(4), color: col('ink'),
placement: page(118, 127 / 2 + (TITLE * PT) / 2 + 3) },
] } } };
const section = { level: 2, fontFamily: MINCHO, fontWeight: 700, fontSize: pt(11),
lineSpan: 3, indent: em(7) }; // 3行取り, seven characters down, as the Aozora text marks it
La primera frase del capítol cita quatre notes a les seves tres primeres línies. Sota un títol a la pàgina 1 deixarien lloc per a tres línies de text: la pàgina de l'esquerra només porta les seves pròpies notes. Una portada sola a la pàgina 1 porta el capítol a la pàgina 2, una pàgina de la dreta, i la primera doble pàgina aplega el text i totes les seves notes. La portada és un títol de primer nivell amb un disseny que ocupa la pàgina, ancorat al format perquè el títol quedi a l'eix de la pàgina.
#5 · Posa el hashira i els folis al tall
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'),
foreEdge('folio', '{pageNumber}', 'all', 'bottom', -2, 'body'),
] };
// The title page carries the colophon across the foot, in the edition's language.
const footer = { elements: [{ kind: 'text', id: 'colophon', content: '{attr.colophon}',
pages: 'opener', fontFamily: GOTHIC, fontSize: pt(5.5), lineHeight: 1.45,
color: col('muted'), overflow: 'wrap', align: 'center',
placement: { anchor: { to: 'page', edge: 'bottom' }, offset: { y: mm(-6) },
size: { width: mm(100) } } }] };
El títol baixa pel marge exterior de les pàgines de l'esquerra, per fora de les notes, i els folis en kanji van al peu de totes les pàgines menys la portada.
La recepta completa
// ═══ Postext Cookbook · Nº 121 · Notes beside a vertical Japanese text, across the spread ══
// https://postext.dev/en/cookbook/vertical-notes-and-sidenotes
// Code: MIT · Text: 樋口一葉『たけくらべ』, Aozora Bunko 389 (PD); notes CC BY 4.0 · 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 = 'es'; // @lang: the language of the colophon; the story is Japanese in both
const RECIPE = 'vertical-notes-and-sidenotes';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: ink, a muted plum for the note numbers' rule, cream paper
const palette = {
ink: '#211d1b', // the text and the notes
plum: '#6b3a55', // 紫: the rule over the notes, the engine's defaults
muted: '#6b645d', // the hashira and the folios
paper: '#fbf7ef',
};
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.plum, model: 'hex' } },
];
// #endregion
const [MINCHO, GOTHIC] = ['Shippori Mincho', 'Noto Sans JP'];
const [BODY, LEAD, CHARS, LINES] = [9.25, 16.25, 42, 17]; // pt, pt: 四六判 42字 × 17行
const lines = (n) => pt(n * LEAD);
// #region answer: 傍注, the notes of both pages of a spread at the fore-edge of the left one
// placement 'spread' gathers the notes cited on the two pages of a spread at the end of the
// left-hand page's text, the fore-edge in a book bound on the right, under a rule a third of
// the line long, and numbers them per spread. The marker (1) stands small at the right of
// the line, its digits upright, and the note opens with its number and a full note-em.
const footnotes = {
placement: 'spread', // 傍注; 'chapterEnd' sets 後注 after the chapter instead
numbering: 'spread',
markerPosition: 'right', markerTemplate: '({n})', // written out: 'ja' sets them so
numberGap: 'em', hangingIndent: em(2), // turnovers clear the number
fontSize: em(0.8), lineHeight: em(1.5),
separator: { width: 1 / 3, lineWidth: pt(0.5), color: col('plum') },
};
// Ichiyō's sesame marks (傍点) over ぎつちよんちよん: the mark Japan uses, right of the line.
const cjk = {
grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
emphasisMark: { style: 'sesame', position: 'over' },
};
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
#Aplega les notes al final del capítol
Sense placement, un llibre ja vertical compon les notes com a 後注 (kōchū): després del text del capítol, sota el mateix filet i numerades al llarg del capítol. Aquí ocupen la meitat esquerra de la pàgina 4.
- placement: 'spread', // 傍注; 'chapterEnd' sets 後注 after the chapter instead
- numbering: 'spread',
+ placement: 'chapterEnd', // 後注, the default for a vertical ja book
+ numbering: 'chapter',#Posa la crida al costat de la paraula
markerPosition: 'side' compon una crida més petita al buit del costat de la línia, com un ruby entre línies, de manera que no ocupa lloc a la línia.
- markerPosition: 'right', markerTemplate: '({n})', // written out: 'ja' sets them so
+ markerPosition: 'side', markerTemplate: '{n}',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 →
Crèdits
- Recepta
- Ignacio Ferro
- Text
- 樋口一葉「たけくらべ」 (Child’s Play, 1895–96), chapter one; Aozora Bunko card 389, from 「日本現代文學全集10 樋口一葉集」 (Kōdansha, 1962), input 青空文庫, proofreading 米田進 and 小林繁雄, converted with aozora.py; the seven notes were written for this recipe (CC BY 4.0) · Higuchi Ichiyō; Aozora Bunko volunteers · domini públic
- Fonts
- Shippori Mincho (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)


