平均能量损失

Question

使用ltxdoc文档类时，索引条目格式错误，如下所示：

foomacro= \subitem *+\foomacro+, \usage{1}

而不是...不管它们看起来应该是什么样的。

这听起来像是一个奇怪的系统相关的事情，所以这是我的分发信息：

• ltxdoc.cls版本2018/03/15 v2.0x
• ltxbase包裹（包括ltxdoc.cls） 包装好 2018-05-29
• 截至 2018-10-25 的最新软件包
• MiKTeX 2.9.6840 64 位
• Windows 10

---

平均能量损失

\documentclass{ltxdoc}
\PageIndex
\begin{document}
\DescribeMacro{foomacro}
Some description here\dots
\PrintIndex
\end{document}

生成的文件

bad-index.idx：

\indexentry{foomacro=\verb!*+\foomacro+|usage}{1}

bad-index.ilg：

This is makeindex, version 2.15 [MiKTeX 2.9.6800 64-bit] (kpathsea + Thai support).
Scanning input file extra\bad-index.idx....done (1 entries accepted, 0 rejected).
Sorting entries...done (0 comparisons).
Generating output file extra\bad-index.ind....done (6 lines written, 0 warnings).
Output written in extra\bad-index.ind.
Transcript written in extra\bad-index.ilg.

bad-index.ind：

\begin{theindex}

  \item foomacro=\verb
    \subitem *+\foomacro+, \usage{1}

\end{theindex}

截屏：

Answer 1

对于 doc-package 或 ltxdoc-class 之类的东西，你需要调用制作索引-程序

• 使用样式文件gind.ist创建索引，
• 使用样式文件gglo.ist用于创建变更历史。

即，如果将以下内容保存为测试.tex：

\documentclass{ltxdoc}
\PageIndex
\begin{document}
\DescribeMacro{foomacro}
Some description here\dots
\PrintIndex
\end{document}

，然后创建索引，您需要调用制作索引如下：

makeindex -s gind.ist -o test.ind test.idx

，并创建您需要调用的变更历史记录制作索引如下：

makeindex -s gglo.ist -o test.gls test.glo

所以整个命令序列如下所示：

pdflatex test.tex
makeindex -s gind.ist -o test.ind test.idx
makeindex -s gglo.ist -o test.gls test.glo

（重复此命令序列，直到所有引用等都正确匹配，并且 .log 文件测试日志不再包含有关需要再次运行 LaTeX 的警告。）