如何在多個文件中拆分doxygen @mainpage文檔

Question

我想在@mainpage部分中包含多個.txt文件（或者用.md文件編寫的.md文件）。

但是，我爲每個這些文本文件獲得一個單獨的章節。這怎麼能防止？

Answer 1

你可以做這樣的事情：

@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>

把每個refrence後@n, \n, <br>，打破線，否則一切都將被放在同一行。

---

您也可以定義一組，其他refrences添加到該組：
@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

Answer 2

我在這裏尋找一個答案同樣的問題，因爲沒有一個似乎已經解決了這個問題，我已經找了自己的解決方案。

我發現這...這是用作輸入到doxygen的

http://www.stack.nl/~dimitri/doxygen/manual/preprocessing.html

源文件可以通過解析 的doxygen的內置C-預處理。默認情況下，doxygen只執行 部分預處理。

因此，爲了分割頁面，例如，在多個文件中的主網頁，它看起來像一個解決方案是完全啓用的降價文件的C preprocesor，並使用

的#include file1.md

的#include file2.md

等包括各種減價文件。

我們希望做的是使用的Doxygen的

\包括file1.md

\包括file2.md

可惜的Doxygen已經第二猜到這些文件我們想要包含代碼文件。 以同樣的方式，使用Doxygen有\ htmlinclude來拯救你寫兩行

\ htmlonly

\ endhtmlonly

指定內容是HTML的\ include命令是真的一種\ codeinclude來保存你指定包含的內容是軟件。

我個人更喜歡輸入額外的兩行來指定我包含的文件的性質：代碼，HTML，markdown或其他，並且有一個通用的include命令。但他們說，從來沒有看到一個禮物馬在嘴裏，這基本上意味着你不能爭取自由軟件！