En pocas palabras
Un cuento clásico japonés con explicaciones breves de sus viejos topónimos. Los números pequeños van junto al texto, y las explicaciones de las dos páginas abiertas se reúnen en el borde exterior de la página izquierda.
Lo que vas a componer
Cuatro páginas de una edición 四六判 de Juegos de niños (たけくらべ, 1895–96) de Higuchi Ichiyō, su primer capítulo, con siete notas sobre el viejo barrio de Yoshiwara que describe. Las notas son 傍注 (bōchū), las notas laterales de los clásicos japoneses de bolsillo: un (1) pequeño va a la derecha de la línea tras la palabra que explica, y las notas que se citan en las dos páginas de una doble página se componen en el corte delantero de la página izquierda, bajo un filete de un tercio de línea, en un cuerpo una quinta parte menor. Quien lee encuentra cada nota sin pasar página. El texto, de 42 caracteres por 17 líneas en Shippori Mincho de 9,25 pt, conserva el único párrafo larguísimo de Ichiyō y sus marcas de sésamo sobre ぎつちよんちよん. Las notas al pie de columna de una novela europea son la Nº 071.
Esta receta responde a
- ¿Cómo compongo las notas de un libro japonés: (1) al final del capítulo, al pie de la página o junto al texto en la doble página?
- ¿Cómo hago notas al pie?
- ¿Cómo marco un texto japonés con puntos de sésamo o una línea lateral en lugar de cursiva?
La respuesta corta
// 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' },
};
Ingredientes
- Funciones
- Notas de los libros japonesesNotas al pieMarcas de énfasis japonesas (bōten)Texto verticalLibros encuadernados por la derechaFurigana: lecturas en kana sobre los kanjiNúmeros en pie en texto verticalNumerales japoneses y contadores en kanaTítulos que ocupan líneas del texto (gyōdori)Retícula de caracteresCorte de líneas japonés (kinsoku)Importar textos de Aozora BunkoFuentes chinas, japonesas y coreanasCabeceras y foliosCabeceras según el tipo de páginaEstilos de títuloAperturas diseñadasMárgenes simétricosPaleta de color semánticaExportación a PDF
- También usa
- Corte de líneas en chinoPuntos de énfasis y líneas de nombre y de títuloAtributos de títuloColor del papelFuentes incrustadas en el PDFPreliminares en romanosRuby: lecturas en pinyin y zhuyin
- Tipografía
- Shippori Mincho, Noto Sans JP (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Reúne las notas del pliego en el corte de la página izquierda
El código es la respuesta corta de arriba. footnotes.placement: 'spread' compone las notas citadas en las páginas 2 y 3 al final del texto de la página 3, que en un libro encuadernado por la derecha es su corte delantero, y numbering: 'spread' empieza en (1) las notas de cada doble página (Notas al pie). Una nota citada en la página derecha espera a la izquierda; si las notas dejaran a la página izquierda menos de una línea de texto, las que sobran se quedan al pie de la página derecha, como permite JLReq. Un documento ja ya compone las llamadas de un libro vertical como ({n}) a la derecha de la línea, a 0,7 em y con las cifras derechas, no tumbadas: las dos líneas escritas aquí lo muestran. numberGap: 'em' deja un carácter entero de nota tras el número y hangingIndent: em(2) alinea las líneas siguientes detrás de él.
#2 · Escribe las llamadas donde las pone el japonés
El Markdown escribe 見返り柳[^1] tras la palabra que explica la nota, y las notas como párrafos [^1]: … al final del capítulo. La llamada sigue a la palabra que explica; si cierra una frase, va antes de su 。 (…先生[^1]。), y el motor nunca deja que un 。 o una llamada empiecen línea. Las siete notas se escribieron para esta receta: qué eran el 見返り柳 y la お齒ぐろ溝, dónde quedaba 大音寺前, qué se vendía en el 酉の市, en un japonés moderno y llano.
#3 · Conserva las marcas de sésamo del original
cjk.emphasisMark decide qué imprimen *…* y :dots[…] en este libro: puntos de sésamo, a la derecha de una línea vertical. Un documento ja ya los usa; escritos, activan el kenten en la lista de funciones. El texto de Aozora marca ぎつちよんちよん con 傍点, y aozora.py lo escribió :dots[ぎつちよんちよん]{style=sesame}; los libros chinos ponen los puntos debajo de la línea (Marcas, ruby y warichu).
#4 · Abre en un pliego
// 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ítulo cita cuatro notas en sus tres primeras líneas. Bajo un título en la página 1 dejarían sitio para tres líneas de texto: la página izquierda solo lleva sus propias notas. Una portada sola en la página 1 lleva el capítulo a la página 2, una página derecha, y la primera doble página reúne el texto y todas sus notas. La portada es un encabezado de primer nivel cuyo diseño ocupa la página, anclado al formato para que el título quede en el eje de la página.
#5 · Pon el hashira y los folios en el corte delantero
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ítulo baja por el margen exterior de las páginas izquierdas, por fuera de las notas, y los folios en kanji van al pie de todas las páginas menos la portada.
La receta 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' },
};
El script.js compuesto funciona tal cual: pégalo como script de módulo en cualquier página o abre la receta en CodePen. Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)
Variantes
#Reúne las notas al final del capítulo
Sin placement, un libro ja vertical compone sus notas como 後注 (kōchū): tras el texto del capítulo, bajo el mismo filete y numeradas a lo largo del capítulo. Aquí ocupan la mitad izquierda 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',#Pon la llamada junto a la palabra
markerPosition: 'side' compone una llamada más pequeña en el hueco junto a la línea, como un ruby entre líneas, de modo que no ocupa sitio en la línea.
- markerPosition: 'right', markerTemplate: '({n})', // written out: 'ja' sets them so
+ markerPosition: 'side', markerTemplate: '{n}',Errores frecuentes
Error frecuente
Etiqueta un texto japonés 'ja', nunca zh-Hans ni LANG
Las ediciones de una receta son en y es, pero una muestra japonesa es japonesa en las dos: `locale: LANG` la etiquetaría como inglés o español, y una etiqueta china la compondría con las reglas chinas (puntuación Kaiming, kana pequeño libre de empezar línea, 图 en lugar de 図, formas chinas de los caracteres en el PDF). Desde postext 1.30 la etiqueta es además el idioma en el que se compone el texto (en el que se mide, se pinta y se incrusta), así que cualquier etiqueta que no sea 'ja' da otras formas de glifo que las japonesas (las chinas, con una etiqueta china) y otros cortes de línea. Escribe 'ja': elige la región de Japón (corte y puntuación de la JLReq, puntos de sésamo, reparto de los furigana, etiquetas 図 y 表) y desactiva la separación silábica. El lint falla un texto con kana bajo una etiqueta zh o ko. Corte de líneas japonés (kinsoku) →
Error frecuente
Las fuentes chinas se cargan por fragmentos, con el bloque cjk
Fontsource sirve una familia china, japonesa o coreana en un centenar de archivos por peso, cada uno con un intervalo de caracteres. loadFonts solo descarga el archivo latin, así que en pantalla los caracteres chinos salen de una fuente del sistema y se miden mal, y fontsourceProvider entrega al PDF ese archivo latin, que los imprime como cajas vacías. Añade el bloque cjk del kit, llama a loadCjkFonts(FONTS, markdown) después de loadFonts (una vez por voz, con el texto que compone, si el libro usa varias fuentes chinas) y pasa a renderToPdf fontProvider: cjkPdfProvider: ambos toman los archivos que contienen los caracteres del texto. Fuentes chinas, japonesas y coreanas →
Error frecuente
Un libro encuadernado por la derecha muestra sus pliegos con showBook
En un libro encuadernado por la derecha (texto árabe, hebreo o persa, chino vertical, o page.binding 'right') la página 1 sigue siendo impar, pero queda a la izquierda del lomo, y los pliegos se leen [3 | 2]. showPages compone todos los libros como si se encuadernaran por la izquierda; showBook, del bloque book (el bloque cjk trae la misma función), lee doc.binding y refleja los pliegos. capture.hero sigue nombrando un pliego en orden de lectura, [par, impar]: [2, 3]. Libros encuadernados por la derecha →
Créditos
- Receta
- Ignacio Ferro
- Texto
- 樋口一葉「たけくらべ」 (Juegos de niños, 1895–96), capítulo primero; ficha 389 de Aozora Bunko, según 「日本現代文學全集10 樋口一葉集」 (Kōdansha, 1962), transcripción de 青空文庫, corrección de 米田進 y 小林繁雄, convertida con aozora.py; las siete notas se escribieron para esta receta (CC BY 4.0) · Higuchi Ichiyō; Aozora Bunko volunteers · dominio público
- Fuentes
- Shippori Mincho (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
- Código
- MIT, como Postext
Editar este texto ↗ (se abre en una nueva pestaña)Carpeta de la receta en GitHub ↗ (se abre en una nueva pestaña)


