Em poucas palavras
O papel de manuscrito japonês tem um quadrado para cada caractere. Esta página copia nele as primeiras linhas de um romance famoso, com o título, o nome do autor e cada sinal de pontuação onde as regras escolares japonesas mandam.
O que você vai compor
Três folhas de papel de manuscrito japonês (原稿用紙, genkō yōshi), do modelo de 400 quadrados, com os três primeiros parágrafos de Botchan, de Natsume Sōseki, copiados como faria um escritor ou um aluno: 20 linhas de 20 quadrados, lidas de cima para baixo a partir da direita, em Klee One, uma fonte desenhada com caneta. O título fica na primeira linha a partir do terceiro quadrado e o nome do autor na segunda, um quadrado antes do pé; cada parágrafo começa depois de um quadrado vazio. Cada caractere, kana pequeno e sinal tem um quadrado próprio, e um 、 ou 。 que abriria uma linha é escrito embaixo do último quadrado da linha anterior. Uma moldura marrom-avermelhada, o número da folha e o rótulo impresso do papel, 20×20, completam a folha. A página chinesa contada em caracteres é a Nº 082.
Esta receita responde a
- Como defino a mancha em caracteres, tantos por linha e tantas linhas por página?
- Por que kana pequenos, ー e sinais de fechamento não podem começar uma linha em japonês, e como escolho o rigor da regra?
A resposta curta
// 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
- Funcionalidades
- Grade de caracteresQuebra de linha em japonês (kinsoku)Espaçamento da pontuação japonesa (yakumono)Texto verticalLivros encadernados pela direitaTítulos sobre linhas do texto (gyōdori)Kana, kanji e rōmajiFontes chinesas, japonesas e coreanasImportação do Aozora BunkoEstilos de parágrafoTextos, fios e caixas nos designs de páginaCabeços e fóliosCor do papelPaleta de cores semânticaExportação para PDF
- Também usa
- Quebra de linha em chinêsLargura da pontuação chinesaAtributos de títuloCabeços por tipo de páginaFontes incorporadas ao PDF
- Tipografia
- Klee One, Noto Sans JP (SIL OFL 1.1)
- Materiais
- Nenhum: todas as imagens são desenhadas em código
Preparo
#1 · Desenhe os quadrados e dê a cada sinal um quadrado inteiro
O código está na resposta curta, mais acima. A grade de caracteres faz a mancha medir 20 caracteres de 20 pt (7,1 mm) para baixo e 20 linhas de 27 pt (9,5 mm) na largura, e show: true desenha os quadrados num cinza-claro próprio, na tela, e no PDF quando renderToPdf recebe characterGrid: true (num livro a grade é um recurso de revisão, de modo que o PDF a deixa de fora por padrão); a faixa de 2,5 mm entre duas linhas é onde quem escreve acrescenta leituras e correções. Um sinal japonês é meio glifo e meio eme de branco, e um livro recolhe brancos onde dois sinais se encontram ou onde um colchete abre a linha. No papel de manuscrito cada sinal mantém o quadrado, por isso compressAdjacent: false põe 。」 em dois quadrados e trimLineStart: false deixa a um colchete no início da linha o quadrado inteiro (Tipografia do Leste Asiático).
#2 · Siga as regras de linha do manuscrito
O papel de manuscrito tem o próprio kinsoku. Um kana pequeno ou um ー pode começar uma linha, cada um no quadrado; ja-loose permite isso. Um 、 ou 。 que abriria uma linha é escrito no último quadrado da linha anterior, junto com o caractere que está ali, ou logo abaixo dele; hangingPunctuation: 'force' o pendura embaixo do vigésimo quadrado, e nenhuma linha é apertada. Com 'allow', o padrão para japonês, o motor primeiro recolhe o sinal na linha apertando a meio quadrado um 、 de dentro dela, o que um livro impresso faz e um manuscrito nunca faz: o resto dessa linha ficaria meio quadrado acima, atravessando as linhas da grade.
A última linha de um parágrafo pede mais um ajuste. O Postext evita que um parágrafo termine em um só caractere: a linha anterior lhe cede o último, e como aqui o texto não é justificado, essa linha ficaria com um quadrado vazio. No papel de manuscrito se escreve em todos os quadrados de uma linha completa, por isso a grade leva fullLines: true: na folha 3 a linha que termina em 来 mantém os vinte quadrados e o parágrafo fecha com た。 sozinho (grade de caracteres).
#3 · Escreva o título e o nome onde as regras mandam
// 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) },
];
O título é um título com o tamanho e a fonte do texto, de modo que ele preenche quadrados como qualquer outra linha: lineSpan: 1 o mantém numa linha da grade e indent: em(2) deixa dois quadrados vazios acima dele (Ajustes por nível). O nome é um parágrafo com textAlign: 'end' e endIndent: em(1), que o faz terminar um quadrado antes do pé, e o Markdown escreve o quadrado em branco entre sobrenome e nome como um espaço ideográfico: 夏目 漱石. O texto começa na terceira linha, e cada parágrafo depois de um quadrado vazio, o de firstLineIndent: em(1).
#4 · Imprima a folha em volta dos quadrados
// 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) } } }] };
Os elementos do cabeçalho são desenhados na própria folha: numa página vertical, x corre para a direita e y para baixo a partir do canto superior esquerdo, ao contrário do design de um título, que é diagramado no quadro girado do texto. A moldura dupla fica a 1,5 mm dos quadrados em três lados e a 8 mm abaixo deles, onde caem os sinais pendurados. GRID e MARGIN a posicionam a partir dos mesmos números de que são feitas as margens da página; as margens passadas à página são meio milímetro menores, porque a grade as trata como mínimos e um encaixe exato poderia arredondar para 19 linhas.
#5 · Componha numa fonte de caneta
// 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}`);
A Klee One é desenhada com caneta e mantém as formas japonesas dos kanji, por isso as folhas parecem escritas à mão sem a irregularidade de uma digitalização. As formas verticais dela põem 、。 no canto superior direito do quadrado e giram ー e os colchetes, que é onde quem escreve os põe. Como toda família japonesa do Fontsource, ela vem em cerca de 120 arquivos, e loadCjkFonts baixa os que o texto precisa (Fontes chinesas, japonesas e coreanas).
A receita 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 = 'en'; // @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
O script.js montado funciona como está: cole-o como script de módulo em qualquer página ou abra a receita no CodePen. Pasta da receita no GitHub ↗ (abre em uma nova aba)
Variações
#Confira a grade de um livro com os mesmos quadrados
show: true funciona em qualquer grade de caracteres: no bunko da Nº 117 ele desenha os 38 × 15 quadrados sobre o texto, um jeito rápido de verificar que cada linha respeita a grade e cada título as três linhas.
- grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES },
+ grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES, show: true },#Deixe os sinais se apertarem, como numa página impressa
Com o padrão japonês, as folhas parecem um livro datilografado em papel quadriculado: um 、 que abriria uma linha é recolhido apertando outro, e o resto dessa linha fica meio quadrado fora da grade.
- hangingPunctuation: 'force',
+ hangingPunctuation: 'allow',Erros comuns
Erro comum
Marque um texto japonês como 'ja', nunca com zh-Hans nem LANG
As edições de uma receita são en e es, mas uma amostra japonesa é japonesa nas duas: `locale: LANG` a marcaria como inglês ou espanhol, e uma marcação chinesa a comporia pelas regras chinesas (pontuação Kaiming, kana pequeno livre para começar linha, 图 no lugar de 図, formas chinesas dos glifos no PDF). Desde o postext 1.30 a marcação é também o idioma em que o texto é composto (em que é medido, pintado e incorporado), então qualquer marcação que não seja 'ja' dá outras formas de glifo que não as japonesas (as chinesas, sob uma marcação chinesa) e outras quebras de linha. Escreva 'ja': isso escolhe a região do Japão (quebra de linha e pontuação da JLReq, pontos de ênfase em gergelim, espaçamento dos furigana, rótulos 図 e 表) e desativa a hifenização. O lint reprova um texto com kana sob uma marcação zh ou ko. Quebra de linha em japonês (kinsoku) →
Erro comum
Fontes chinesas são carregadas em fatias, pelo bloco cjk
O Fontsource serve uma família chinesa, japonesa ou coreana em cerca de cem arquivos por peso, cada um com um intervalo de caracteres. loadFonts baixa só o arquivo latin, então na tela os caracteres chineses vêm de uma fonte do sistema e são medidos errado, e o fontsourceProvider entrega ao PDF esse arquivo latin, que os imprime como caixas vazias. Inclua o bloco cjk do kit, chame loadCjkFonts(FONTS, markdown) depois de loadFonts (uma vez por voz, com o texto que ela compõe, quando o livro usa várias fontes CJK) e passe a renderToPdf fontProvider: cjkPdfProvider: os dois pegam os arquivos que contêm os caracteres do texto. Fontes chinesas, japonesas e coreanas →
Erro comum
Uma página vertical tem dois sistemas de referência: o do texto girado e o da folha
Um documento vertical-rl compõe o texto como uma página horizontal girada um quarto de volta no sentido horário, e o design de um título (os elementos de advancedDesign.slot) é posicionado nesse sistema girado: x desce pela página, y a atravessa para a esquerda a partir da borda direita, e a largura de um elemento é medida para baixo. Os elementos do cabeçalho e do rodapé continuam na folha: x avança para a direita a partir da borda esquerda e y desce a partir do alto. Uma moldura desenhada no cabeçalho e um título posicionado no design do título tomam, portanto, os seus deslocamentos em eixos diferentes. Em uma folha de rosto vertical, ancore os elementos a `page` e meça a partir das bordas dela: ancorados a `container`, os elementos do rodapé ficam alguns milímetros (cerca de 5 mm) fora do centro da mancha. Texto vertical →
Créditos
- Receita
- Ignacio Ferro
- Texto
- 夏目漱石『坊っちゃん』 (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 · domínio público
- Fontes
- Klee One (SIL OFL 1.1) · Noto Sans JP (SIL OFL 1.1)
- Código
- MIT, como o Postext
Editar este texto ↗ (abre em uma nova aba)Pasta da receita no GitHub ↗ (abre em uma nova aba)


