search

CTeX-org / ctex-kit

Macro Packages and Scripts for Chinese TeX users
980 stars 124 forks source link

测试 ctxdoc 文档类 #704

Open muzimuzhi opened 6 months ago

muzimuzhi commented 6 months ago

因为基于实验性的 l3doc 文档类，而且在实现时 patch 了不少命令，来自上游（如 l3kernel 和 l3doc）的修改很容易影响 ctxdoc 的可用性。

虽然 ctxdoc 宣称自己是仅 ctex-kit 内部使用的，挡不住它已被一些第三方项目已经用它排版项目文档。

两个选择：

muzimuzhi commented 6 months ago

两个选择：

  • 为 ctxdoc 文档类添加几个测试
  • 把编译 ctex 文档纳入 CI

后者更有意义，但不能完全替代前者。（编译不报错，不意味着排版结果符合预期。）

我还想让 ctxdoc 在每次 patch 失败时抛出错误，而不是安静地往 log 写 *** FAIL ***。

https://github.com/CTeX-org/ctex-kit/blob/e612c95dad5a359dbc211f8f5b7e2ba7f51f4158/support/ctxdoc.cls#L79-L93 https://github.com/CTeX-org/ctex-kit/blob/e612c95dad5a359dbc211f8f5b7e2ba7f51f4158/support/ctxdoc.cls#L221-L227