w:kinsoku (Use East Asian Typography Rules)
Enables Japanese/East Asian line-break prohibition rules (kinsoku) for a paragraph.
Parent elements
Description
w:kinsoku is a toggle property that enables kinsoku shori — a set of East Asian typography rules that prohibit certain characters from appearing at the beginning or end of a line. For example, opening punctuation such as 「 must not end a line, and closing punctuation such as 」 must not start a line.
It is defined in ECMA-376 Part 1 §17.3.1.16.
When true, the processor applies the kinsoku rules defined in the document or application settings. When false, all characters may be used as line-break opportunities freely.
Attributes
| Attribute | Type | Possible Values | Description |
|---|---|---|---|
w:val |
ST_OnOff |
true, false, 1, 0, on, off |
Enables East Asian line-break prohibition rules. Omit to inherit. |
Examples
<!-- Japanese paragraph with kinsoku rules enabled -->
<w:p>
<w:pPr>
<w:kinsoku/>
</w:pPr>
<w:r><w:t>日本語のテキストが禁則処理で行末に来ません。</w:t></w:r>
</w:p>using DocumentFormat.OpenXml.Wordprocessing;
var para = new Paragraph(
new ParagraphProperties(
new Kinsoku()
),
new Run(new Text("日本語のテキストが禁則処理で行末に来ません。"))
);Notes
- Kinsoku rules are standard practice in professional Japanese typography (JIS X 4051).
- The sets of “cannot-start-line” and “cannot-end-line” characters may be customized at the document level.
- Related properties:
w:overflowPunct(allow punctuation overflow),w:topLinePunct(compress punctuation at top of line).