記事"MQL5ソースコードに基づくドキュメントの作成"についてのディスカッション

 

新しい記事 MQL5ソースコードに基づくドキュメントの作成 はパブリッシュされました:

本稿では、必要なタグの自動マークアップから始まるMQL5コードのドキュメントの作成について考察し、Doxygenソフトウェアの使い方と正しい設定の仕方、html、HtmlHelp、PDFなどのさまざまな形式で結果を受け取る方法についても説明します。

したがって、最初に行う必要があるのは、プログラム構成の記述を更新することです。doxywizard.exeを起動して、プロジェクトの名前と入出力フォルダを指定して、Wizard(ウィザード)タブのMode(モード)セクションの "Optimize for C++ output"(C++の出力に最適化)オプションがチェックされていることを確認します。

Expert (エキスパート)タブを開き、必要な拡張子を持ったファイルを Input (インプット)セクションに追加します。

作者: Andrei Novichkov

 

記事についてではなく、Doxygenについて質問です。バージョン1.8.13を使用されているとのことですが、私も使用しています。どういうわけか、私が入手したhtmlヘルプでは、すべての「ディレクトリ・リファレンス」パススルー・ページが、その中に含まれるサブフォルダを表示していません。例えば、MQL4というフォルダがあり、IncludeとScriptsというサブフォルダがあります。ドキュメント・メニューのファイル一覧の項目をクリックすると、フォルダとファイルのある通常のツリーが表示されます。例えば、インクルード・フォルダーをクリックすると、すべてのファイルを含む「インクルード・ディレクトリ・リファレンス」ページが表示されます。しかし、上位のMQL4をクリックすると、「MQL4 Directory Reference」というページが表示され、Directoriesという小見出しがありますが、その下にはインクルードもスクリプトもありません。あなたのドキュメントを含む他のドキュメントにはこの問題はありません。何が問題なのでしょうか?

INPUTをいろいろな方法で埋めてみたり、設定ミスの第一候補だと思い、RECURSIVEを変えてみたりしたのですが、何の解決にもなりません - ドキュメントは、この厄介なニュアンスを除けば、いつも正常に作成されています。

 
Stanislav Korotky:

コンフィグのINPUTをいろいろな方法で埋めてみたり、不正確なコンフィグの第一候補だと思い、RECURSIVEを変えてみたりしましたが、何も役に立ちませんでした - ドキュメントは、この厄介なニュアンスを除けば、常にすべて正常に作成されています。

あなたの設定を参考にしました。私のソースでは、記述された問題なくヘルプが作成されました。今、私はあちこちの12個のオプションを比較しなければならない;-/。

 
Stanislav Korotky:

あなたの設定を参考にしました。私のソースでは、記述された問題なくヘルプが生成されました。今、私はあちこちの12個のオプションを比較しなければならない。

念のため、結果を書いておく-誰かの役に立つかもしれない。EXTRACT_ALLが影響していることがわかった。NOだとフォルダは表示されないが、YESだと表示される。IMHO、ジェネレーターのバグ。

 

こんにちは。

返信が遅すぎたかもしれません ))))))DoxygenのGUIに「サブディレクトリを含む」にチェックを入れるオプションがあったと記憶しています。それがどこにあるかはもうよく覚えていませんが、見つけることは可能です。