Features

English Version | 中文版

功能详解

luatex-cn 提供了丰富的古籍排版功能，从核心的竖排引擎到各种装饰性元素。本页面概览了宏包的主要功能模块。

1. 核心排版引擎

基于 LuaTeX 的网格布局系统，实现高精度的竖排文本流。

• RTT 流向：原生支持从上到下、从右到左的流向。
• 网格定位：字符精确对齐到定义的网格中。
• 分页与换列：自动处理复杂的页面分割和列流转。

2. 三个文档类

文档类	用途	详情
guji	传统古籍排版，支持版心、鱼尾、丝栏等传统元素	快速入门
cn-vbook (v0.2.8+)	现代大陆竖排书籍，简洁设计，内置脚注和标点系统	ltc-book
tw-vbook (v0.2.8+)	现代台湾竖排书籍，居中标点	ltc-book

ltc-guji 和 ltc-book 仍可使用，但推荐使用上述新名称。

3. 标点处理

• 标点系统 (v0.2.7+)：现代标点挤压、禁则处理、竖排引号替换，支持大陆/台湾风格。
• 句读：传统句读标记，三种模式（normal/judou/none）随时切换。

4. 古籍版式元素

完整支持传统装帧所需的视觉元素：

• 版心与鱼尾：支持单鱼尾、双鱼尾、乌丝栏等。
• 筒子页：支持电子阅览与传统装订的纸张分割。
• 边框系统：支持四周双边、内框等。

5. 注释与批改系统

提供多种维度的文本注释方式：

• 夹注：正文中的双行小字，支持自动平衡算法。
• 侧批：行间的垂直注释。
• 批注：页面任意位置的浮动注释框。
• 眉批 (v0.2.3+)：页面顶部的批注。
• 脚注 (v0.2.7+)：段末注和页下注，支持鹿角/带圈编号。
• 目录条目：\条目 (v0.2.5+)，支持层级缩进。

6. 样式控制 (v0.2.8+)

\Style（或 \样式）命令允许在正文中临时覆盖字号、字体、字体颜色、格高、间距等样式属性，而不影响当前布局模式。

% 行内用法
\样式[字号=16pt, 字体颜色=red]{重要文本}

% 环境用法（适合多行内容）
\begin{样式环境}[字号=14pt, 间距=0.5em]
  多行样式化文本……
\end{样式环境}

支持参数：

参数	中文别名	说明
font-size	字号	覆盖字号
font	字体	覆盖字体
font-color	字体颜色	覆盖字色
grid-height	格高	覆盖格高
spacing-top	上间距	上方附加间距
spacing-bottom	下间距	下方附加间距
spacing	间距	同时设置上/下间距

样式通过内部注册表管理，支持跨页保持和嵌套使用。详见 命令索引。

7. 封面 (v0.2.8+)

Cover（或 \begin{封面}）环境用于排版封面页。它会自动关闭边框、外框和版心，并支持设置页面背景色。

\begin{封面}[底色=200,200,200]
  \行[对齐=center, 字号=24pt]{书名}
  \行[对齐=center, 字号=14pt]{作者}
\end{封面}

参数	中文别名	说明
background-color	底色	封面背景色（颜色名或 RGB）

封面环境内部套用了 SinglePage（单页）+ BodyText（正文），无需手动处理分页。背景色仅作用于封面页，不会泄漏到后续页面。

8. 线标——专名号与书名号 (v0.2.8+)

\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

线标在夹注、侧批等小字环境中会自动缩放适配。

9. 布局控制与排版命令

• 强制分列：\列 (或 \Column) 强制从新的一列开始排版。
• 末列控制：\末列 (或 \LastColumn) 将内容排在当前页的最后一列。
• 灵活列宽：\行[width=2cm]{...} (v0.2.7+) 支持不等宽列布局。
• 分页控制：支持标准的 \newpage 和 \clearpage。
• 自然排版 (v0.2.7+)：layout-mode=natural 非等距字符排列。
• 自由列宽模式 (v0.2.8+)：n-column=0 时启用可变列宽布局，列宽随内容自动调整（cn-vbook / tw-vbook 默认启用）。

10. 装饰与辅助功能

• 印章：在页面任意位置添加馆藏印或私印，支持透明度。
• 字体设置：支持自动探测、字体族递补机制。v0.2.2 起支持简繁体中文字体名称。
• 文本框：支持网格布局、自动扁平化压缩及自由填充。
• 改字与装饰：古籍勘误改字（\改）与字符级装饰（\装饰）。
• 抬头 (v0.2.6+)：敬语抬头格式（单抬、双抬、三抬、平抬）。

11. 架构与调试功能（v0.2.0+）

• 样式注册表：多属性样式存储（颜色、字号、网格高度），支持跨页样式保持。
• 元数据系统：集中化书籍元数据管理（\title、\publisher、\ChapterMarker）。
• 调试模式：\LtcDebugOn 开启后显示页面网格坐标，\LtcShowGrid 显示坐标网格。
• 插件架构：标准化插件 API，模块统一实现 initialize/layout/render 三阶段接口。

12. 模板系统

预设了多种经典风格，开箱即用。详见 模板与自定义。

• 四库全书：清代内府排版风格。
• 四库全书彩色：彩色版四库全书风格。
• 红楼梦甲戌本：手抄本批改风格。
• 中华书局 (v0.2.7+)：现代竖排大陆风格。

---

下一步：查看 模板与自定义 | 调试模式 | 示例 | 命令索引