-
Notifications
You must be signed in to change notification settings - Fork 10
Features
English Version | 中文版
luatex-cn 提供了丰富的中文排版功能：从核心的竖排引擎、古籍版式元素，到按 clreq 实现的现代横排管道。本页面概览了宏包的主要功能模块。
基于 LuaTeX 的网格布局系统，实现高精度的竖排文本流。
- RTT 流向：原生支持从上到下、从右到左的流向。
- 网格定位：字符精确对齐到定义的网格中。
- 分页与换列：自动处理复杂的页面分割和列流转。
| 文档类 | 用途 | 详情 |
|---|---|---|
ltc-guji |
传统古籍排版，支持版心、鱼尾、丝栏等传统元素 | 快速入门 |
ltc-guji-digital |
古籍数字化录入：一行源码 = 一个竖排列，\双列{\右小列{…}\左小列{…}} 手工分栏，精确复刻底本版面 |
源码示例 |
ltc-cn-vbook (v0.2.8+) |
现代中国大陆竖排书籍，简洁设计，内置脚注和标点系统 | ltc-book |
ltc-tw-vbook (v0.2.8+) |
现代台湾竖排书籍，居中标点 | ltc-book |
ltc-guji和ltc-book仍可使用，但推荐使用上述新名称。
按 W3C clreq 实现的现代中文横排管道，主包名 luatex-cn 即其统一入口（内部实现名 luatex-cn-hori 仍可直接加载）。它是宏包而非文档类，加载到 article 等任意横排文档类之上即可；规则内核与竖排共用 tex/shared/ 下的同一份实现。
\usepackage{fontspec}
\setmainfont{Source Han Serif SC}[Script=CJK, Language={Chinese Simplified}]
\usepackage[style=taiwan]{luatex-cn}- 中西间距：1/4 em，可挤至 1/8、拉至 1/2，含 clreq 规定的三类例外。
- 标点宽度调整：中国大陆式／台式／不调整三套预设，连续标点缩减，行末标点半字宽，行尾点号悬挂（可选）。
- 换行控制：四级禁则（none/basic/gb/strict）与符号分离禁则；行内按 clreq 优先顺序做二次分配（挤压 7 级／拉伸 2 级 + 兜底均分）。
-
行间标号与行间注：
\专名、\书名号甲、\着重；\拼音／\对照词对齐标音。 -
段落与页面：段首缩排两字、段末孤字避免、页首页尾孤行控制、凸排与段落缩排环境、段末行四种对齐、号数字号
\字号。 - 引号体例转换：默认不改来稿，可按风格自动或显式转为弯引号／直角引号。
规则实现由 test/clreq_test.py 解析 PDF 内容流逐条度量断言，已并入 CI。详见 现代横排。
⚠️ 需要 LuaTeX，且与luatexja（ctex在 LuaLaTeX 下会载入）互斥。
⚠️ 尚未进入发行版（最新发行版 v0.3.8），请从 main 分支获取。
-
标点系统 (v0.2.7+)：现代标点挤压、禁则处理、竖排引号替换，支持中国大陆/台湾风格。竖排标点宽度调整为上下文相关（clreq），字面分布按字形墨迹度量锚定，不依赖字体自身的字面设计。main 分支另有：行尾点号悬挂（
punct-hanging）、中西混排间距（1/4em，western-space）、西文横置（\横置）、连接号/间隔号/分隔号扩类（中国大陆式间隔号半字宽）。 - 句读：传统句读标记，三种模式（normal/judou/none）随时切换。
完整支持传统装帧所需的视觉元素：
- 版心与鱼尾：支持单鱼尾、双鱼尾、乌丝栏等。
- 筒子页：支持电子阅览与传统装订的纸张分割。
- 边框系统：支持四周双边、内框等。
提供多种维度的文本注释方式：
- 夹注：正文中的双行小字，支持自动平衡算法。
- 侧批：行间的垂直注释。
- 批注：页面任意位置的浮动注释框。
- 眉批 (v0.2.3+)：页面顶部的批注。
- 脚注 (v0.2.7+)：段末注和页下注，支持鹿角/带圈编号。
-
目录条目：
\条目(v0.2.5+)，支持层级缩进。
\Style（或 \样式）命令允许在正文中临时覆盖字号、字体、字体颜色、格高、间距等样式属性，而不影响当前布局模式。
% 行内用法
\样式[字号=16pt, 字体颜色=red]{重要文本}
% 环境用法（适合多行内容）
\begin{样式环境}[字号=14pt, 间距=0.5em]
多行样式化文本……
\end{样式环境}支持参数：
| 参数 | 中文别名 | 说明 |
|---|---|---|
font-size |
字号 |
覆盖字号 |
font |
字体 |
覆盖字体 |
font-color |
字体颜色 |
覆盖字色 |
grid-height |
格高 |
覆盖格高 |
spacing-top |
上间距 |
上方附加间距 |
spacing-bottom |
下间距 |
下方附加间距 |
spacing |
间距 |
同时设置上/下间距 |
样式通过内部注册表管理，支持跨页保持和嵌套使用。详见 命令索引。
Cover（或 \begin{封面}）环境用于排版封面页。它会自动关闭边框、外框和版心，并支持设置页面背景色。
\begin{封面}[底色=200,200,200]
\行[对齐=center, 字号=24pt]{书名}
\行[对齐=center, 字号=14pt]{作者}
\end{封面}| 参数 | 中文别名 | 说明 |
|---|---|---|
background-color |
底色 |
封面背景色（颜色名或 RGB） |
封面环境内部套用了 SinglePage（单页）+ BodyText（正文），无需手动处理分页。背景色仅作用于封面页，不会泄漏到后续页面。
\LineMark（或 \线标）在字符旁绘制装饰线条（直线或波浪线），用于标示专名号和书名号。与传统 Unicode 字符不同，线标使用 PDF 图形命令绘制，精度更高、样式更灵活。
% 专名号（直线）
\专名号{孔子}
% 书名号（波浪线）
\书名号{红楼梦}
% 自定义样式
\线标[类型=wavy, 颜色=blue, 振幅=large]{强调内容}快捷命令：
| 命令 | 中文别名 | 效果 |
|---|---|---|
\ProperNameMark |
\专名号 \下划线
|
直线标记 |
\BookTitleMark |
\书名号 \波浪线
|
波浪线标记 |
支持参数：
| 参数 | 中文别名 | 说明 | 默认值 |
|---|---|---|---|
type |
类型 |
straight（直线）或 wavy（波浪） |
straight |
color |
颜色 |
线条颜色 | black |
offset |
偏移 |
线条与文字的距离 | 0.6em |
amplitude |
振幅 |
波浪幅度：small medium large
|
medium |
line-width |
线宽 |
线条粗细 | 0.8pt |
style |
风格 |
standard（紧凑）或 cursive（手写感） |
standard |
线标在夹注、侧批等小字环境中会自动缩放适配。
-
强制分列：
\列(或\Column) 强制从新的一列开始排版。 -
末列控制：
\末列(或\LastColumn) 将内容排在当前页的最后一列。 -
灵活列宽：
\行[width=2cm]{...}(v0.2.7+) 支持不等宽列布局。 -
分页控制：支持标准的
\newpage和\clearpage。 -
换半页 (v0.3.6+)：
\换半页/\NewHalfPage在筒子页模式下跳到下一半页。 -
插图页 (v0.3.6+)：
\插图页/\IllustrationPage隐藏丝栏保留边框，用于插入全页插图 (fix #29)。 -
自然排版 (v0.2.7+)：
layout-mode=natural非等距字符排列。 -
自由列宽模式 (v0.2.8+)：
n-column=0时启用可变列宽布局，列宽随内容自动调整（ltc-cn-vbook/ltc-tw-vbook默认启用）。
- 印章：在页面任意位置添加馆藏印或私印，支持透明度。
- 字体设置：支持自动探测、字体族递补机制。v0.2.2 起支持简繁体中文字体名称。
- 文本框：支持网格布局、自动扁平化压缩及自由填充。透明度控制 (v0.3.6+)。
-
牌记 (v0.3.6+)：
\牌记/\colophon不透明双层边框悬浮文本框。 - 改字与装饰：古籍勘误改字（\改）与字符级装饰（\装饰）。
- 抬头 (v0.2.6+)：敬语抬头格式（单抬、双抬、三抬、平抬）。
- 样式注册表：多属性样式存储（颜色、字号、网格高度），支持跨页样式保持。
-
元数据系统：集中化书籍元数据管理（
\title、\publisher、\ChapterMarker）。 -
调试模式：
\LtcDebugOn开启后显示页面网格坐标，\LtcShowGrid显示坐标网格。 -
排版坐标导出：
\启用排版导出将排版结果导出为 JSON 文件，包含每个字符的精确坐标、页面/列/行信息、夹注和侧批数据。 - 插件架构：标准化插件 API，模块统一实现 initialize/layout/render 三阶段接口。
预设了多种经典风格，开箱即用。详见 模板与自定义。
-
四库全书：清代内府排版风格。 -
四库全书彩色：彩色版四库全书风格。 -
红楼梦甲戌本：手抄本批改风格。 -
中华书局(v0.2.7+)：现代竖排中国大陆风格。
📜 LuaTeX-CN | Licensed under Apache License 2.0