出力をより詳細に制御するために、Django (私は Sphinx から来ました) を使用していくつかのドキュメントを管理します。ドキュメントは git アーカイブの rst (再構成されたテキスト) にあり、フィルターを使用して HTML で表示するのは簡単です。私の問題は、それらが非常に長いことであり、ページネーションがどのように行われるかをより詳細に制御したいので、HTML ページごとに 1 つのセクションを表示したり、1 つのセクションにコメントを付けたりすることができます...
私の目標は、各ドキュメントを解析し、別の HMTL ページの各セクションへのリンクを含む TOC を作成できるようにすることです。ここで、ビューはドキュメント全体を通過して、HTML でセクションのみをレンダリングします。
それは主に docutils の問題であることを理解しています。私が見つけた最も興味深い例はhttp://www.ibm.com/developerworks/library/x-matters24/#code2ですが、時代遅れのようです「ツリー指向処理」のセクションでは、魔法がどこにあるのか、私のバージョンの docutils では機能しないようです。記事は良いです: 私は同じ主題をもっと使うことができました!
私がやろうとしていることと似たようなもので、すでに研究できるものはありますか、それとも、最初のドキュメントを解析するための docutils の穏やかな紹介を誰かに教えてもらえますか?