私は自分のアプリケーションのモジュールの概要ドキュメントを書いています。私は主に\page
、、、\subpage
および\section
タグ\subsection
を使用します。
\page
andタグを使用すると、ドキュメントに優れた階層構造を与えることができます。\subpage
これは、Webページのヘッダーで明確に視覚化されるか、QHelpGeneratorを使用してQtヘルプに変換されるときに目次を作成するために使用されます。したがって、ページには一意の名前を付ける必要があることを理解しています。
ページ内のセクションに「概要」、「はじめに」、「セクション1」、「セクション2」などの名前を付けると、ドキュメントのサブセットを作成するときに正しく機能するようです。セクション名は一意である必要はないようです。
しかし、より大きなドキュメントファイルのセットを作成すると、一部のページが正しく作成されなくなります。これは、グローバルに一意ではないセクション名が原因である可能性がありますか?
セクション名のグローバルな一意性に関する情報を見つけようとしましたが、セクション名の一意性に関するステートメントが見つかりません。それらはグローバルに一意である必要がありますか?
編集: 1つのファイルにID XとタイトルAのセクションがあり、別のファイルにID XとタイトルBのセクションがある場合、生成されたドキュメント(AまたはB)で両方が同じタイトルを取得することに気付きました。したがって、これはIDがグローバルに一意である必要があることを示しているようです。これを回避する方法はありますか?