Table

English Version | 中文版

表格 (Table) ^v0.3.4+

luatex-cn 提供了竖排表格环境，支持单元格分组、多栏布局、细粒度边框控制。表格嵌入在 \begin{正文}...\end{正文} 内使用。

注意：表格功能目前处于实验阶段。

---

1. 基本用法

\begin{正文}
前面的正文内容……

\begin{表格}[分栏=3, 栏间距=0.5em]
  \单元格{第一栏第一格}
  \单元格{第一栏第二格}
  \单元格{第二栏第一格}
  \单元格{第二栏第二格}
  \单元格{第三栏第一格}
  \单元格{第三栏第二格}
\end{表格}

后面的正文内容……
\end{正文}

---

2. 表格环境

\begin{Table} / \begin{表格}

参数	简体	繁体	类型	默认值	说明
n-bands	分栏	分欄	整数	2	分栏数量（水平方向划分）
band-gap	栏间距	欄間距	度量	0pt	栏与栏之间的间距
band-heights	栏高度	欄高度	列表	(空)	各栏高度，逗号分隔（如 10em,8em）
n-columns	列数	列數	字符串	(空)	每栏的列数
header-rows	表头栏数	表頭欄數	整数	0	表头栏数量
column-border	列边框	列邊框	字符串	(空)	列边框样式（作为所有栏的默认值）
band-border	栏边框	欄邊框	字符串	(空)	栏之间的横向分隔线
column-fill	列填充/列填滿	—	字符串	(空)	列填充方式，page（页/頁）= 填满整页

---

3. 单元格命令

\Cell / \单元格 / \單元格

语法：\单元格[参数]{内容}

参数	简体	繁体	类型	默认值	说明
col-width	列宽	列寬	数字	1	单元格占用的列数（支持小数）
vertical-align	纵对齐	縱對齊	字符串	(空)	纵向对齐方式

% 普通单元格
\单元格{内容}

% 跨两列的单元格
\单元格[列宽=2]{跨两列的内容}

---

4. 栏格式命令

\BandFormat / \栏格式 / \欄格式

在栏的开头（第一个 \单元格 之前）使用，设置当前栏的格式。

参数	简体	繁体	类型	默认值	说明
column-border	列边框	列邊框	字符串	(空)	当前栏的列边框
padding-top	上填充	—	度量	(空)	栏顶部填充
padding-bottom	下填充	—	度量	(空)	栏底部填充
padding	填充	—	度量	(空)	同时设置上下填充

\begin{表格}[分栏=2]
  \栏格式[列边框=true, 上填充=1em]
  \单元格{第一栏有边框}
  \单元格{第一栏第二格}

  \栏格式[列边框=false]
  \单元格{第二栏无边框}
\end{表格}

---

5. 完整示例

5.1 基础表格

\begin{正文}[行数=10, 边框=true]
  \begin{表格}[分栏=2, 栏间距=1em, 列边框=true]
    \单元格{世}
    \单元格{字}
    \单元格{名}
    \单元格{某甲}
    \单元格{某乙}
    \单元格{某丙}
  \end{表格}
\end{正文}

5.2 指定栏高度

\begin{表格}[分栏=3, 栏高度={5em,8em,5em}]
  \单元格{短栏}
  \单元格{中间高栏}
  \单元格{短栏}
\end{表格}

5.3 列填充整页

\begin{表格}[分栏=4, 列填充=页, 列边框=true, 栏边框=true]
  \单元格{会自动填满整页高度}
  ...
\end{表格}

---

6. 与分栏 (Band) 的关系

\begin{表格} 是内联表格，嵌入在 \begin{正文} 中，与正文内容混排。

\begin{正文} 本身也支持 分栏 参数，用于全局页面分栏（如报纸排版），两者是不同的使用场景：

场景	使用方式	说明
正文中嵌入表格	\begin{表格}[分栏=2]	表格占据部分列，前后可以有正文
整页分栏排版	\begin{正文}[分栏=2]	整个正文区域分为左右（上下）栏

正文分栏参数

在 \begin{正文} 或 \contentSetup 中使用：

参数	简体	繁体	类型	默认值	说明
n-bands	分栏	分欄	整数	1	分栏数
band-gap	栏间距	欄間距	度量	0pt	栏间距
band-mode	栏模式	欄模式	选项	auto	栏流动模式：auto(跨页连续) per-page(逐页重复)
band-heights	栏高度	欄高度	列表	(空)	各栏高度
band-columns	栏列数	欄列數	字符串	(空)	每栏列数
column-border	列边框	列邊框	字符串	(空)	列边框
band-border	栏边框	欄邊框	字符串	(空)	栏间分隔线

\换栏 / \換欄

在正文分栏模式中，强制切换到下一个栏。

\begin{正文}[分栏=2, 栏间距=1em]
  第一栏的内容……
  \换栏
  第二栏的内容……
\end{正文}

---

👉 下一步：查看 夹注与侧批 或 文本框。