如何在Doxygen评论中直接包含LaTeX片段？

Question

我希望能够通过一些合适的编辑器在外部编辑一些Doxygen注释的LaTeX部分.我只会在复杂的环境中使用它.为此,我想我可以使用仅限LaTeX的文件,并将它们包含在Doxygen中.我没有创建Doxygen的别名\begin,并\end进行语法兼容.

(例如,我知道如何设置Emacs/AUCTex以使用没有前导码和文档结构的LaTeX片段.)

有没有办法在Doxygen评论中包含.tex文件的内容？我寻找类似的东西\htmlinclude,但对于TeX文件.考虑到我对只有TeX外部源的要求,有没有办法模拟功能？

Answer 1

你尝试过\verbinclude命令吗？此命令逐字包含文档中的任何文件（与\include用于包含源文件的 相比）。

来自 doxygen 手册：

\verbinclude <file-name>

<file-name>此命令在文档中逐字包含该文件。该命令相当于将文件粘贴到文档中并在其周围放置\verbatim和\endverbatim命令。

doxygen 应该查找的文件或目录可以使用EXAMPLE_PATHdoxygen 配置文件的标签来指定。

编辑：我只是想到您可能希望在将文件的其余部分包含在文档中之前从 .tex 文件中删除前导码。您可以使用该\dontinclude命令来执行此操作，该命令与\line、\skip、\skipline和\until命令一起允许您包含特定文件的特定行/块。\dontinclude 请参阅文档中的示例。