使用xelatex编译jiazhu.dtx出现未定义控制序列

1 个回答

Sagittarius Rover 5天前

我要成为Typst糕手/(ㄒoㄒ)/~~

提供在网上可以公开获得的代码时最好应该贴代码链接而不是直接上传文件，所以相比于直接上传jiazhu.dtx，更好的办法是贴这个官方链接。

参考muzimuzhi在这个链接中提供的方法，需要使用如下的方法编译：

先使用xetex jiazhu.dtx释放jiazhu.sty以及jiazhu.ins等文件
再使用xelatex jiazhu.dtx在当前目录下已有jiazhu.sty的前提下可以获得jiazhu.pdf的帮助文档

TL;DR.(太长不看)

只需要使用release的ctex-kit中最新版本（截至2025-03-03，只要在2024-03-19之后即可）的ctxdoc.cls即可顺利编译jiazhu.dtx。为避免版本困惑，这里贴一个截至2025-03-03（其实是2024-03-19）开发版本的ctxdoc.cls。ctxdoc.cls

原因介绍(Edited 2025-03-03)

一个简略的说明：2023年10月份JosephWright将l3kernel中部分命令的x-type替换为e-type展开这一软性更新，直接影响了作为测试文档类的l3doc.cls中的部分命令，而ctxdoc.cls由于依赖了l3doc.cls文档类，而jiazhu.dtx又依赖于ctxdoc.cls。上面的上游l3doc.cls中的修改对应的ctxdoc.cls部分命令的修改已经在2023年-2024年间陆续被PR，但由于ctex发版较慢，目前CTAN上的ctxdoc.cls仍然是2022-06-05发版的v2.5ctex-kit版本，上面“对部分命令的修改已经在2023年~2024年间陆续被PR ”并未体现在用户的TeXLive中。

目前已经发现的ctxdoc.cls中的命令替换和对应的PR（都已经被merged，因此使用开发版本但未发版的ctxdoc.cls即可）：

\__codedoc_get_hyper_target:xN被替换为\__codedoc_get_hyper_target:eN 这一替换可见PR #678
\tl_replace_all:Non被替换为\tl_replace_all:NVn 这一替换可见PR #700
修改\__codedoc_macroname_prefix:o以及\__codedoc_macroname_suffix:N #2命令这一替换可见PR #703

类似的问题在这个latexstudio提问的评论区以及这个关于fduthesis的源文件编译问题还有这个易经宏包的说明文档也有提到过，最简单的办法都是是直接使用被PR后最新版(而非CTAN上最后发版的2022年的ctex-kit)的ctxdoc.cls，当然，也可以如上手动备份并修改ctxdoc.cls的部分命令。

Comment 1:

安装开发版本的 ctex-kit 也很简单，克隆仓库后到 ctex 目录下执行 l3build install，就会自动安装到用户目录的 texmf 目录，在编译时优先被调用。

atxy_blip老师在这个issues里提到的基于l3build使用开发版本的ctex-kit的方法可以直接安装到texmf路径内。当然如果保险起见，也可以手动备份或者只添加到当前目录。

Comment 2:

Release "jiazhu-beta" 包含了编译好的 jiazhu.pdf。截至 2025-03-02， jiazhu.dtx 在发这个非正式版后，只有一个重构的提交 f85a422 ，所以那份 jiazhu.pdf 够用了，jiazhu 包的使用者没有自行编译文档的必要性。想自行编译文档的，就超出了使用者范畴，可以尝试如前所述 git clone 的步骤。

muzimuzhi老师在这个issues提到的直接获得jiazhu.pdf的方法。此处顺便贴一份jiazhu.pdf的文件。jiazhu.pdf

远方不远 5天前

这家伙很懒，什么也没写！

没有贴官方链接是怕无法访问。
如您所说，修改ctxdoc.cls，再用xetex jiazhu.dtx和xelatex jiazhu.dtx，得到如下报错：

LaTeX Font Warning: Font shape `TU/FangSong(0)/m/it' undefined
(Font)              using `TU/FangSong(0)/m/n' instead on input line 174.

(./jiazhu.tmp) (./jiazhu.tmp) (./jiazhu.tmp)
[1] (./jiazhu.tmp) (./jiazhu.tmp) (./jiazhu.tmp) (./jiazhu.tmp)
[2] (./jiazhu.tmp) (./jiazhu.tmp) (./jiazhu.tmp) (./jiazhu.tmp) (./jiazhu.tmp)
(./jiazhu.tmp) (./jiazhu.tmp)
[3] (./jiazhu.tmp)
! Undefined control sequence.
<argument> ..._tl {\jiazhu:nn}\tl_replace_all:Non
                                                  \l__codedoc_tmpa_tl {\c_ca...
l.475 % \begin{macro}[int]{\jiazhu:nn}

?

Sagittarius Rover 4天前

我要成为Typst糕手/(ㄒoㄒ)/~~

@u101077 是的，这个\tl_replace_all:Non同样也属于ctxdoc.cls已修改但jiazhu.dtx未修改的内容。可以见这个issues。我也会接着探索试试...

Sagittarius Rover 4天前

我要成为Typst糕手/(ㄒoㄒ)/~~

即使如此做，将ctxdoc.cls中(最好放在当前目录)的\tl_replace_all:Non替换为\tl_replace_all:NVn也还会出现如下的问题：
(这个l3doc怎么改了这么多命令(😡😡😡)，今天有点小忙，下次接着搜搜试试...)

! Undefined control sequence.
<argument> ...ace: }\__codedoc_macroname_prefix:o 
                                                  \l__codedoc_tmpa_tl \__cod...
l.475 % \begin{macro}[int]{\jiazhu:nn}

?

Sagittarius Rover 3天前

我要成为Typst糕手/(ㄒoㄒ)/~~

关于\__codedoc_macroname_prefix:o,详见这个PR的讨论 #703

请登录后再发布评论，点击登录

追加回复

撰写答案

请登录后再发布答案，点击登录

关于作者

远方不远

这家伙很懒，什么也没写！

提问

回答

被采纳

关注TA

发私信

使用xelatex编译jiazhu.dtx出现未定义控制序列

TL;DR.(太长不看)

原因介绍(Edited 2025-03-03)

Comment 1:

Comment 2:

撰写答案

关于作者

远方不远

相关问题

热门问题

热门标签

推荐专家

使用xelatex编译jiazhu.dtx出现未定义控制序列

TL;DR.(太长不看)

原因介绍(Edited 2025-03-03)

Comment 1:

Comment 2:

撰写答案

关于作者

远方不远

相关问题

热门文章

热门问题

热门标签

等待解答

推荐专家