Konfiguration: ostasiatische Typografie

#Ostasiatische Typografie

Die Eigenschaft cjk legt fest, wie chinesischer, japanischer und koreanischer Text gesetzt wird: welchen regionalen Konventionen er folgt, wo seine Zeilen umbrechen dürfen, wie breit seine Satzzeichen gesetzt werden und ob sie überhängen, den Abstand zwischen Han- und lateinischen Zeichen, das Zeichenraster des Satzspiegels und wie Betonungszeichen, Seitenlinien, Ruby-Lesungen, Warichu-Anmerkungen und Kanbun-Zeichen des Texts gedruckt werden. Jedes Feld ist optional, und 'auto' folgt der Region der Dokumentsprache (locale): Ein Buch mit locale: 'zh-Hant' bricht seine Zeilen um und setzt seine Satzzeichen nach taiwanischer Art, eines mit locale: 'ja' nach japanischer, ohne dass sonst etwas einzustellen wäre. Chinesischer Satz und Japanischer Satz erklären die Regeln hinter diesen Einstellungen, mit jeweils zwei vollständigen Konfigurationen. Die japanischen Felder und Werte gibt es seit postext 1.16.

interface CjkConfig {
  region?: 'auto' | 'mainland' | 'taiwan' | 'hongkong' | 'japan'; // Regional conventions.
  lineBreak?: 'auto' | 'none' | 'basic' | 'gb' | 'strict'
    | 'ja-very-strict' | 'ja-strict' | 'ja-loose';      // Which marks may not open or close a line.
  punctuationWidth?: 'auto' | 'fullwidth' | 'kaiming' | 'lineEndHalf' | 'halfwidth';
  compressAdjacent?: 'auto' | boolean;      // Two marks that meet take 1.5 em.
  trimLineStart?: 'auto' | boolean;         // Brackets at a line edge lose their outer half.
  hangingPunctuation?: 'auto' | 'none' | 'allow' | 'force';
  spaceAfterQuestion?: 'auto' | boolean;    // One em after ？！ inside a paragraph (Japan).
  paragraphStartBracket?: 'auto' | 'indent' | 'half' | 'flush'; // A bracket opening an indented paragraph.
  wordBreak?: 'normal' | 'keep-all';        // keep-all: break only at spaces (分かち書き, Korean).
  titleMinChars?: number;                   // Characters of a book title on either side of a break; default 2.
  circledNumbers?: 'cjk' | 'western';       // ① ② as Chinese characters (default) or Latin letters.
  composeDesignText?: boolean;              // CJK rules in design text; default true.
  latinSpacing?: Dimension;                 // Between Han and Latin; default 0.25 em.
  latinSpacingEdge?: 'auto' | 'letters' | 'western'; // Which side of a Western word takes it.
  uprightDigits?: 0 | 2 | 3 | 4;            // Vertical text: numbers in one upright cell; default 2.
  grid?: { enabled?: boolean; charsPerLine?: number; linesPerPage?: number; show?: boolean; fullLines?: boolean };
  emphasis?: 'auto' | 'italic' | 'dots';    // What *…* does to CJK characters.
  emphasisMark?: {                          // The mark *…* and :dots[…] draw when they do not say.
    style?: 'auto' | 'dot' | 'circle' | 'sesame';
    fill?: 'auto' | 'filled' | 'open';
    position?: 'auto' | 'over' | 'under';
  };
  bookTitleMark?: 'auto' | 'brackets' | 'wavy' | 'none'; // What :book[…] prints.
  bookTitleBrackets?: 'auto' | { open: string; close: string }[]; // The brackets, outermost first.
  annotationColor?: ColorValue;             // Dots and name/title lines; default the text colour.
  ruby?: {
    fontFamily?: string; fontSize?: Dimension; color?: ColorValue;
    position?: 'auto' | 'over' | 'under' | 'right';
    overhang?: 'auto' | 'none' | 'kana' | 'any'; // How far a reading may run onto its neighbours.
    align?: 'auto' | 'center' | 'jis' | 'start'; // How a reading shorter than its base is spaced.
    smallKana?: 'keep' | 'full';                 // Small kana in readings as written, or full size.
  };
  warichu?: { fontSize?: Dimension; color?: ColorValue; open?: string; close?: string; minChars?: number };
  kunten?: { fontSize?: Dimension; color?: ColorValue; placement?: 'inline' | 'interlinear' }; // Kanbun marks.
}

Die japanischen Stufen folgen den drei Konventionen von JLReq Anhang C.3. Auf jeder von ihnen endet keine Zeile mit einer öffnenden Klammer oder einem öffnenden Anführungszeichen, ein Währungszeichen bleibt bei seiner Zahl (außer bei ja-loose), für den Schrägstrich gilt keine Regel, und ——, ―― und …… dürfen eine Zeile eröffnen, werden aber nie geteilt (ebenso wenig 〳〵):

Auf jeder Stufe gilt:

• —— und …… sind eine Einheit von zwei Geviert Breite und werden nie geteilt; zwei solche Einheiten hintereinander dürfen zwischen sich getrennt werden.
• Eine Zahl behält ihre Zeichen und ihre Einheit (¥5,999, 50%, 50％, 120㎡), auch über ein Leerzeichen hinweg (−3 ℃, 50 %), und ein lateinisches Wort bleibt ganz: Westlicher Text zwischen CJK-Zeichen wird als Abschnitt gesetzt, in dem eine Zeile nie umbricht, es sei denn, der Abschnitt allein ist breiter als die Zeile (er wird dann an einer Silbe mit Trennstrich geteilt oder am letzten Zeichen, das passt; eine Webadresse an ihren Fugen). Die Einheitenquadrate ㎡ ㎏ ㎞ ㏄ (U+3371–337A, U+3380–33DF, U+33FF) gehören zum Abschnitt ihrer Zahl und machen einen lateinischen Absatz nicht zu einem CJK-Absatz.
• Eine Zahl oder ein Wort in Ziffern und Buchstaben voller Breite (１２３４５６, ５０％, ￥５９９, ３．１４, １２：３０, ＡＢＣ) wird ebenfalls nie geteilt; eine Zeile im Blocksatz treibt ihre Zeichen dennoch aus, wie sie Han austreibt.
• Ein Wortzwischenraum ist nur dort ein Umbruch, wo die Regeln einen erlauben: Die Zeile bricht dort nicht um, wenn das nächste Zeichen keine Zeile eröffnen darf (参见图表 （ 第三章 ） eröffnet nie eine Zeile mit ）) oder das letzte davor keine beenden darf.
• Ein Fußnotenzeichen, ein :ref und ein hoch- oder tiefgestelltes Zeichen bleiben bei dem Zeichen davor.
• Das ideografische Leerzeichen U+3000 ist ein Zeichen von einem Geviert Breite: Eine Zeile darf danach umbrechen, nie davor; es wird nie gedehnt und am Zeilenanfang nie entfernt. Für den Einzug von zwei Zeichen in chinesischen Absätzen setzen Sie bodyText.firstLineIndent: { value: 2, unit: 'em' }, statt zwei U+3000 zu tippen (der Parser entfernt die, mit denen ein Absatz beginnt).

Passt ein Zeichen nicht in die Zeile und darf es die nächste eröffnen, rückt es hinunter, und eine Zeile im Blocksatz treibt den Rest aus. Darf es die nächste Zeile nicht eröffnen (ein Komma, eine schließende Klammer, das Zeichen nach einer öffnenden), versucht die Zeile zuerst, es durch Stauchen aufzunehmen (Push-in, clreq §6.2.2.3): Deckt der Leerraum, den es aufgeben darf – siehe Breite der Satzzeichen –, den Überlauf, kommt das Zeichen (mit den Zeichen, die bei ihm bleiben müssen, etwa einem schließenden Anführungszeichen nach einem Punkt) in die Zeile, und die Zeile wird auf die Satzbreite gesetzt. Andernfalls gibt die Zeile Zeichen an es ab (Push-out): Der Umbruch rückt zur letzten Stelle zurück, die die Regeln erlauben, und eine Zeile im Blocksatz treibt den Rest aus. In einer Zeile, die schmaler ist als eine Zahl mit ihrem Punkt, darf nichts die Zeile beenden, und sie bricht dann doch vor dem Punkt um.

Für welche Absätze das gilt: für die, die mehr CJK-Zeichen (Han, Kana, Bopomofo, Hangul) als Wortzwischenräume enthalten, auch wenn keine zwei davon aufeinanderfolgen (第1条、第2条, 价¥5,999。好). Ein Leerzeichen neben einem CJK-Zeichen oder Satzzeichen ist kein Wortzwischenraum: 2026 年 9 月 28 日 wird gesetzt wie 2026年9月28日. Sie werden Zeile für Zeile gesetzt, auf dem einfachen wie auf dem formatierten Weg, sodass ein Absatz mit einem fetten Wort genau so umbricht wie derselbe Text ohne es. Ein lateinischer Absatz, der einen chinesischen Titel oder Namen zitiert, hat mehr Leerzeichen als Zeichen: Er behält den optimalen Zeilenumbruch, und eine Zeile darf neben seinen CJK-Zeichen nach denselben Regeln umbrechen. Legenden, Tabellenzellen, Anmerkungen und Kästen brechen ebenfalls auf der Stufe des Dokuments um. Die Silbentrennung nach Wörterbuch erreicht die lateinischen Wörter eines CJK-Absatzes nicht.

Eine CJK-Zeile im Blocksatz, die nicht die letzte ihres Absatzes ist, wird in dieser Reihenfolge auf die Satzbreite ausgetrieben (clreq §6.2.2.4): die Zwischenräume zwischen westlichen Wörtern, bis zu je einem halben Geviert; die Abstände zwischen Han und Latein, bis zu je einem halben Geviert; dann jede Lücke zwischen den Zeichen und diese Abstände gleichmäßig. Kein Abstand kommt in ein lateinisches Wort, eine Zahl oder ein Zeichen von zwei Geviert, auch nicht neben ein Verbindungszeichen oder einen Schrägstrich. Die Sperrung wird je Segment der Zeile gesetzt (VDTLineSegment.tracking, px nach jedem Zeichen, Teil der width des Segments), die Canvas-, HTML- und PDF-Ausgabe als Laufweite malen; ein lateinisches Wort, auf das eine Lücke folgt, gibt seinem letzten Buchstaben ein eigenes Segment. Ein Segment enthält einen westlichen Abschnitt oder Zeichen gleichen Stils, gleichen Links und gleicher Sperrung, die gleich vorrücken; die Sandbox verteilt seine Breite daher gleichmäßig auf sie, wenn sie den Cursor platziert, und ein Link deckt nur seine eigenen Zeichen ab. Bräuchte eine Zeile mehr als ein halbes Geviert zwischen ihren Zeichen (oder mehr als bodyText.maxJustifyTracking, wenn das gesetzt ist), wird sie mit diesem Höchstwert gesetzt und endet vor der Satzbreite: Die Zeile wird als cjkLoose und ragged markiert, und der Build meldet eine Inhaltswarnung cjkLooseLine mit dem Text der Zeile. Die übliche Ursache ist ein langes lateinisches Wort oder eine Webadresse, die nicht heraufrücken kann. Eine Zeile ohne CJK-Zeichen (der Anfang einer langen Webadresse) wird ohne Warnung im Flattersatz gesetzt, wie eine lateinische Zeile aus einem Wort. Siehe Silbentrennung und Blocksatz.

#Breite der Satzzeichen

Ein chinesisches Satzzeichen voller Breite besteht aus einem halben Geviert Glyphe und einem halben Geviert Leerraum, und was die Einstellungen anpassen, ist der Leerraum, nie die Glyphe (clreq §6.3.2). Der Leerraum liegt vor der Glyphe einer öffnenden Klammer oder eines öffnenden Anführungszeichens, nach der Glyphe einer schließenden und nach der Glyphe der Pausen- und Schlusszeichen des Festlands 、，。．；：？！, die in der Ecke ihres Kästchens sitzen; die Zeichen, die Taiwan und Hongkong zentrieren (、，。．；：), und Mittelpunkte behalten auf jeder Seite ein Viertelgeviert. ？！ bleiben im horizontalen Text Taiwans und Hongkongs ein Geviert breit, ：；？！ im vertikalen Text überall. Der Mittelpunkt des Festlands ist in jedem Stil ein halbes Geviert breit, zentriert, in beiden Schreibrichtungen (GB/T 15834, clreq §5.1): Eine Glyphe voller Breite gibt ihren Leerraum auf beiden Seiten auf, und im vertikalen Text ist ihre Zelle von vornherein ein halbes Geviert groß.

In Japan (punctuationWidth: 'fullwidth', der Auto-Wert) folgen die Zeichen stattdessen JLReq §3.1: 、，。． behalten ihren Leerraum nach der Glyphe, ：； und ・ ein Viertelgeviert auf jeder Seite, und ？！ füllen ihr Geviert. Ein schließendes Zeichen am Zeilenende behält sein halbes Geviert und gibt es ganz und vor allem anderen auf, wenn die Zeile ein weiteres Zeichen aufnehmen muss; der Leerraum nach 。 wird innerhalb der Zeile nie verringert. Eine Zeile gibt Raum in der Reihenfolge von JLReq §3.8.3 zurück: Wortzwischenräume, der Leerraum des Zeichens am Zeilenende, Mittelpunkte, Klammern und 、，, dann der Abstand zwischen Japanisch und Latein; und sie wird ausgetrieben, ohne Raum nach einer öffnenden Klammer, vor einer schließenden oder neben 、。・：；？！ und U+3000 hinzuzufügen (§3.1.11). 、 und ・ zwischen zwei Kanji-Zahlzeichen werden kompress gesetzt und nie umbrochen (二、三日, 三・一四). Ein japanisches Dokument mit einem anderen punctuationWidth (kaiming, halfwidth …) folgt stattdessen den clreq-Regeln dieses Abschnitts.

Mit compressAdjacent geben zwei Zeichen, die aufeinandertreffen, den Leerraum zwischen sich auf (die acht Regeln der früheren clreq-Entwürfe): eine schließende Klammer nach einer anderen schließenden oder nach einem Pausen- oder Schlusszeichen des Festlands (。」, nicht nach den zentrierten Zeichen Taiwans und Hongkongs), ein Pausen- oder Schlusszeichen nach einer schließenden Klammer (」，), eine öffnende Klammer nach einem dieser Zeichen oder nach einer anderen öffnenden (，「, 》（, 「『) und ein Viertelgeviert zwischen einem Mittelpunkt und einer schließenden Klammer davor oder einer öffnenden danach. Nie mehr, als das Paar auf 1,5 em bringt: Unter Kaiming nimmt 。” bereits 1,5 em ein und behält sie, 》（ nimmt ein Geviert ein. Kaiming setzt den Leerraum eines Schlusszeichens hinter ein darauf folgendes schließendes Zeichen, mit oder ohne compressAdjacent: Die beiden Glyphen stehen zusammen, und das halbe Geviert kommt nach dem Anführungszeichen (。”␣母, nicht 。␣”母), und am Zeilenende verhält es sich wie das eines Schlusszeichens. Mit trimLineStart gibt eine öffnende Klammer am Zeilenanfang ihren vorderen Leerraum auf, sodass ihre Farbe mit der Textkante fluchtet (in der ersten Zeile eines Absatzes sitzt sie ein halbes Geviert im Einzug), und eine schließende am Zeilenende ihren hinteren. Ein zentriertes Zeichen gibt auf jeder Seite ein Viertelgeviert auf, nie ein halbes auf einer. Bricht eine Zeile zwischen zwei Zeichen um, behält keines die Stauchung: Jedes wird als Zeichen an einer Zeilenkante gesetzt (ein ， voller Breite, dessen 「 die nächste Zeile eröffnet, beendet seine eigene Zeile mit einem vollen Geviert).

Eine Zeile nimmt ein Zeichen auf, das die nächste Zeile nicht eröffnen darf (Push-in), wenn der Leerraum, den sie noch aufgeben kann, den Überlauf deckt, in der Reihenfolge von clreq: Wortzwischenräume bis zu einem Viertelgeviert, dann Mittelpunkte, Klammern, Pausenzeichen, die Abstände zwischen Han und Latein bis zu einem Achtelgeviert und zuletzt Schlusszeichen, jeder Schritt gleichmäßig verteilt. kaiming lässt nur seine Schlusszeichen auf ein halbes Geviert schrumpfen, und nur in diesem Fall: Eine Zeile, der lediglich ein weiteres Zeichen fehlt, wird ausgetrieben, sodass 。？！ innerhalb der Zeile ihr Geviert behalten. lineEndHalf lässt jedes Zeichen auf ein halbes Geviert schrumpfen; Zeichen unter fullwidth geben nichts auf (ein Buch mit voller Breite behält sein Raster), und Zeichen unter halfwidth haben nichts mehr übrig.

Die Zeichen, die lateinischer Text mit dem Chinesischen teilt (“ ” ‘ ’ … — ·), nehmen im chinesischen Text das Kästchen eines chinesischen Zeichens ein, unabhängig von der eigenen Dickte der Schrift: LXGW WenKai zeichnet “ ” 0,35 em breit, Noto Serif SC den Geviertstrich mit 0,89 em und · mit einem Drittelgeviert. Sie zählen als chinesisch, wenn das nächste Zeichen auf einer der beiden Seiten (über andere solche Zeichen hinweg) chinesisch ist oder wenn nichts neben ihnen westlich ist. Die Glyphe eines öffnenden Anführungszeichens sitzt am Ende ihres Kästchens von einem Geviert, die eines schließenden an seinem Anfang; ein Mittelpunkt, eine Auslassung und ein einzelner Strich sitzen in der Mitte; ein Paar Auslassungen (……) wird gesetzt, wie die Schrift die beiden zusammen setzt, und in seinen zwei Geviert zentriert. Ein 破折号 (——) ist eine durchgehende Linie: Jeder Strich wird von der eigenen Seitendickte der Schrift aus über sein Geviert gedehnt, die beiden Striche überlappen an der Fuge und werden auf die Mitte der Schriftzeichen angehoben (VDTLineSegment.inkScale, eine Skalierung nur beim Malen). Der Stil passt das Kästchen dann wie bei jedem anderen Zeichen an. Mit westlichem Text auf beiden Seiten (他说：He said “yes” and left.) behalten sie die Dickte der Schrift, und eine Glyphe, die schon ein Geviert breit ist, ändert nichts.

Die Renderer halten die eigene Satzzeichen-Abstandsregelung des Browsers aus dem Text heraus. Chrome setzt das erste von zwei aufeinandertreffenden Zeichen in halber Breite, wenn es sie in einem Lauf misst oder malt (本）》录 in Noto Serif SC ist so 3,5 em breit); daher werden zwei aufeinandertreffende Zeichen getrennt gemessen und gemalt, und HTML-Zeilen mit CJK-Text tragen text-spacing-trim: space-all und text-autospace: no-autospace mit abgeschalteten Features chws, halt und vchw.

Im VDT ist ein Zeichen, das Leerraum aufgegeben hat, ein eigenes Segment, seine width die Dickte, die es behält, mit gesetztem inkOffset (px): Die Renderer malen seine Glyphe bei x + inkOffset, sodass ein Zeichen, das den Leerraum vor seiner Glyphe aufgegeben hat (eine öffnende Klammer am Zeilenanfang), so weit vor seinem Kästchen gezeichnet wird (ein negativer Versatz). Ein geteiltes Zeichen, das in einem chinesischen Kästchen gesetzt ist, trägt die Position seiner Glyphe im Kästchen, abzüglich eines davor aufgegebenen Leerraums, die positiv sein kann. Das PDF zeigt eine solche Glyphe mit einem Zeichenabstand, der ihre Dickte dort enden lässt, wo ihr Kästchen endet, sodass ein Leseprogramm sie nie in das nächste Zeichen laufen sieht, und legt ihre Zeile in eine Spanne /ActualText (siehe Abstand zwischen Han und Latein). Die Region entscheidet, auf welcher Seite der Leerraum eines Zeichens liegt, nicht die Schrift: Setzen Sie ein Buch in einer Schrift seiner Region (Noto Serif SC für das Festland, TC für Taiwan, HK für Hongkong); eine traditionelle Schrift unter einem Tag des Festlands staucht ihre zentrierten Zeichen auf der falschen Seite.

#Hängende Satzzeichen

hangingPunctuation: 'allow', der Auto-Wert in Japan, lässt eines von 、，。． (auf dem Festland, dessen Zeichen am Anfang ihres Kästchens sitzen, auch ；：？！) über das Zeilenende hinaushängen, wenn es sonst die nächste Zeile eröffnen würde und Stauchen der Zeile es nicht aufnehmen kann; nie im horizontalen Text Taiwans und Hongkongs, dessen zentrierte Zeichen abgeschnitten wirken würden (im vertikalen Text dürfen sie es). Im vertikalen Text sitzt das hängende Zeichen unter dem Fuß der Zeile. 'force' hängt ein solches Zeichen immer aus, wenn es eine Zeile beendet (außer in der letzten Zeile eines Absatzes), und sofort, wenn es nicht passt. Ein Zeichen hängt nie, wenn ein anderes Zeichen es berührt (。」, ，「). Das hängende Segment ist als hangs markiert; bbox.width der Zeile, ihr Blocksatz und ihre Ausrichtung lassen es außen vor, und Canvas und PDF erweitern den Spaltenausschnitt um das breiteste hängende Zeichen (hangingPunctuationOverhang), sodass es nie abgeschnitten wird. Die meisten chinesischen Bücher hängen Satzzeichen nicht aus; clreq empfiehlt es nur mit einem Zeichenraster. Japanische Bücher hängen 、。，． aus (Burasagari), nie ；：？！ oder Klammern, in beiden Schreibrichtungen und nur, wenn Stauchen der Zeile das Zeichen nicht aufnehmen kann.

#Abstand zwischen Han und Latein

latinSpacing (standardmäßig ein Viertelgeviert) setzt einen Abstand zwischen einem Han-Zeichen (oder Kana) und einem benachbarten lateinischen Buchstaben oder einer europäischen Ziffer: 用iPhone拍照 und 1999年 werden als 用 iPhone 拍照 und 1999 年 gesetzt. Es gibt keinen am Anfang oder Ende einer Zeile, keinen zwischen einem lateinischen Zeichen und einem chinesischen Satzzeichen (用iPhone， setzt nichts vor das Komma), keinen innerhalb chinesischer Klammern (（iPhone）) und keinen neben einem Zeichen, das weder Buchstabe noch Ziffer ist (为¥5,999). Ein Leerzeichen, das der Autor an einer solchen Grenze getippt hat (用 iPhone 拍照, wie es viele Webtexte haben), wird durch den Han-Latein-Abstand ersetzt, nicht ergänzt, sodass beide Schreibweisen gleich gesetzt werden; ein geschütztes Leerzeichen oder ein ideografisches Leerzeichen bleibt, wie es ist. In einer Zeile im Blocksatz wächst er auf bis zu ein halbes Geviert, bevor die Zeichen ausgetrieben werden; in einer Zeile, die ein Zeichen aufnimmt, das die nächste Zeile nicht eröffnen darf, schrumpft er auf bis zu ein Achtelgeviert. Eine Länge in einer anderen Einheit als em wird mit der dpi-Zahl der Seite umgerechnet. 0 schaltet ihn ab, und ein dort getipptes Leerzeichen bleibt ein Wortzwischenraum.

Welche Seite eines westlichen Worts den Abstand erhält, folgt latinSpacingEdge. Unter 'letters', der Regel von clreq §6.3.3 und von CSS text-autospace und dem Standard der chinesischen Regionen, ist es eine Seite, die auf einen Buchstaben oder eine Ziffer endet. Unter 'western', dem Standard der Region Japan (JLReq §3.2.6), erhält ein westliches Wort, das einen Buchstaben oder eine Ziffer enthält, ihn auch auf einer Seite, die auf eine Klammer oder ein Zeichen endet: normalize()関数, (abc)関数, A+関数 und 100%関数 werden mit dem Viertelgeviert auf beiden Seiten des Worts gesetzt, wie abc関数, und ein dort getipptes Leerzeichen wird ebenfalls ersetzt. Zwei Seiten bleiben kompress, wo das Zeichen über die Kante hinweg bindet: nach einer öffnenden Klammer oder einem Präfixzeichen, mit dem das Wort endet (abc(関数), und vor einer schließenden Klammer, einem Komma, einem Schlusszeichen oder einem Postfixzeichen, mit dem es beginnt (関数)abc). Eine Klammer oder ein Zeichen ohne Buchstabe oder Ziffer in seinem Wort, wie in 関数(かんすう)は, steht in japanischem Kontext und erhält keinen. Eine vor postext 1.28 gespeicherte japanische Konfiguration behält 'letters'.

Der Abstand ist ein Segment mit kind: 'space', markiert als autospace, mit leerem text (oder dem Leerzeichen, das der Autor getippt hat); seine width ist endgültig, und der eigene Wortabstands-Blocksatz der Renderer lässt ihn, wie er ist. Er steht nie im reinen Text, sodass Suche, Kopieren und Einfügen und Quellbereiche den Text so lesen, wie er geschrieben ist. Das PDF legt jede Zeile, die in Stücken gesetzt ist (ausgetriebene Zeichen, Han-Latein-Abstände, Zeichen, die Leerraum aufgegeben haben oder hängen), in eine /Span, deren /ActualText der Text der Zeile ist, sodass die Textextraktion 用iPhone拍照 liest, nicht 用 iPhone 拍 照, und eine Zeile mit Zeichen halber Breite als eine Zeile liest.

#Zahlen im vertikalen Text

Im vertikalen Text wird ein lateinisches Wort oder eine lange Zahl seitlich gedreht, und eine kurze Zahl steht aufrecht, ihre Ziffern nebeneinander in einer Zelle von einem Geviert: Tate-chu-yoko (縱中橫, clreq §2.1.3, CSS text-combine-upright). uprightDigits legt fest, wie viele Ziffern eine solche Zahl haben darf: 2 (der Standard), 3, 4 oder 0 für keine. 2026年9月28日 ist unter 2 seitlich gedrehtes 2026, aufrechtes 9 und aufrechtes 28 in einer Zelle.

• Die ganze Zahl oder nichts davon: Unter 2 bleibt eine dreistellige Zahl seitlich gedreht, nie geteilt.
• Eine Zahl, die einen lateinischen Buchstaben berührt (A4, mp3, 3D), bleibt seitlich gedreht in ihrem Wort; ebenso eine Zahl mit Dezimalpunkt oder Zifferngruppierung (3.14, 10,000).
• Eine Zahl in einem lateinischen Satz folgt dem Satz: Liegt auf beiden Seiten ein lateinisches Wort, läuft sie mit den Wörtern seitlich gedreht (printed in 49 and 32 copies, chapters 49, 32 and (7) of). Auf jeder Seite reicht der Blick über Leerzeichen, andere Zahlen, Anmerkungszeichen, die Satzzeichen eines seitlich gedrehten Laufs (, . : ; ( ) ' " - /), Halbgeviert- und Geviertstriche und typografische Anführungszeichen (pages 3–5 of, the “49” copies) hinweg bis zum ersten Buchstaben oder chinesischen Zeichen. Eine Zahl, deren Zeichen zu chinesischem Text führen, steht aufrecht (上午12:30:45开会, 比分为3:2:1, 见图(3)所示, 他住在"12"号楼), ebenso eine neben einem chinesischen Zeichen oder Satzzeichen, mit oder ohne Leerzeichen (第 3 回, 用iPhone 15拍攝, 第3 copies), eine neben einem Zeichen, das aufrecht steht (a 30×40 print), und eine am Anfang oder Ende eines Absatzes, die nur auf einer Seite ein Wort hat (49 copies were printed, on page 7.: Schreiben Sie :sideways[…], um sie zu drehen). Der Absatz wird als Ganzes gelesen, über Zeilenumbrüche, Hervorhebungen und Links hinweg.
• Neben einem Zeichen, das Unicode aufrecht setzt, erhält jede Zahl ihre eigene Zelle: 30×40 ist 30, ×, 40, alle aufrecht.
• Eine Zelle mit mehr Zeichen, als in ein Geviert passen, wird in der Breite auf das Geviert gestaucht; Laufweite und Blocksatz greifen nie in sie ein, nur nach ihr.
• Für Umbruch und Blocksatz zählt die Zelle als ein chinesisches Zeichen, und um sie herum wird kein Han-Latein-Abstand gesetzt.
• In Japan stehen auch die Paare !!, !?, ?! und ??, in halber oder voller Breite, aufrecht in einer Zelle (すごい！？), sofern kein lateinischer Buchstabe, keine Ziffer und kein drittes Zeichen sie berührt; ein Paar voller Breite wird mit den Zeichen halber Breite gemalt. Kleine Kana, ：；, “ ” (gemalt als 〝〟) und ・ nehmen die japanischen vertikalen Formen an (siehe Japanischer Satz › Senkrechte Formen).
• Das Messwerkzeug und jeder Renderer finden dieselben Zellen: Das Canvas malt die Ziffern zurückgedreht aufrecht und gestaucht, das PDF ebenso mit der horizontalen Schrift, und das HTML umschließt sie mit text-combine-upright: all.

Von Hand überschreiben drei Inline-Zeichen die Einstellung im vertikalen Text und ändern im horizontalen Text nichts (siehe Dokumentformat › Ausrichtung in senkrechtem Text):

第:tcy[120]回、:upright[GDP]與:sideways[12]

:tcy[…] setzt seinen Text in eine aufrechte Zelle, :upright[…] stellt jedes Zeichen aufrecht in eine eigene Zelle (lateinische Buchstaben darin zentriert), :sideways[…] dreht den ganzen Lauf, chinesische Zeichen eingeschlossen. Im VDT ist ein Lauf :tcy ein Segment mit tcy: true, ein Geviert breit; ein Lauf :upright oder :sideways trägt orientation. Die Zahlen, die uprightDigits in eine Zelle setzt, tragen keine Markierung: verticalRuns(graphemes, region, uprightDigits) findet sie. In einem Absatz trägt eine kurze Zahl, die mit lateinischen Wörtern läuft, orientation: 'sideways', als wäre sie als :sideways[…] geschrieben: Ihr Segment enthält nicht immer die Wörter, mit denen sie läuft.

#Zeichenraster

Ein chinesischer Satzspiegel wird in Zeichen angegeben (clreq §7.1.1): Schriftgröße × Zeichen pro Zeile × Zeilen pro Seite, dazu der Zeilenzwischenraum und bei zwei Spalten der Spaltenabstand. grid legt ihn so fest:

cjk: { grid: { enabled: true, charsPerLine: 28, linesPerPage: 28, show: true } }

Mit enabled wird die Konfiguration umgeschrieben, bevor irgendetwas sie liest: Jede Spalte ist charsPerLine Geviert von bodyText.fontSize breit und der Satzspiegel linesPerPage Zeilen von bodyText.lineHeight hoch; bei layoutType: 'double' ist der Spaltenabstand layout.gutterWidth, auf eine ganze Zahl von Geviert gerundet, mindestens eins. Die Ränder in page.margins wirken als Mindestwerte: Der Satzspiegel wird in die Mitte der Fläche gesetzt, die sie lassen, und jeder Rand wächst um die Hälfte des Platzes, der auf seiner Achse übrig bleibt (ein gespiegeltes Buch hält Bundsteg und Außensteg getrennt, beide wachsen um denselben Betrag). Bleiben charsPerLine und linesPerPage ungesetzt, nehmen sie so viele, wie passen. Eine größere Zahl, als passt, wird auf das Passende verringert und als Konfigurationswarnung cjkGridClamped gemeldet. Schriftgröße und Zeilenabstand bleiben, wie sie geschrieben sind. In einem Layout oneAndHalf gilt charsPerLine für die Hauptspalte; die Seitenspalte erhält die ganze Zahl von Geviert, die der Breite am nächsten kommt, die sideColumnPercent ihr innerhalb der konfigurierten Ränder gibt (mindestens eins), der Spaltenabstand wird wie bei zwei Spalten gerundet, und sideColumnPercent wird umgeschrieben, sodass beide Spalten in ganzen Geviert geschnitten sind. Im vertikalen Text (layout.writingMode: 'vertical-rl') laufen die Zeichen einer Zeile die Seite hinunter und die Zeilen quer über sie, daher misst charsPerLine die Höhe der Seite, ein Layout double ergibt zwei von oben nach unten gestapelte Ebenen, und die Zellen der Überlagerung stehen auf der Achse, auf der die Zeichen zentriert sind.

Eine Seite im Raster enthält die Zeilen, die ihr Raster zählt, daher folgen die beiden Regeln, die eine Spalte um eine Zeile kürzer lassen, dem Raster. bodyText.avoidWidows, das einen Absatz ganz weiterschiebt, wenn nur eine seiner Zeilen am Fuß einer Spalte Platz hat, ist dort standardmäßig aus. bodyText.avoidOrphans, das eine Zeile aus der vorigen Spalte nimmt, damit ein Absatz nicht mit einer Zeile am Kopf der nächsten endet, bleibt für ein chinesisches Dokument an (孤行, clreq §7.1.2) und ist in der Region japan aus: JLReq §3.5.4 zählt die Zeichen der letzten Zeile eines Absatzes, nicht seine Zeilen an einem Seitenumbruch. Eine Konfiguration, die einen der beiden Schlüssel setzt, behält ihren Wert, und eine vor postext 1.28 gespeicherte behält beide Regeln an (configVersion 12).

Zwei Layouts aus der chinesischen Praxis, in 五号 (10,5 pt) mit 6 pt Zeilenzwischenraum (lineHeight: 16.5pt):

• 大32开, 140 × 203 mm, 28 × 28: eine Satzbreite von 294 pt (103,7 mm) und ein Satzspiegel von 462 pt (163 mm); page.margins von 16/20 mm innen und außen und 18/20 mm oben und unten lassen Platz dafür.
• 16开, 184 × 260 mm, zwei Spalten zu 23 Zeichen in 小五 (9 pt, Zeilen von 13,5 pt) mit einem Spaltenabstand von zwei Zeichen: 2 × 207 pt + 18 pt.

show zeichnet das Raster (稿纸) über den Satzspiegel, ein hellgraues Quadrat je Zeichenposition in jeder Zeile (das Geviert des Zeichens um seine Grundlinie), in jeder Spalte der Seite (eine Seitenspalte von oneAndHalf auf der Seite, auf die die Seitenparität sie setzt), auf dem Canvas und im HTML. Das PDF zeichnet es nur, wenn renderToPdf characterGrid: true erhält: Es ist eine Bildschirmhilfe. cjkGridGeometry(config) gibt das Raster zurück, das eine Konfiguration festlegt (verwendete Zahlen, Ränder, Satzspiegel), und applyCjkGrid(config) die umgeschriebene Konfiguration.

fullLines ist für Manuskriptpapier (原稿用紙) gedacht, auf dem jedes Quadrat einer vollen Zeile beschrieben wird. Ein Absatz endet nicht auf einem einzelnen Zeichen (siehe bodyText.avoidRunts): Die Zeile darüber gibt ihm ihr letztes Zeichen, und wenn diese Zeile nicht im Blocksatz steht, bleibt sie ein Quadrat kürzer. Mit fullLines: true behält eine Zeile, die nicht im Blocksatz steht, jedes Quadrat, und der Absatz darf auf einem Zeichen enden; eine Zeile im Blocksatz gibt ihr Zeichen weiterhin ab und wird auf die Satzbreite ausgetrieben. Standardmäßig aus. Seit postext 1.28.

#Zeichen, Ruby und Warichu

Das Markup für chinesische Zeichen, Ruby und Warichu belässt seinen Text im Absatz: Suche, Inhaltsverzeichnis, Registeranker und kopierter Text lesen die Zeichen, wie sie geschrieben sind, und nur was um sie herum gezeichnet wird, hängt von diesen Einstellungen ab.

• Betonungspunkte (着重号, 傍点; :dots[…] sowie *…* auf CJK-Zeichen unter emphasis: 'dots') setzen ein Zeichen je Schriftzeichen, darauf zentriert (ohne die Sperrung einer Zeile im Blocksatz), nie auf Satzzeichen oder Leerzeichen: unter dem Zeichen im horizontalen Text, rechts davon im vertikalen (clreq §5.3.1). style wählt einen gefüllten Punkt, einen offenen Kreis oder ein Sesamzeichen, fill="open" zeichnet die Kontur, pos="over|under" die Seite; emphasisMark legt fest, was ein Zeichen ungesetzt lässt (in Japan ein Sesamzeichen über dem Text, rechts davon im vertikalen Text). Ein Sesamzeichen steht in beiden Schreibrichtungen gleich auf dem Bogen, und Zeichen auf der Seite einer Ruby-Lesung kommen außerhalb davon.
• Seitenlinien (傍線, :sideline[…]{style pos}) laufen neben dem Text, Satzzeichen und Leerzeichen eingeschlossen: solid, double, wavy oder dotted, standardmäßig unter dem Text quer über die Seite und rechts davon die Seite hinunter; zwei Linien, die aufeinandertreffen, geben je ein Achtelgeviert auf. Sie funktionieren in jedem Schriftsystem.
• Linien für Eigennamen und Buchtitel (专名号 :name[…], 书名号 :book[…] unter bookTitleMark: 'wavy') laufen unter dem Geviert der Zeichen (links davon im vertikalen Text), über die Leerzeichen innerhalb des Laufs hinweg. Wo zwei Läufe aufeinandertreffen, gibt jedes Ende ein Achtelgeviert auf, sodass :name[賈寶玉]:name[林黛玉] als zwei Namen gelesen wird. Markieren Punkte und eine Linie denselben Text auf einer Seite, liegt die Linie näher am Text. Unter 'brackets' sind die 《》 Text, mit dem die Zeilen umbrochen werden, gemalt und kopiert wie jedes andere Zeichen; sie belegen kein Zeichen des reinen Texts oder der Quellzuordnung (die Segmente sind als inserted markiert).
• Ruby-Lesungen sitzen im Zeilenzwischenraum am Geviert der Basis, darauf zentriert; eine Lesung, die einen lateinischen Buchstaben enthält (Pinyin) und über ihrer Basis steht, wird um die Tiefe der Unterlängen ihrer Schrift (g, j, p, q, y) und 0,04 em des Texts angehoben, damit sie die Basis freigibt, und jede Lesung der Zeile behält eine gemeinsame Grundlinie; eine Lesung, die breiter als ihre Basis ist, verbreitert das Kästchen der Basis, abzüglich eines Viertels des Ruby-Gevierts, das sie auf einen Nachbarn ohne Lesung übergreifen darf, und zwei Lesungen halten ein Viertel des Ruby-Gevierts Abstand (zwei Zhuyin-Lesungen ein Viertel des Gevierts der Symbole, sodass drei Symbole neben jedem von zwei Zeichen in ihren Zellen bleiben). Ein Mono-Ruby (eine Lesung je Zeichen) darf zwischen seinen Zeichen umbrechen; ein Gruppen-Ruby bricht nie um. In Japan folgt eine Lesung stattdessen ruby.align und ruby.overhang: im Verhältnis 1:2:1 verteilt, wenn sie kürzer als ihre Basis ist, auf Kana, aber nicht auf Kanji übergreifend, wenn sie länger ist, wobei der restliche Platz durch Sperren der Basis entsteht; ein zeichenweises Ruby aus zwei oder mehr Zeichen ist ein Jukugo-Ruby, bei dem jedes Zeichen seine Lesung behält, die auf das nächste Zeichen des Worts übergreifen darf, aber nie eine andere Lesung überlappt, und die Zeile weiterhin zwischen ihnen umbricht (JLReq §3.3). Am Zeilenanfang oder -ende richten sich Basis und Lesung an der Kante aus (clreq §5.5.4). Zhuyin steht im horizontalen Text in einer Spalte rechts von jedem Zeichen, und das Kästchen des Zeichens wächst um die Spalte; im vertikalen Text läuft dieselbe Spalte rechts an den Zeichen hinunter. Das Tonzeichen kommt rechts neben die Spalte, mit der Hälfte seiner Farbe über der Oberkante des letzten Symbols (clreq §5.5.3.3), nach seiner Farbe platziert, weil Schriften diese Zeichen hoch in ihr Geviert setzen, und im vertikalen Text steht es aufrecht, wie der Punkt des neutralen Tons über dem ersten Symbol.
• Warichu-Anmerkungen (双行夹注) falten sich in Anmerkungsgröße in zwei Zeilen, auf der Zeile zentriert, ohne Abstand dazwischen. Die obere Zeile nimmt Zeichen auf, bis sie mindestens die Hälfte des Teils enthält, damit die zweite Zeile nicht die längere ist, und noch eines, solange die untere Zeile mit einem Zeichen beginnen würde, das keine Zeile eröffnen darf. Würde jede solche Faltung die untere Zeile mit einem Satzzeichen eröffnen (本名。), wird die Faltung davor genommen, und die untere Zeile ist die längere: 本 über 名。; ein Teil aus einem Zeichen und seinen Satzzeichen bleibt eine Zeile. Eine Anmerkung, die länger ist als der Platz, der auf einer Zeile bleibt, füllt ihn und setzt sich auf der nächsten Zeile, Spalte oder Seite fort, und eine Zeile bricht in ihr nur dort um, wo auf beiden Seiten warichu.minChars ihrer Zeichen stehen (standardmäßig 2; Satzzeichen und Wortzwischenräume zählen nicht), sodass keine Zeile, Spalte oder Seite mit einem kleinen Zeichen und seinem Schlusszeichen beginnt; ihre Klammern stehen nur vor ihrer ersten und nach ihrer letzten Zeile. Im vertikalen Text ist die obere Zeile die rechte, die zuerst gelesen wird.
• Kanbun-Zeichen (:kunten[字]{kaeri okuri tate}) setzen die Rücksprungzeichen des letzten Zeichens an die Fußseite der Zeile danach (unten links im vertikalen Text), seine Okurigana von seiner Mitte aus an die Kopfseite, wobei längere das nächste Zeichen weiterschieben, und den Tatesen als kurze Linie zum nächsten Zeichen (JIS X 4051 §5). Kopierter Text und das /ActualText des PDFs lesen die Okurigana nach ihren Zeichen und lassen die Rücksprungzeichen weg; ein Zeilenzwischenraum, der zu schmal für sie ist, wird als kuntenExceedsLeading gemeldet.

Der Zeilenabstand ändert sich nie: Zeichen und Lesungen leben im Durchschuss. Ein Absatz, dessen Zeilenzwischenraum (Zeilenabstand minus Textgröße) bei Zeichen auf einer Seite unter einem halben Geviert liegt oder bei Zeichen auf beiden Seiten unter fünf Achteln (clreq §5.6.1), wird als Inhaltswarnung cjkMarksExceedLeading gemeldet; einer, dessen Lesungen höher sind als sein Zwischenraum (eine Pinyin-Lesung mit ihrer Anhebung gezählt), als rubyExceedsLeading. Geben Sie solchen Absätzen ein Absatzformat mit mehr Durchschuss. Japanische Bücher mit Furigana setzen den Grundtext meist mit einem Zeilenabstand von etwa 1,75 em (JLReq §2.4.2).

Im VDT trägt ein markiertes Segment cjkMarks, und das Layout setzt die Punkte und Linien auf seinen Zeilen als VDTLine.marks (Punkte, Kreise, Sesamzeichen, gerade, doppelte, gepunktete und gewellte Linien, im Flussrahmen der Zeile), die Canvas, HTML und PDF unverändert zeichnen (PDF: Artifact /Layout; HTML: Kästchen mit aria-hidden, punktierter Text in <em>). Das Segment einer Ruby-Basis trägt ruby (die Lesung und ihre Läufe; bei einer japanischen Lesung auch die id, die ihre Annotation mit den anderen Zeichen eines Jukugo-Worts teilt, und jukugo) und malt seine Basis bei inkOffset, mit tracking, wenn die Lesung sie gesperrt hat; ein Zeichen mit Kanbun-Zeichen trägt kunten (seine Läufe und seinen Tatesen); der Teil einer Warichu-Anmerkung auf einer Zeile ist ein Segment, dessen text seine obere und dann seine untere Zeile ist und dessen warichu die Zeilen enthält, die die Renderer stattdessen malen. Getaggtes PDF legt eine Lesung in das RT des Ruby ihrer Basis und eine Anmerkung in ein Warichu, und das /ActualText der Zeile liest den Basistext und die Anmerkung je einmal. Zeichen, Lesungen und Anmerkungen werden im Grundtext, in Überschriften, Listen und Kästen gezeichnet sowie in den Legenden, Tabellenzellen und Anmerkungen von Ressourcen, deren Zeilen marks und ruby wie Zeilen des Grundtexts tragen; Gestaltungstext behält den Text ohne sie.

Resolver und Stripper entsprechen den anderen Abschnitten. spaceAfterQuestion, paragraphStartBracket und wordBreak sowie overhang, align und smallKana des Ruby stehen nur dann in der aufgelösten Konfiguration, wenn sie etwas ändern (in Japan oder wenn sie gesetzt sind). setCjkLineBreak und setCjkComposition legen die Stufe und den Satz (Breite der Satzzeichen, Überhang, Han-Latein-Abstand; cjkCompositionOf(resolved.cjk, dpi)) für Messungen außerhalb von buildDocument fest, das sie aus der Konfiguration setzt. Außerhalb eines Builds behalten Zeichen ihre volle Dickte, und es wird kein Han-Latein-Abstand gesetzt:

import { DEFAULT_CJK_CONFIG, resolveCjkConfig, stripCjkDefaults, cjkRegionOf, setCjkLineBreak, setCjkComposition, cjkCompositionOf } from 'postext';
 
resolveCjkConfig(undefined, 'zh-HK');
// { region: 'hongkong', lineBreak: 'basic', punctuationWidth: 'fullwidth', compressAdjacent: true,
//   trimLineStart: true, hangingPunctuation: 'none', latinSpacing: { value: 0.25, unit: 'em' }, uprightDigits: 2,
//   grid: { enabled: false, charsPerLine: 0, linesPerPage: 0, show: false, fullLines: false },
//   emphasis: 'dots', emphasisMark: { style: 'dot', fill: 'auto', position: 'auto' },
//   bookTitleMark: 'wavy', bookTitleBrackets: [{ open: '《', close: '》' }, { open: '〈', close: '〉' }],
//   ruby: { fontSize: { value: 0.5, unit: 'em' }, position: 'auto' },
//   warichu: { fontSize: { value: 0.5, unit: 'em' }, open: '', close: '', minChars: 2 }, kunten: { … } }
 
resolveCjkConfig(undefined, 'ja');
// { region: 'japan', lineBreak: 'ja-very-strict', punctuationWidth: 'fullwidth', compressAdjacent: true,
//   trimLineStart: true, hangingPunctuation: 'allow', spaceAfterQuestion: true, paragraphStartBracket: 'half', …,
//   emphasisMark: { style: 'sesame', fill: 'auto', position: 'over' }, bookTitleMark: 'brackets',
//   bookTitleBrackets: [{ open: '『', close: '』' }, { open: '「', close: '」' }],
//   ruby: { fontSize: { value: 0.5, unit: 'em' }, position: 'auto', overhang: 'kana', align: 'jis' },
//   warichu: { fontSize: { value: 0.5, unit: 'em' }, open: '（', close: '）', minChars: 2 }, kunten: { … } }

In der Sandbox stehen diese Einstellungen unter Gestaltung › Schriftsystem › Ostasiatische Typografie.