# Un manuel technique japonais : kana, kanji et latin > Chapitre A5 d’un livre japonais de programmation : coupures et ponctuation JLReq, quart de cadratin entre japonais et latin, code, 図3-1, notes par page. - Version HTML: https://postext.dev/fr/cookbook/japanese-technical-manual - Recette Nº 123 · Caractères et texte · Niveau 2 (Intermédiaire) · Sorties: Canvas, PDF - Genres: Manuels, guides et ouvrages de référence, Manuels scolaires - Nécessite postext ≥ 1.28.0, postext-pdf ≥ 1.28.0 · testée avec 1.31.0, postext-pdf 1.31.0 le 2026-10-13 - Pages: [41](https://postext.dev/cookbook/japanese-technical-manual/en/p01.webp?v=19211ab0), [42](https://postext.dev/cookbook/japanese-technical-manual/en/p02.webp?v=19211ab0), [43](https://postext.dev/cookbook/japanese-technical-manual/en/p03.webp?v=19211ab0), [44](https://postext.dev/cookbook/japanese-technical-manual/en/p04.webp?v=19211ab0), [45](https://postext.dev/cookbook/japanese-technical-manual/en/p05.webp?v=19211ab0) - PDF: https://postext.dev/cookbook/japanese-technical-manual/en/japanese-technical-manual.pdf?v=19211ab0 - Ouvrir dans le Sandbox: https://postext.dev/fr/sandbox#recipe=japanese-technical-manual&lang=en (.postext: https://postext.dev/cookbook/japanese-technical-manual/en/japanese-technical-manual.postext) - Dernière mise à jour: 2026-10-11 - Autres langues: [en](https://postext.dev/en/cookbook/japanese-technical-manual.md), [es](https://postext.dev/es/cookbook/japanese-technical-manual.md), [ca](https://postext.dev/ca/cookbook/japanese-technical-manual.md), [pt](https://postext.dev/pt/cookbook/japanese-technical-manual.md), [zh](https://postext.dev/zh/cookbook/japanese-technical-manual.md), [ja](https://postext.dev/ja/cookbook/japanese-technical-manual.md), [ar](https://postext.dev/ar/cookbook/japanese-technical-manual.md) ## En bref Un chapitre d’un livre japonais de programmation, aux phrases pleines de mots anglais, de code et de nombres. Postext règle la ponctuation et les fins de ligne à la japonaise et ajoute une espace fine entre japonais et latin. ## Ce que vous allez composer Cinq pages du chapitre 3 d’un livre japonais de programmation imaginaire, 実践 日本語テキスト処理 (*Traitement pratique du texte japonais*), consacré à la normalisation Unicode. Il est composé comme les livres d’informatique japonais : format A5, une colonne de 36 caractères sur 29 lignes de Noto Serif JP en 9 pt, titres en Noto Sans JP, code en BIZ UDGothic. Ce texte est le cas difficile de la composition japonaise, car une phrase sur deux contient un mot latin, un point de code, un nombre ou un nom de fonction : les fins de ligne suivent le 禁則処理 (kinsoku shori) le plus strict de JLReq, la ponctuation garde son espacement pleine chasse, et un quart de cadratin sépare le japonais du latin sans que personne tape d’espace. Une figure, un tableau, un listing et des notes de bas de page portent des étiquettes japonaises : 図3-1, 表3-1, des numéros de note en exposant comptés par page. [Listings de code et touches de clavier](https://postext.dev/fr/cookbook/code-listings-and-keycaps.md) est le même genre de page, en anglais. **Cette recette répond à:** - Comment composer un livre technique japonais avec des mots latins, du code et la ponctuation japonaise ? - Pourquoi les petits kana, ー et les crochets fermants ne peuvent-ils pas commencer une ligne en japonais, et comment choisir la sévérité de la règle ? - Pourquoi mon texte japonais sort-il avec les règles chinoises : étiquettes 图, petits kana en début de ligne, kanji sous leurs formes chinoises ? ## La réponse courte ```js // script.js, lignes 34–56 // locale 'ja' turns on JLReq composition: kinsoku at its strictest, full-width marks squeezed // where two meet (」、 takes one em, not two), a closing mark keeps its half em at a line // end, 、。 may hang past it, and a paragraph opening with 「 sets the bracket in the indent. // The values below are the ones 'auto' picks for 'ja'; they are spelled out to be seen. const cjk = { lineBreak: 'ja-very-strict', // no line starts with ー, small kana, 々, 」、。？・ or ： punctuationWidth: 'fullwidth', // 、。「」 keep their em inside the line (JLReq §3.1.2) hangingPunctuation: 'allow', // 、。 hang only when the line would otherwise break before them paragraphStartBracket: 'half', // 「 at a paragraph start sits in the indent's second half latinSpacing: em(0.25), // 四分アキ between kana or kanji and Latin letters or digits grid: { enabled: true, charsPerLine: CHARS, linesPerPage: LINES }, // whole ems, whole lines }; // The Latin is the Japanese face's own proportional Latin, at the text's size: never // full-width Ａ or a second face for the words in parentheses. const bodyText = { fontFamily: MINCHO, fontSize: pt(BODY), lineHeight: pt(PITCH), color: col('ink'), boldColor: col('ink'), italicColor: col('ink'), referenceColor: col('ink'), textAlign: 'justify', firstLineIndent: em(1), indentAfterHeading: true, // 1 字下げ referenceBold: false, // 図3-1 and 表3-1 in the text weight: the face loads no bold hyphenation: { enabled: false }, avoidRunts: true, // no one-character last line // The grid cuts a list where the page ends: the four forms stay in one piece. shortListSplit: 'avoid', shortListMaxItems: 4, }; ``` ## Ingrédients **Enseigne** - [Espacement de la ponctuation japonaise (yakumono)](https://postext.dev/fr/docs/japanese-layout.md#yakumono-espacement-de-la-ponctuation): La ponctuation japonaise est composée en pleine chasse et resserrée selon les règles de la JLReq : deux signes qui se rencontrent partagent le blanc d’un demi-cadratin de 、。「」, le dernier signe d’une ligne cède son blanc en premier, ・：； prennent un quart de cadratin de chaque côté, ？！ sont suivis d’un cadratin d’espace à l’intérieur d’un paragraphe, et un crochet ouvrant en début de paragraphe est rentré d’un demi-cadratin. cjk.spaceAfterQuestion et cjk.paragraphStartBracket modifient les deux derniers ; le burasagari (、。 suspendus au-delà de la fin de ligne) vient de cjk.hangingPunctuation. - [Coupure des lignes en japonais (kinsoku)](https://postext.dev/fr/docs/japanese-layout.md#coupure-des-lignes-kinsoku): Le japonais coupe une ligne entre deux caractères quelconques, sauf là où la JLReq l’interdit : pas de crochet fermant, de 、。, de petit kana (ぁ ッ ャ), de ー, de marque d’itération (々 ゝ) ni de 〜 en début de ligne, pas de crochet ouvrant en fin de ligne, et ―― ou …… jamais coupés. Un document balisé ja prend le niveau le plus strict ; cjk.lineBreak choisit 'ja-strict' ou 'ja-loose' pour les livres qui laissent les petits kana et ー commencer une ligne. - [Espace entre chinois et latin](https://postext.dev/fr/docs/configuration-east-asian.md#espace-entre-han-et-latin): Une espace d’un quart de cadratin (cjk.latinSpacing) entre un caractère han et un mot latin ou un nombre, qui remplace une espace saisie à cet endroit et n’est jamais copiée avec le texte. **Utilise aussi** - [Notes dans les livres japonais](https://postext.dev/fr/docs/japanese-layout.md#notes) - [Notes de bas de page](https://postext.dev/fr/docs/document-format.md#notes-de-bas-de-page) - [Légendes numérotées](https://postext.dev/fr/docs/document-format.md#numérotation-au-premier-renvoi) - [Figure et Tableau dans votre langue](https://postext.dev/fr/docs/configuration-resources.md#types-de-ressources) - [Titres numérotés](https://postext.dev/fr/docs/configuration-text.md#réglages-par-niveau) - [Titres sur plusieurs lignes du texte (gyōdori)](https://postext.dev/fr/docs/japanese-layout.md#titres-et-blocs) - [Grille de caractères](https://postext.dev/fr/docs/configuration-east-asian.md#grille-de-caractères) - [Polices chinoises, japonaises et coréennes](https://postext.dev/fr/docs/configuration-programmatic-usage.md#polices-chinoises-japonaises-et-coréennes) - [Listings de code](https://postext.dev/fr/docs/configuration-styles.md#listings-de-code) - [Encadrés](https://postext.dev/fr/docs/configuration-styles.md#styles-dencadré) - [Style de tableau](https://postext.dev/fr/docs/configuration-resources.md#style-de-tableau) - [Style des légendes](https://postext.dev/fr/docs/configuration-resources.md#style-de-légende) - [Figures et tableaux comme ressources](https://postext.dev/fr/docs/document-format.md#ressources) - [Titres courants et folios](https://postext.dev/fr/docs/configuration-page-layout.md#en-têtes-et-pieds-de-page) - [Ouvertures composées](https://postext.dev/fr/docs/configuration-text.md#étendue-et-maquette-avancée) - [Palette de couleurs sémantique](https://postext.dev/fr/docs/configuration-fonts-colors-viewers.md#palette-de-couleurs) - [Export PDF](https://postext.dev/fr/docs/configuration-programmatic-usage.md#générer-des-pdf) - [Citations dans un style bibliographique](https://postext.dev/fr/docs/document-format.md#citations-et-bibliographie) - [Coupure des lignes en chinois](https://postext.dev/fr/docs/configuration-east-asian.md#typographie-dasie-de-lest) - [Largeur de la ponctuation chinoise](https://postext.dev/fr/docs/configuration-east-asian.md#chasse-de-la-ponctuation) - [Équilibrage des colonnes](https://postext.dev/fr/docs/configuration-text.md#équilibrage-des-colonnes) - [Renvois](https://postext.dev/fr/docs/document-format.md#renvois-et-ancres) - [Des figures exactement ici](https://postext.dev/fr/docs/document-format.md#insertion-en-bloc-facultative-placement-explicite-dans-le-texte) - [Titres courants selon le rôle de la page](https://postext.dev/fr/docs/configuration-page-layout.md#éléments-de-texte) - [Styles de paragraphe](https://postext.dev/fr/docs/configuration-styles.md#styles-de-paragraphe) - [Polices intégrées au PDF](https://postext.dev/fr/docs/configuration-programmatic-usage.md#pourquoi-un-fournisseur-de-polices) - [Types de ressource personnalisés](https://postext.dev/fr/docs/configuration-resources.md#types-de-ressources) - [Tableaux à partir de données](https://postext.dev/fr/docs/document-format.md#insertion-en-bloc-facultative-placement-explicite-dans-le-texte) **La configuration en un coup d’œil** - [`bodyText`](https://postext.dev/fr/docs/configuration-text.md#texte-courant), [`calloutStyles`](https://postext.dev/fr/docs/configuration-styles.md#styles-dencadré), [`captionStyle`](https://postext.dev/fr/docs/configuration-resources.md#style-de-légende), [`cjk`](https://postext.dev/fr/docs/configuration-east-asian.md#typographie-dasie-de-lest), `codeStyle`, [`colorPalette`](https://postext.dev/fr/docs/configuration-fonts-colors-viewers.md#palette-de-couleurs), [`footer`](https://postext.dev/fr/docs/configuration-page-layout.md#en-têtes-et-pieds-de-page), `footnotes`, [`header`](https://postext.dev/fr/docs/configuration-page-layout.md#en-têtes-et-pieds-de-page), [`headings`](https://postext.dev/fr/docs/configuration-text.md#titres), [`layout`](https://postext.dev/fr/docs/configuration-page-layout.md#mise-en-page), [`locale`](https://postext.dev/fr/docs/configuration-text.md#césure), [`page`](https://postext.dev/fr/docs/configuration-page-layout.md#page), [`paragraphStyles`](https://postext.dev/fr/docs/configuration-styles.md#styles-de-paragraphe), [`resourceTypes`](https://postext.dev/fr/docs/configuration-resources.md#types-de-ressources), [`tableStyle`](https://postext.dev/fr/docs/configuration-resources.md#style-de-tableau), [`unorderedLists`](https://postext.dev/fr/docs/configuration-text.md#listes-à-puces) **API** - [`buildDocument`](https://postext.dev/fr/docs/configuration-programmatic-usage.md#construire-un-document), [`decompressWoff2`](https://postext.dev/fr/docs/configuration-programmatic-usage.md#fournisseur-de-polices-dans-le-navigateur-fontsource--woff2), [`defaultResourceTypes`](https://postext.dev/fr/docs/configuration-resources.md#types-de-ressources), [`inlineSvgFonts`](https://postext.dev/fr/docs/configuration-resources.md#polices-du-texte-svg), [`parseTSV`](https://postext.dev/fr/docs/document-format.md#insertion-en-bloc-facultative-placement-explicite-dans-le-texte), [`registerResourceImage`](https://postext.dev/fr/docs/architecture.md#surface-de-lapi), [`renderPageToCanvas`](https://postext.dev/fr/docs/configuration-programmatic-usage.md#rendre-une-page-en-bitmap), [`renderToPdf`](https://postext.dev/fr/docs/configuration-programmatic-usage.md#générer-des-pdf), [`withLoadedFonts`](https://postext.dev/fr/docs/configuration-programmatic-usage.md#charger-les-polices-avant-la-mise-en-page) **Caractères** - Noto Serif JP (OFL-1.1), Noto Sans JP (OFL-1.1), BIZ UDGothic (OFL-1.1) ## Préparation ### 1 · Les règles japonaises viennent avec la balise de langue Le code est dans [la réponse courte](https://postext.dev/fr/cookbook/japanese-technical-manual.md#la-réponse-courte) plus haut. `locale: 'ja'` active les règles de JLReq, les *Requirements for Japanese Text Layout* du W3C, et les valeurs écrites sous `cjk` sont celles que `'auto'` choisit pour le japonais ([Typographie d’Asie orientale](https://postext.dev/fr/docs/configuration-east-asian.md#typographie-dasie-de-lest)). Au niveau `ja-very-strict`, aucune ligne ne commence par ー, un petit kana, 々 ou un signe fermant, et aucune ne finit sur un crochet ouvrant. La ponctuation (約物, yakumono) garde son cadratin entier dans la ligne, et deux signes qui se rencontrent, comme 」、, se partagent un cadratin. Sur la [page 41](https://postext.dev/cookbook/japanese-technical-manual/en/p01.webp?v=19211ab0), la ligne qui finit sur 実際に変換し、 place son 、 au-delà du bord droit de la justification : c’est le ぶら下げ (burasage), et le moteur n’y recourt que si la ligne devait sinon renvoyer le signe à la ligne suivante. `latinSpacing` met un quart de cadratin (四分アキ, shibun aki) entre Unicode et では, et entre U+304C et を, bien que le Markdown n’ait là aucune espace. Il ne s’applique qu’à côté d’une lettre ou d’un chiffre : `normalize()` et `is_normalized()` se terminent par une parenthèse, si bien que le Markdown tape une espace entre elles et 関数. ![Opening page 41: 第3章 文字列の正規化.](https://postext.dev/cookbook/japanese-technical-manual/en/p01.webp?v=19211ab0) *Page 41 : un quart de cadratin autour de Unicode et de Python, tapés sans espace ; le 、 en fin de deuxième ligne déborde de la justification.* La différence avec le chinois tient aux signes. Un livre de Chine continentale compose par défaut 、 et ， en demi-chasse et 。 en pleine chasse (Kaiming) ; un livre japonais garde tous les signes en pleine chasse et ne les resserre que là où deux se rencontrent. La coupure des lignes en chinois n’a ni petits kana ni ー à tenir loin d’un début de ligne : `ja-very-strict` est donc un niveau à part. ### 2 · Le code dans un caractère à chasse fixe qui a des kana ````js // script.js, lignes 60–71 // A ``` fence is set line by line as written, in codeStyle's face: the monospaced face, // which has kana and kanji too, so a full-width character takes two half-width cells. // The rest of the fence line (normalize.py) is the listing's title. Inline `code` is set // in the same face, in the accent. const codeStyle = { fontFamily: CODE, fontSize: pt(8), lineHeight: pt(12), color: col('ink'), background: col('tint'), snapToGrid: false, highlight: 'none', // one ink, as in print padding: { top: mm(2.5), right: mm(4), bottom: mm(3), left: mm(4) }, marginTop: mm(2), marginBottom: mm(2), titleStyle: { fontFamily: CODE, fontSize: pt(7), fontWeight: 400, color: col('teal') }, inline: { fontSize: pt(8.5), color: col('teal') }, }; ```` Le bloc délimité est un [bloc de code](https://postext.dev/fr/docs/document-format.md#blocs-de-code) : Postext compose ses lignes telles qu’elles sont tapées, dans le caractère que nomme `codeStyle`, dans une boîte teintée sous le titre `normalize.py` repris de la ligne d’ouverture ([listings de code](https://postext.dev/fr/docs/configuration-styles.md#listings-de-code)). `highlight: 'none'` garde le listing d’une seule encre, comme le reste de la page, et `codeStyle.inline` compose chaque `` `name` `` dans le même caractère, en sarcelle. Le choix du caractère compte : la chaîne de l’exemple, ｶﾞｲﾄﾞ ＡＢＣ ①, demande des katakana demi-chasse, des lettres pleine chasse et des chiffres cerclés, qui manquent à un caractère de code occidental. BIZ UDGothic compose le latin demi-chasse et les kana pleine chasse à pas fixe, et un listing compte un caractère pleine chasse pour deux cellules : les colonnes restent alignées. ### 3 · 図3-1 et 表3-1 ```js // script.js, lignes 236–252 const FORMS = `入力\tNFC\tNFD\tNFKC が（U+304C）\tU+304C\tU+304B U+3099\tU+304C ｶﾞ（U+FF76 U+FF9E）\tそのまま\tそのまま\tガ（U+30AC） ＡＢＣ（全角）\tそのまま\tそのまま\tABC ①\tそのまま\tそのまま\t1 ㍻\tそのまま\tそのまま\t平成`; const resources = [ { id: 'tbl:forms', typeId: 'table', kind: 'table', createdAt: 0, updatedAt: 0, placement: { position: 'here' }, // at its ::resource line, under the paragraph citing it caption: '日本語の文字と四つの正規化形式（NFKDは、NFKCで合成された文字を分解した形になる）', table: { model: { ...parseTSV(FORMS), headerRowCount: 1, columnWidths: [34, 18, 26, 22] } } }, { id: 'fig:bytes', typeId: 'figure', kind: 'svg', createdAt: 0, updatedAt: 0, caption: '「が」の二つの表し方。上段が符号位置、下段がUTF-8のバイト列', altText: 'が as one code point U+304C, three UTF-8 bytes E3 81 8C; and as U+304B and the ' + 'combining voiced mark U+3099, six bytes E3 81 8B E3 82 99.', svg: { fileId: 'bytes.svg', width: 1175, height: 400 } }, ]; ``` `defaultResourceTypes('ja')` nomme les types 図 et 表 et les numérote par chapitre avec un trait d’union, et `continuation.headings` fait de ce chapitre le chapitre 3 : la première figure est donc 図3-1. Un document `ja` compose l’étiquette et le numéro sans espace et place une espace idéographique après le numéro, comme les livres japonais impriment 図3-1　「が」の二つの表し方 ; le style de légende ne choisit donc que le caractère et les couleurs. Le tableau est placé `'here'`, sous le paragraphe qui le cite. Les étiquettes de la figure sont uniquement latines, U+304C et E3 81 8C : le SVG nomme le caractère de code dans son style, et `loadSvg` intègre le fichier de police avant que l’image soit dessinée. ### 4 · Des notes par page, à la japonaise ```js // script.js, lignes 129–130 footnotes: { fontSize: pt(7.5), lineHeight: pt(12), color: col('ink'), separator: { color: col('rule') } }, // at the column foot, 1 on each page, superscript ``` Les notes n’ont besoin d’aucun réglage en dehors de leur corps : dans un document japonais horizontal, les valeurs par défaut sont celles que JLReq décrit pour les livres horizontaux, une note au pied de la colonne où elle est appelée, numérotée à partir de 1 à chaque page, un appel en exposant et un filet long d’un tiers de la justification ([Notes de bas de page](https://postext.dev/fr/docs/configuration-notes-references.md#notes-de-bas-de-page)). L’appel se place avant le point, `保存していた[^hfs]。`, si bien que le 。 ne commence jamais la ligne suivante séparé de lui. ### 5 · Un titre de section sur trois lignes ```js // script.js, lignes 75–90 const BAND = 74; // mm from the trim's top const opener = { enabled: true, minHeight: pt(PITCH * 10), slot: { elements: [ // text: line 11 { kind: 'box', id: 'band', reserve: false, style: { backgroundColor: col('tint') }, placement: { anchor: { to: 'page', edge: 'top-left' }, size: { width: 'fill', height: mm(BAND) } } }, { kind: 'text', id: 'kicker', content: 'CHAPTER', fontFamily: GOTHIC, fontSize: pt(8), fontWeight: 700, letterSpacing: pt(1.6), color: col('teal'), align: 'left', placement: { anchor: { to: 'container', edge: 'top-left' }, offset: { y: mm(0) } } }, { kind: 'text', id: 'number', content: '{numberDecimal}', fontFamily: GOTHIC, fontSize: pt(64), lineHeight: 1, fontWeight: 700, color: col('teal'), align: 'left', placement: { anchor: { to: '#kicker', edge: 'below' }, offset: { y: mm(1) } } }, { kind: 'text', id: 'title', content: '{titleText}', fontFamily: GOTHIC, fontSize: pt(20), fontWeight: 700, color: col('ink'), align: 'left', overflow: 'wrap', placement: { anchor: { to: '#number', edge: 'below' }, offset: { y: mm(5) }, size: { width: mm(MEASURE) } } }, ] } }; ``` L’ouverture de chapitre est une maquette posée sur le H1 : une bande sarcelle, le numéro du chapitre en 64 pt tiré de `{numberDecimal}` et le titre. Les titres de section utilisent `lineSpan: 3`, le 行取り (gyōdori) : chacun occupe exactement trois lignes du texte courant, son texte centré dedans, et le texte qui suit continue au pas de la grille. `headings.balancing.enabled: false` empêche le moteur d’ajouter des lignes au-dessus des titres pour équilibrer une page. ## La recette complète Un seul fichier, composé à partir du dossier de la recette avec le texte d’exemple et le kit commun des Recettes déjà inclus ; il construit sa propre page. Pour l’exécuter, placez-le dans un `