在Doxygen中,您可以使用參考鏈接:分別定義它們,然後從文本中引用它們。Doxygen全局定義參考鏈接
/**
* This is a documentation. Here I link [std::string] to an external web page.
*
* The next line is the link definition:
*
* [std::string]: http://en.cppreference.com/w/cpp/string/basic_string "std::string documentation"
*/
但是,似乎鏈接定義只能在文檔塊中看到。甚至在同一頁上的其他文檔塊上也看不到它。
我想定義一些鏈接一次,然後到處使用它們(在不同的頁面上)。
這可能嗎?
編輯(後續問題)
爲了實現自己的目標,我認爲最好的辦法就是讓使用別名設施。
我已成功地與這樣的別名設置它:
ALIASES += std_string="<a href=\"http://en.cppreference.com/w/cpp/string/basic_string\" title=\"std::string documentation\" target=\"_blank\">std::string</a> "
ALIASES += std_vector="<a href=\"http://en.cppreference.com/w/cpp/container/vector\" title=\"std::vector documentation\" target=\"_blank\">std::vector</a> "
,並用它:
@std_string
@std_vector
基本上我對每一個環節一個別名。
它可以通過一個具有參數的別名來實現嗎?使用將是:
@std_ref std::string
@std_ref std::vector
的問題是,需要在名稱(參數)與線路之間的某種映射:
std::string -> http://en.cppreference.com/w/cpp/string/basic_string
std::vector -> http://en.cppreference.com/w/cpp/container/vector
我知道這是可以做到,如果一個參數會該鏈路的不同部分,如:
@std_ref std::string string/basic_string
@std_ref std::vector container/vector
但這是醜陋的,容易出錯,需要每次連接應該是什麼檢查。
謝謝。這工作。我有一個問題,就是每個鏈接只能使用一個別名而不是一個別名。如果您想檢查我的問題編輯,我將不勝感激。 – bolov
我從來沒有必要使用別名和參數的混合,所以你超出了我的經驗。對不起,我們已經到了你的猜測和我的一樣好的階段:) – Cheeseminer
沒關係,你的答案解決了我的問題,我只想更進一步。 – bolov