4

我想在@mainpage 部分中包含多个 .txt 文件(或 .md 文件,用 Markdown 编写)。

但是,我为这些文本文件中的每一个都获得了一个单独的章节。这怎么能预防?

4

2 回答 2

1

我在这里寻找相同问题的答案,由于似乎没有人解决它,我自己寻找解决方案。

我发现这个...

http://www.doxygen.nl/manual/preprocessing.html

用作 doxygen 输入的源文件可以由 doxygen 的内置 C 预处理器解析。默认情况下,doxygen 只进行部分预处理。

所以要拆分一个页面,例如几个文件的主页,看起来一个解决方案是完全启用markdown文件上的C预处理器,并使用

#include file1.md

#include file2.md

等以包括各种降价文件。

我们想做的是使用 Doxygen 的

\包括文件1.md

\包括文件2.md

但不幸的是,Doxygen 再次猜测我们要包含的文件是代码文件。就像 Doxygen 有一个 \htmlinclude 来节省你写两行

\htmlonly

\endhtmlonly

指定内容是 HTML,\include 命令实际上是一种 \codeinclude,以节省您指定包含的内容是软件的时间。

我个人更喜欢键入额外的两行来指定我包含的文件的性质:代码、HTML、markdown 或其他任何内容,并有一个通用的包含命令。但是他们说永远不要把礼物马放在嘴里,这基本上意味着你不能与自由软件争论!

于 2014-07-10T14:53:50.950 回答
0

你可以这样做:

@mainpage
This is your live and it isn't getting any better then this! This is your life and it's ending one minute at a time!
<a href="/mnt/home/USER/vis/Doxyfile">Doxyfile</a> @n
<a href="/mnt/home/USER/vis/DoxygenLayout.xml">DoxygenLayout.xml</a><br>

在每个引用后放一个@n, \n, <br>,以换行,否则所有内容都将放在一行中。


您还可以定义一个组,将其他引用添加到该组:
@mainpage
@ref test

首先,你把@ref标签放到你的主页上。然后你定义一个组,例如

@defgroup test
@{
<a href="/mnt/home/USER/vis/Doxyfile">Doxyfile</a>
@}

现在您开始将来自其他文件的链接添加到该组:

@addtogroup
<a href="/mnt/home/USER/GROUP/Doxyfile">AnotherDoxyfile</a>

但是,这只会在您的主页中显示组名称,而不是所有文件。


我假设您想要的是在文件中放置一个锚点:

@anchor ANCHORTEST
@{
<a href="/mnt/home/stud-dral1012/vis/Doxyfile">TESTFILE</a>
@}

然后将该锚点放在您的主页中:

@mainpage
@ref ANCHORTEST @n

于 2013-06-28T16:12:18.550 回答