PDF および HTML ヘルプ生成をサポートしているため、現在、ソフトウェア プロジェクトの文書化にAsciiDocを使用しています。現在、 a2x ツールチェーンが適切に機能するように、Cygwin で実行しています。これは私にとってはうまくいきますが、他の Windows コンピューターでセットアップするのは面倒です。私は別の方法を探していて、最近 Sphinx を再訪しました。HTML ヘルプ ファイルが生成されるようになったので、試してみましたが、実行した小規模なテストではうまく機能するようです。
私の質問は、Windows プログラムが適切なヘルプ API を呼び出すことができ、ファイルが起動され、目的の場所に開かれるように、コンテキスト依存ヘルプのマップ ID をテキストで指定する方法はありますか?
AsciiDoc では を使用してpass::[<?dbhh topicname="_about" topicid="801"?>]います。これらの構造を使用することにより、context.hおよびが他の HTML ヘルプ ファイル (状況依存のヘルプ情報alias.h)と共に生成されます。