Repository navigation
Version Compatibility
本 Wiki 当前适用 v1.1.0，源码日期 2026-10-25。对应 GitHub 标签 和 Release 附件。旧 v0.0.4 指南保留在 Wiki 的 Git 历史中。
| 项目 | 要求与范围 |
|---|---|
| LaTeX | 2025-11-01 或更新 |
| expl3 | 2025-12-29 或更新 |
| PGF/TikZ | 3.1.11a 或更新；默认及已提供渲染器 |
| 引擎 | pdfLaTeX、XeLaTeX、LuaLaTeX |
| 可选 siunitx | v3，使用相应格式化器时显式加载 |
| 可选 tabularray | 2025C（2025-11-27）或更新 |
| 运行模块 | 全部 22 个匹配版本的 .sty，包括可选适配器 |
中文手册使用 XeLaTeX；宏包自身不自动加载 ctex 或 fontspec。运行文档无需开启 shell escape。
默认五库为 stack、spark、heat、csv、table。core 始终可用。distribution、legend、reports 需在导言区显式加载。tabularray 需额外 \UseTblrLibrary{gradbars}，宏包不会自动加载 tabularray。
v1.1.0 提供 CSV 原生绑定与选择、自动/命名共享尺度、Heat 发散色阶、柱形/win-loss 趋势、汇总，以及箱线图、共享图例、领域报告与扩展接口。旧版参数范围不能直接套用到新例子。
数字输入支持十进制与 e/E 科学计数，非零数量级受限于 1e-100 至 1e100；公式、NaN、无穷大和本地化分隔符不属于数字输入。显示精度不等于计算精度，内部数值精度仍有限。
v1 公开接口的兼容和弃用规则见稳定接口契约。升级时更新完整模块集合，并保留可编译的旧例验证行为。
已验证环境为 TeX Live 2026、LaTeX 2026-06-01、expl3 2026-09-09、tagpdf 1.0h（2026-10-08）和 tabularray 2025C。它是实际验证环境，不意味着所有较旧组合都支持相同标记行为。
- 普通文档不自动启用 tagging；图形描述依赖
\DocumentMetadata。 - 完整 tabularray 表结构需显式设置；短表在三个引擎验证。
- 重复 tagged longtblr 表头需 LuaLaTeX，默认重复副本为 artifact；可显式选择逐页描述。
- 跨页合并单元格、嵌套 tagged 表格和特定屏幕阅读器行为不在认证范围；完整 PDF/UA 需另行验证。
后端 schema 1 当前覆盖 bar/Heat 标量，默认仍为 TikZ。扩展接口
适用版本：gradbars v1.1.0（2026-10-25）。完整参数以该版本手册为准；GitHub 发布与 CTAN 提交分别进行。维护：SuFan / Tape5try。