l3doc 文件 / .dtx 文件的进程索引

l3doc 文件 / .dtx 文件的进程索引

我理解.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

相关内容