Python プロジェクトの Doxygne ドキュメントを作成しました。高レベルのクラス アーキテクチャを使用してプロジェクトに関する高レベルの紹介を追加するために、次の形式の mainpage.dox ファイルを作成しました。
/* \mainpage
# Introduction
Description about the project
# Class Architecture
CLass architecture using plantuml.
# Additional Links
\ref addLinks "Additional Links Name"
\page addLinks
# Link information
*/
上記のすべてのコンテンツを 1 つの mainpage.dox に含めると、長すぎて読みにくくなるという問題があります。
実際には、すべてを個別の追加の dox ファイルに分割し、それを mainpage.dox ファイルからリンクしたいと考えています。例えば：
紹介用に別の .dox ファイルを作成する
クラス アーキテクチャ用に別の .dox ファイルを作成する
そして、これらのリンクされたファイルを追加すると、以下のように mainpage.dox ファイルのコンテンツが表示されます。
/*! \mainpage
# Introduction
\include introduction.dox
# Architecture
\include architecture.dox
*/
Introduction.dox ファイルの内容: ここにはコメントを追加していません。
Introduction
===========
This is an introduction about this project.
残念ながら、上記のように .dox ファイルを追加しても、情報はテキスト形式でしか追加されません。Doxygen 形式でコンテンツを表示しません。\include Introduction.dox と \include { Introduction.dox} と \includedoc Introduction.dox も試しました。
Doxygen 1.8.17 を使用しています。何が原因でしょうか？
どうもありがとう！！