我理解.dtx
文件是一种在一个文件中记录和实现包的方式。
此外,在较新的版本中,通常pdflatex package.dtx
应该排版文档。
我想尝试一些示例来检查此类.dtx
文件,但我无法对LaTeX3
内核文件正确执行此操作。
尤其是l3prop.dtx
从
https://github.com/latex3/latex3/blob/195f85d5c8df68ca32ac0c7d5559efa27f0fa63d/l3kernel/l3prop.dtx
并运行pdflatex
它会产生缺少索引的文档。因此,在makeindex l3prop.idx
照常运行生成的辅助文件并pdflatex l3prop.dtx
再次运行后,我得到了错误
LaTeX Error: Text for \verb command ended by end of line.
See the LaTeX manual or LaTeX Companion for explanation.
Type H <return> for immediate help.
...
l.4 \subitem \verb*&
?
而实际上相应的内容l3prop.ind
包含此代码并且似乎不正确(事实上我无法在其中找到命令中的终止* \verb*
)。
latexmk l3prop.dtx
似乎也不起作用,它遇到了同样的错误。
我也制作了一个示例.tex
文档,其中只包含一个最小的l3doc
类作为.tex
文件,这里排版索引也\PrintIndex
同样出错了,所以似乎与类有关l3doc
。
所以我的问题是如何处理这个.dtx
文件 - 或者更一般的文档l3doc
以正确排版索引。
我认为这只是调用我不知道的正确的索引生成程序/脚本等的问题。
答案1
每当写入文档ltxdoc
或新建l3doc
索引时,都需要驱动程序/配置。如果我们查看手册,我们会看到以下是此类文档的ltxdoc
正常建议调用:makeindex
makeindex -s gind.ist file.idx