En pocas palabras
El papel de manuscrito japonés tiene una casilla para cada carácter. Esta página copia en él las primeras líneas de una novela famosa, con el título, el nombre del autor y cada signo donde los ponen las normas escolares japonesas.
Lo que vas a componer
Tres hojas de papel de manuscrito japonés (原稿用紙, genkō yōshi), del modelo de 400 casillas, con los tres primeros párrafos de Botchan de Natsume Sōseki copiados como lo haría un escritor o un alumno: 20 líneas de 20 casillas, leídas de arriba abajo desde la derecha, en Klee One, una letra dibujada con pluma. El título ocupa la primera línea desde la tercera casilla y el nombre del autor la segunda, una casilla antes del pie; cada párrafo empieza tras una casilla vacía. Cada carácter, kana pequeño y signo tiene su propia casilla, y un 、 o un 。 que abriría línea se escribe bajo la última casilla de la línea anterior. Un marco rojo pardo, el número de hoja y la etiqueta impresa del papel, 20×20, completan la hoja. La página china contada en caracteres es la Nº 082.
Esta receta responde a
- ¿Cómo defino la mancha en caracteres, tantos por línea y tantas líneas por página?
- ¿Por qué el kana pequeño, ー y los cierres no pueden empezar una línea en japonés, y cómo elijo lo estricta que es la regla?
La respuesta corta
// The grid makes the type area 20 characters of 20 pt down and 20 lines of 27 pt across, and
// show draws its squares. The marks are set full width with nothing squeezed, so each
// character, mark or bracket fills its own square, as on manuscript paper (原稿用紙).
const cjk = {
// fullLines: on manuscript paper every square of a full line is written in, so a line
// gives up no character to keep a lone last one company (the runt rule would leave the
// twentieth square empty in the middle of a paragraph).
grid: { enabled: true, charsPerLine: N, linesPerPage: N, show: true, fullLines: true },
compressAdjacent: false, // 。」 take two squares, not one and a half
trimLineStart: false, // a bracket at the head of a line keeps its square
// The manuscript rule: a small kana or ー may head a line (each has its own square), but
// never 、。 or a closing bracket: such a mark is written in the last square of the line
// before, hanging below it here, and no line is squeezed to take it in.
lineBreak: 'ja-loose',
hangingPunctuation: 'force',
};
Ingredientes
- Funciones
- Retícula de caracteresCorte de líneas japonés (kinsoku)Espaciado de la puntuación japonesa (yakumono)Texto verticalLibros encuadernados por la derechaTítulos que ocupan líneas del texto (gyōdori)Kana, kanji y rōmajiFuentes chinas, japonesas y coreanasImportar textos de Aozora BunkoEstilos de párrafoTextos, filetes y cajas en los diseños de páginaCabeceras y foliosColor del papelPaleta de color semánticaExportación a PDF
- También usa
- Corte de líneas en chinoAnchura de la puntuación chinaAtributos de títuloCabeceras según el tipo de páginaFuentes incrustadas en el PDF
- Tipografía
- Klee One, Noto Sans JP (SIL OFL 1.1)
- Recursos
- Ninguno: todas las imágenes se dibujan en código
Elaboración
#1 · Dibuja las casillas y da a cada signo una entera
El código es la respuesta corta de arriba. La retícula de caracteres hace que la caja mida 20 caracteres de 20 pt (7,1 mm) hacia abajo y 20 líneas de 27 pt (9,5 mm) a lo ancho, y show: true dibuja sus casillas en un gris claro propio, en pantalla, y en el PDF cuando renderToPdf recibe characterGrid: true (en un libro la retícula es una ayuda de prueba, así que el PDF la omite por defecto); la franja de 2,5 mm entre dos líneas es donde quien escribe añade lecturas y correcciones. Un signo japonés es medio glifo y media eme de blanco, y un libro recoge blancos donde se juntan dos signos o donde un corchete abre línea. En el papel de manuscrito cada signo conserva su casilla, así que compressAdjacent: false pone 。」 en dos casillas y trimLineStart: false deja a un corchete al principio de línea su casilla entera (Tipografía de Asia oriental).
#2 · Sigue las normas de línea del manuscrito
El papel de manuscrito tiene su propio kinsoku. Un kana pequeño o una ー pueden empezar línea, cada uno en su casilla; ja-loose lo permite. Un 、 o un 。 que abriría línea se escribe en la última casilla de la anterior, junto al carácter que hay allí, o justo debajo; hangingPunctuation: 'force' lo cuelga bajo la vigésima casilla, y ninguna línea se aprieta nunca. Con 'allow', el valor por defecto en japonés, el motor mete primero el signo en la línea apretando a media casilla otro 、 de dentro, lo que hace un libro impreso y nunca un manuscrito: el resto de esa línea quedaría media casilla más arriba, cruzando las líneas de la retícula.
La última línea de un párrafo pide un ajuste más. Postext evita que un párrafo acabe en un solo carácter: la línea anterior le cede el último suyo, y como aquí el texto no va justificado, esa línea se quedaría con una casilla vacía. En el papel de manuscrito se escribe en todas las casillas de una línea completa, así que la retícula lleva fullLines: true: en la hoja 3 la línea que acaba en 来 conserva sus veinte casillas y el párrafo se cierra con た。 solo (retícula de caracteres).
#3 · Escribe el título y el nombre donde los ponen las normas
// The title on the first line, two squares down; the writer's name on the second, ending a
// square above the foot (地から一字上げ), a blank square between family and given names.
// lineSpan: 1 keeps the title on one line of the grid, in the text's own size and face.
const title = { level: 1, fontFamily: PEN, fontSize: pt(CELL), fontWeight: 400, lineSpan: 1,
indent: em(2), breakBefore: { enabled: true, parity: 'any' } }; // the next sheet, either side
const paragraphStyles = [
{ id: 'name', textAlign: 'end', endIndent: em(1), firstLineIndent: em(0) },
];
El título es un título del cuerpo y la letra del texto, de modo que llena casillas como cualquier otra línea: lineSpan: 1 lo mantiene en una línea de la retícula e indent: em(2) deja dos casillas vacías encima (Configuración por nivel). El nombre es un párrafo con textAlign: 'end' y endIndent: em(1), que lo acaba una casilla antes del pie, y el Markdown escribe la casilla en blanco entre apellido y nombre como un espacio ideográfico: 夏目 漱石. El texto empieza en la tercera línea, y cada párrafo tras una casilla vacía, la de firstLineIndent: em(1).
#4 · Imprime la hoja alrededor de las casillas
// The header is drawn on the sheet itself, not in the turned frame of the text: x runs right
// from the left edge, y down from the top. The frame stands 1.5 mm off the squares and 8 mm
// below them, where a 、 or 。 that cannot head a line is written outside the last square.
const box = (id, inset, foot, thickness) => ({ kind: 'box', id, pages: 'all',
placement: { anchor: { to: 'page', edge: 'top-left' },
offset: { x: mm(MARGIN.side - inset), y: mm(MARGIN.top - inset) },
size: { width: mm(GRID.across + 2 * inset), height: mm(GRID.down + inset + foot) } },
style: { borderColor: col('ruling'), borderWidth: pt(thickness) } });
const FOOT = MARGIN.top + GRID.down + 8; // mm: the frame's foot
const below = (id, content, x, extra) => ({ kind: 'text', id, content, pages: 'all',
placement: { anchor: { to: 'page', edge: 'top-left' }, offset: { x: mm(x), y: mm(FOOT + 3) } },
...extra });
const header = { elements: [
box('outer', 2.6, 9.1, 1.2), box('inner', 1.5, 8, 0.4),
// The sheet number, as a writer numbers the sheets; the paper's printed label.
below('sheet', '({pageNumber})', MARGIN.side, { fontFamily: PEN, fontSize: pt(9),
color: col('muted') }),
below('label', '20×20', MARGIN.side + GRID.across - 12, { fontFamily: 'Noto Sans JP',
fontSize: pt(7), letterSpacing: pt(0.5), color: col('ruling') }),
] };
const footer = { elements: [{ kind: 'text', id: 'colophon', content: '{attr.colophon}',
pages: 'opener', fontFamily: 'Noto Sans JP', fontSize: pt(6), lineHeight: 1.4,
color: col('muted'), overflow: 'wrap', align: 'center',
placement: { anchor: { to: 'page', edge: 'bottom' }, offset: { y: mm(-5) },
size: { width: mm(120) } } }] };
Los elementos de la cabecera se dibujan sobre la propia hoja: en una página vertical, x va hacia la derecha e y hacia abajo desde la esquina superior izquierda, al revés que el diseño de un título, que se compone en el marco girado del texto. El doble marco queda a 1,5 mm de las casillas por tres lados y a 8 mm por debajo, donde caen los signos colgados. GRID y MARGIN lo colocan con los mismos números con que se hacen los márgenes de la página; los márgenes que recibe la página son medio milímetro más pequeños, porque la retícula los toma como mínimos y un ajuste exacto podría redondear a 19 líneas.
#5 · Compónlo en una letra de pluma
// Klee One draws the strokes of a pen, with the Japanese forms of the kanji; its vertical
// forms put 、。 in the upper right of their square and turn ー and the brackets.
const colophon = markdown.match(/colophon="([^"]*)"/)[1];
await loadFonts(FONTS, markdown); // the Latin files: the colophon
await loadCjkFonts({ [PEN]: ['400'] }, `${markdown}()一二三四五六七八九十`, { vertical: true });
await loadCjkFonts({ 'Noto Sans JP': ['400'] }, `20×20${colophon}`);
Klee One está dibujada con pluma y conserva las formas japonesas de los kanji, así que las hojas se leen como manuscritas sin las irregularidades de un escaneado. Sus formas verticales ponen 、。 en la esquina superior derecha de su casilla y giran ー y los corchetes, que es donde los pone quien escribe. Como todas las familias japonesas de Fontsource, viene en unos 120 archivos, y loadCjkFonts descarga los que necesita el texto (Fuentes chinas, japonesas y coreanas).
La receta completa
// ═══ Postext Cookbook · Nº 120 · A story on genkō yōshi, one character to a square ═══
// https://postext.dev/en/cookbook/genko-yoshi-manuscript
// Code: MIT · Text: 夏目漱石『坊っちゃん』, Aozora Bunko 752 (public domain) · Pictures: none
// Fonts: Klee One, 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 manuscript is Japanese in both
const RECIPE = 'genko-yoshi-manuscript';
// ─── 1 · Design ─────────────────────────────────────────────────────────────
// #region palette: blue-black ink on a sheet ruled in red-brown
const palette = {
ink: '#1f2a44', // the pen: a blue-black
ruling: '#b0573f', // the sheet's printed frame, its label
muted: '#7b6f66', // the sheet number
paper: '#fdfaf3',
};
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.ruling, model: 'hex' } },
];
// #endregion
const PEN = 'Klee One'; // a pen-written kaisho with Japanese forms
const [CELL, PITCH, N] = [20, 27, 20]; // pt: a 7 mm square, a 2.5 mm strip beside each line
const PT = 25.4 / 72; // mm in a point
const SHEET = { w: 230, h: 200 }; // mm
const GRID = { down: N * CELL * PT, across: N * PITCH * PT }; // 141.1 × 190.5 mm
const MARGIN = { top: 32, side: (SHEET.w - GRID.across) / 2 }; // mm
// The margins handed to the page are a hair smaller: the grid takes them as minimums and
// grows them back, where an exact fit could round to 19 lines.
const SLACK = 0.5; // mm
// #region answer: 20 squares down 20 lines, the squares drawn, every character in one
// The grid makes the type area 20 characters of 20 pt down and 20 lines of 27 pt across, and
// show draws its squares. The marks are set full width with nothing squeezed, so each
// character, mark or bracket fills its own square, as on manuscript paper (原稿用紙).
const cjk = {
// fullLines: on manuscript paper every square of a full line is written in, so a line
// gives up no character to keep a lone last one company (the runt rule would leave the
// twentieth square empty in the middle of a paragraph).
grid: { enabled: true, charsPerLine: N, linesPerPage: N, show: true, fullLines: true },
compressAdjacent: false, // 。」 take two squares, not one and a half
trimLineStart: false, // a bracket at the head of a line keeps its square
// The manuscript rule: a small kana or ー may head a line (each has its own square), but
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
#Comprueba la retícula de un libro con las mismas casillas
show: true sirve en cualquier retícula de caracteres: en el bunko de la Nº 117 dibuja las 38 × 15 casillas sobre el texto, una forma rápida de ver que cada línea se ciñe a la retícula y cada título a sus tres líneas.
- grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
+ grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES, show: true },#Deja que los signos se aprieten, como en una página impresa
Con el valor por defecto en japonés las hojas parecen un libro mecanografiado en papel cuadriculado: un 、 que abriría línea se recoge apretando otro, y el resto de esa línea queda media casilla fuera de la retícula.
- hangingPunctuation: 'force',
+ hangingPunctuation: 'allow',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
Una página vertical tiene dos marcos: el del texto girado y el de la hoja
Un documento vertical-rl compone el texto como una página horizontal girada un cuarto de vuelta en el sentido de las agujas del reloj, y el diseño de un título (los elementos de advancedDesign.slot) se coloca en ese marco girado: x baja por la página, y la cruza hacia la izquierda desde el borde derecho, y el ancho de un elemento se mide hacia abajo. Los elementos de la cabecera y el pie siguen en la hoja: x avanza hacia la derecha desde el borde izquierdo e y baja desde arriba. Un marco dibujado en la cabecera y un título colocado en el diseño toman, por tanto, sus desplazamientos en ejes distintos. En una portada vertical, ancla los elementos a `page` y mide desde sus bordes: anclados a `container`, los elementos del pie quedan unos milímetros (unos 5 mm) fuera del centro de la caja de texto. Texto vertical →
Créditos
- Receta
- Ignacio Ferro
- Texto
- 夏目漱石『坊っちゃん』 (Botchan, 1906), los tres primeros párrafos, sin las lecturas; ficha 752 de Aozora Bunko, según 「ちくま日本文学全集 夏目漱石」 (Chikuma Shobō, 1992), transcripción de 真先芳秋, corrección de 柳沢成雄, convertida con aozora.py · Natsume Sōseki; Aozora Bunko volunteers · dominio público
- Fuentes
- Klee One (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)


