Saltar al contingut principal
Recepta número 120

Receptari · Capítol 1 · Pàgina i retícula

Un relat en genkō yōshi, un caràcter per casella

Botchan en paper de manuscrit de 400 caselles: una retícula de 20 × 20 dibuixada, un caràcter o signe per casella i els 、。 d'inici de línia, penjats.

En aquesta pàgina
Sortida
Canvas · PDF
Nivell
Intermedi
Postext
Provada amb Postext 1.65.0
Requereix ≥ 1.28.0 · postext-pdf ≥ 1.28.0
Llicència
Actualitzada el 11 d’oct. del 2026
Codi MIT · Text CC BY 4.0
  • Mostra en castellà: encara no hi ha edició en català
  • Format 230 × 200 mm
  • 1 columna
  • Klee One 20/27
  • Noto Sans JP
  • 3 pàgines
  • Nivell
  • Postext 1.65.0
  • Compost en 53 ms
  • 131 línies de codi

En poques paraules

El paper de manuscrit japonès té una casella per a cada caràcter. Aquesta pàgina hi copia les primeres línies d'una novel·la famosa, amb el títol, el nom de l'autor i cada signe on els posen les normes escolars japoneses.

Què compondràs

Tres fulls de paper de manuscrit japonès (原稿用紙, genkō yōshi), del model de 400 caselles, amb els tres primers paràgrafs de Botchan de Natsume Sōseki copiats com ho faria un escriptor o un alumne: 20 línies de 20 caselles, llegides de dalt a baix des de la dreta, en Klee One, una lletra dibuixada amb ploma. El títol ocupa la primera línia des de la tercera casella i el nom de l'autor la segona, una casella abans del peu; cada paràgraf comença després d'una casella buida. Cada caràcter, kana petit i signe té la seva pròpia casella, i un 、 o un 。 que obriria línia s'escriu sota l'última casella de la línia anterior. Un marc vermell terrós, el número de full i l'etiqueta impresa del paper, 20×20, completen el full. La pàgina xinesa comptada en caràcters és la Núm. 082.

Aquesta recepta respon a

  • Com defineixo la caixa en caràcters, tants per línia i tantes línies per pàgina?
  • Per què el kana petit, ー i els tancaments no poden començar una línia en japonès, i com trio com d'estricta és la regla?

La resposta curta

script.js · línies 38–53al codi complet
// 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',
};

Ingredients

Tipografia
Klee One, Noto Sans JP (SIL OFL 1.1)
Recursos
Cap: totes les imatges es dibuixen en codi

Elaboració

#1 · Dibuixa les caselles i dona a cada signe una de sencera

El codi és la resposta curta de més amunt. La retícula de caràcters fa que la caixa de text mesuri 20 caràcters de 20 pt (7,1 mm) cap avall i 20 línies de 27 pt (9,5 mm) d'amplada, i show: true en dibuixa les caselles en un gris clar propi a la pantalla, i al PDF quan renderToPdf rep characterGrid: true (en un llibre la retícula és una ajuda per a les proves, així que el PDF l'omet per defecte); la franja de 2,5 mm entre dues línies és on qui escriu afegeix lectures i correccions. Un signe japonès és mig glif i mig quadratí de blanc, i un llibre recull blancs on es troben dos signes o on un claudàtor obre línia. Al paper de manuscrit cada signe conserva la seva casella, així que compressAdjacent: false posa 。」 en dues caselles i trimLineStart: false deixa a un claudàtor a l'inici de línia la seva casella sencera (Tipografia de l'Àsia oriental).

#2 · Segueix les normes de línia del manuscrit

El paper de manuscrit té el seu propi kinsoku. Un kana petit o una ー poden començar línia, cadascun a la seva casella; ja-loose ho permet. Un 、 o un 。 que obriria línia s'escriu a l'última casella de l'anterior, al costat del caràcter que hi ha, o just a sota; hangingPunctuation: 'force' el penja sota la vintena casella, i cap línia no s'estreny mai. Amb 'allow', el valor per defecte en japonès, el motor primer fa entrar el signe a la línia estrenyent fins a mitja casella un altre 、 de dins, cosa que fa un llibre imprès i mai un manuscrit: la resta d'aquella línia quedaria mitja casella més amunt, travessant les línies de la retícula.

L'última línia d'un paràgraf demana un ajust més. Postext evita que un paràgraf acabi en un sol caràcter: la línia anterior li cedeix el seu últim, i com que aquí el text no va justificat, aquella línia es quedaria amb una casella buida. Al paper de manuscrit s'escriu a totes les caselles d'una línia completa, així que la retícula porta fullLines: true: al full 3 la línia que acaba en 来 conserva les vint caselles i el paràgraf es tanca amb た。 sol (retícula de caràcters).

#3 · Escriu el títol i el nom on els posen les normes

script.js · línies 57–64al codi complet
// 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ítol té el cos i la lletra del text, de manera que omple caselles com qualsevol altra línia: lineSpan: 1 el manté en una línia de la retícula i indent: em(2) deixa dues caselles buides al damunt (Configuració per nivell). El nom és un paràgraf amb textAlign: 'end' i endIndent: em(1), que l'acaba una casella abans del peu, i el Markdown escriu la casella en blanc entre cognom i nom com un espai ideogràfic: 夏目 漱石. El text comença a la tercera línia, i cada paràgraf després d'una casella buida, la de firstLineIndent: em(1).

#4 · Imprimeix el full al voltant de les caselles

script.js · línies 68–92al codi complet
// 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) } } }] };

Els elements de la capçalera es dibuixen sobre el mateix full: en una pàgina vertical, x va cap a la dreta i y cap avall des de la cantonada superior esquerra, al revés que el disseny d'un títol, que es compon en el marc girat del text. El doble marc queda a 1,5 mm de les caselles per tres costats i a 8 mm per sota, on cauen els signes penjats. GRID i MARGIN el col·loquen amb els mateixos números amb què es fan els marges de la pàgina; els marges que rep la pàgina són mig mil·límetre més petits, perquè la retícula els pren com a mínims i un ajust exacte podria arrodonir a 19 línies.

#5 · Compon-lo en una lletra de ploma

script.js · línies 144–149al codi complet
// 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à dibuixada amb ploma i conserva les formes japoneses dels kanji, així que els fulls es llegeixen com a manuscrits sense les irregularitats d'un escaneig. Les seves formes verticals posen 、。 a la cantonada superior dreta de la casella i giren ー i els claudàtors, que és on els posa qui escriu. Com totes les famílies japoneses de Fontsource, arriba en uns 120 fitxers, i loadCjkFonts baixa els que necessita el text (Fonts xineses, japoneses i coreanes).

La recepta completa

Sandbox
// ═══ 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

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

#Comprova la retícula d'un llibre amb les mateixes caselles

show: true funciona en qualsevol retícula de caràcters: al bunko de la Núm. 117 dibuixa les 38 × 15 caselles sobre el text, una manera ràpida de veure que cada línia s'ajusta a la retícula i cada títol a les seves tres línies.

-  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
+  grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES, show: true },

#Deixa que els signes s'estrenyin, com en una pàgina impresa

Amb el valor per defecte en japonès, els fulls semblen un llibre mecanografiat en paper quadriculat: un 、 que obriria línia es recull estrenyent-ne un altre, i la resta d'aquella línia queda mitja casella fora de la retícula.

-  hangingPunctuation: 'force',
+  hangingPunctuation: 'allow',

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

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

Text
  • 夏目漱石『坊っちゃん』 (Botchan, 1906), the first three paragraphs, without the readings; Aozora Bunko card 752, from 「ちくま日本文学全集 夏目漱石」 (Chikuma Shobō, 1992), input 真先芳秋, proofreading 柳沢成雄, converted with aozora.py · Natsume Sōseki; Aozora Bunko volunteers · domini públic
Fonts
Klee One (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
SandboxPDF