LuaTeX-CN

English Version

致力于基于 LuaTeX 引擎实现最纯粹、最高质量的中文排版支持。已完成对常见古籍版式的像素级复刻，能够直观地处理版心、夹注、侧批、眉批、脚注、印章、句读、改字、标点等等功能。同时支持现代繁体竖排，支持大陆与台湾不同标点标准。灵活支持用户自定义模板。

CTAN: v0.3.1 | GitHub Release: v0.3.1

Wiki 用户手册 ｜ 快速入门 ｜ 命令索引 ｜ 更新日志

排版效果展示

古籍排版 - 四库全书·文渊阁本

手抄本 -《红楼梦》甲戌本

查看源码 | 查看 PDF

现代繁体竖排 -《史记·秦楚之际月表》

查看源码 | 查看 PDF

更多示例请查看 示例目录 或 Wiki 示例页。

5 分钟快速开始

第一步：安装 TeX 发行版

如果你还没有安装 LaTeX 环境，需要先安装 TeX Live（推荐 2024 或更新版本）：

详细指引请参阅 Wiki 安装指南。

第二步：安装 luatex-cn

推荐从 GitHub Release 下载最新版本的 luatex-cn-tex-v*.zip，解压后将 tex/ 下的内容放入：

~/texmf/tex/latex/luatex-cn/          (macOS/Linux)
C:\Users\<用户名>\texmf\tex\latex\luatex-cn\  (Windows)

然后运行 texhash 刷新。

也可以通过包管理器安装（CTAN 版本可能落后）：

tlmgr install luatex-cn

第三步：编译你的第一个古籍

创建 test.tex，写入以下内容：

\documentclass[四库全书]{ltc-guji}
\句读模式
%\设置字体{TW-Kai}

\title{钦定四库全书}
\chapter{史记\\卷一}

\begin{document}
\begin{正文}
黄帝者，少典之子，姓公孫，名曰軒轅。\夹注{生而神靈，弱而能言，幼而徇齊，長而敦敏，成而聰明。}
\end{正文}
\end{document}

使用 lualatex 编译（注意不是 pdflatex 或 xelatex）：

lualatex test.tex

编译成功后打开 test.pdf，你将看到一个完整的古籍竖排页面。

接下来请查看 Wiki 快速入门 了解更多命令用法，或浏览 命令索引 查看全部命令。

功能特性

三个文档类

所有命令都支持简体、繁体中文名称。例如 \夹注{...}、\侧批{...}、\begin{正文}。

模板

除了默认模板，luatex-cn 支持自定义模板。欢迎贡献新的模板！请将模板文件放在 模板目录 并提交 Pull Request。推荐模板：

在文档中使用模板：

\documentclass[四库全书文渊阁本]{ltc-guji}
\begin{document}
  ...
\end{document}

。

系统要求

• LuaTeX（推荐 TeX Live 2024+）
• luaotfload 和 fontspec（TeX Live 自带）
• 中文字体（系统通常已自带，推荐思源宋体或楷体以获得最佳古籍效果）

路线图

• 已完成：古籍竖排，版心，夹注，侧批，眉批，脚注，印章，句读，改字，现代标点系统，模板系统等
• v0.2.x：完善现代繁体竖排，完整排版更多古籍
• v0.3.0：完善文档体系，支持简繁命令，准备更大范围推广

文档与社区

• Wiki 用户手册 — 完整的使用指南
• 命令索引 — 全部命令的参数速查
• 示例 — 查看完整的排版源码
• Issue — 报告 Bug 或提出建议

联系人: Sheldon Li | 邮件: sheldonli.dev@gmail.com

开发与测试

如果你希望参与开发或在本地测试源码更改，请参考 开发者指南 或 Wiki 开发文档。

许可证

Apache License 2.0