11. 索引

<!entity % index "idx|cdx|nidx|ncdx" >

<!element idx - - (#pcdata)>
<!element cdx - - (#pcdata)>
<!element nidx - - (#pcdata)>
<!element ncdx - - (#pcdata)>

索引标签用于为你的文档创建索引。 只有当你想要进行 LaTeX 映射时，它们才有用。 正如表 索引元素 中提到的那样，它们只有非常细微的区别。

11.1 包含索引

有两种方法可以将索引包含到您的文档中。 请查看两者并做出决定。

手动

1. 将文档类的 opts 属性设置为包含 makeidx 包。 您可以通过以下方式进行操作： <article opts="makeidx">。
2. 使用 idx 标签 或 cdx 标签 标记所有您希望稍后出现在索引中的单词。 如果您要索引到文档中某个位置的单词不在文本中，您只需使用 nidx 标签 将其写在您要索引的位置。 它就像普通的 idx 一样，只是标记的文本将在普通文档中被静默删除。
3. 使用 makeindex 处理您的文件 sgml2latex -m mydocument.sgml。
   这将生成一个额外的 mydocument.idx 文件。
4. 使用 makeindex 命令处理 mydocument.idx，例如 makeindex mydocument.idx。
   这将生成一个额外的 mydocument.ind 文件。
5. 要将现在生成的索引包含在您的文档中，请使用 sgml2latex -o tex -m mydocument.sgml 处理您的文档。
   这将输出 mydocument.tex 文件。
6. 使用您选择的编辑器编辑 mydocument.tex。
   您查找 \end{document} 行（应该在文件末尾附近），并在该行之前插入文本 \printindex。
7. 使用 latex mydocument.tex 处理修改后的文件。
   这将为您提供最终的 mydocument.dvi 文件，您可以再次使用 dvips 处理它以生成 postscript 文档。

黑客方式

我目前正在开发一个 sgmltools 的补丁，以自动执行索引的包含和生成。 要了解当前状态，请访问 http://www.bnhof.de/~uwe/lnd/indexpatch/index.html。