問題タブ [restructuredtext]

私は自分のプロジェクトのドキュメントをSphinxを使用して編集しています。これはreStructuredTextをマークアップ言語として使用します。

一番右の列レポートに右揃えにしたい数値が含まれている単純なテーブル( grid tableとは対照的に) がありますが、それを達成する方法が見つかりませんでした。

これで問題が解決できるのであれば、喜んでグリッド テーブルに切り替えます。

概念的にはrestructuredtextに沿って、さまざまなソース ディレクトリ全体に readme ファイルを配布し、Doxygenにそれらの readme テキスト ファイルを読み取らせて、生成された Doxygen 出力の一部として含めたいと考えています。

これはどのように行われますか？または、次のような疑似 C ファイルを作成して Doxygen を偽装する必要がありますか?

README.h:

LaTeX 変数を reStructuredText に埋め込もうとしています。「.. raw::」ディレクティブについては知っていますが、これをテキストの段落に埋め込みたいと考えています。具体的には、\numquestions\ 変数と \numpoints\ 変数をテンプレートの試験ドキュメントから複製しようとしています。:raw: を使用してみ\numquestions\ましたが、これは有効ではないようです。これを行う方法はありますか？

APIドキュメントとその独自のドキュメントジェネレータスキーマをreStructuredTextに移行しようとしています。最も苦労するのは、APIの詳細を表形式で表現したもので、HTMLで直接コーディングされています。

（つまり、これは現在、としてコード化されています<tr><td class='param'>id</td><td class='required'>Yes</td>...）

これをRSTで実行したいのですが、RSTテーブル形式を使用するだけでなく、セマンティックに実行します。しかし、これを私が望む方法で処理するためのカスタムディレクティブの良い例を見つけることができません。

reStructuredTextでこれをどのように達成できますか？

Djangoには、再構築されたテキストを処理できるテンプレートフィルターが組み込まれています。sphinx（ドキュメントジェネレータ）がラテックスコードを処理するのと同じ方法で、これを使用してラテックスコードを処理することは可能ですか？

どちらがpng画像に変換されますか？

自分のdjangoで使用するラテックスコードを処理するための独自の最初のプロセッサを作成できることはわかっていますが、これはすでに行われているのではないかと思いました。

提案やアドバイスをありがとう-m

コンテンツを取得し、PIL を使用してそのコンテンツに基づいて画像を作成し、生成された画像をドキュメントに表示する reStructuredText ディレクティブを作成しようとしています。これまでに行ったことは、image ディレクティブをサブクラス化し、特定のパス (images/diagram.png など) にファイルを作成してから、images/diagram.png を image ディレクティブに渡すことです。これに関する問題は、ファイルが ./images/ に保存されるのに、生成された html ドキュメントが {output_dir}/static/images/ で検索することです。

私の質問は、出力を保存するために reST が使用しているディレクトリの値にどのようにアクセスすればよいのでしょうか?

vimで最初のファイルの概要を表示する方法はありますか？それは私がより速くセクションにジャンプすることを可能にするかもしれません。

nerdtreeのような機能を提供してほしい。別のウィンドウに表示することをお勧めします。

または、RSTファイルを折りたたむ方法があれば？

私はsphinxを使用してhtmlページを自動生成しています。目次は非常に長いので、JavaScriptライブラリを使用できるように（とりわけ）新しいhtmlクラスをtoctreeのdivに追加しようとしています。基本的に、toctreeがHTMLを生成する方法を変更したいと考えています。

globaltoc.htmlファイルを見つけ、それを_templatesフォルダーに配置し、conf.pyのtemplate_pathのコメントを解除しました。

これは、_templatesディレクトリ内のファイルです。

私がこれを完全に間違って行っている場合は、これを行う別の方法を教えてください。純粋なreSTでこれを実行できるようにしたいのですが、不可能のようです。Sphinxテンプレートの限られた例を見てきましたが、これが私が見つけることができるすべてです。

これの全体的な目標は、非常に大きなツリーで使用するためにdhtmlxTreeを使用することです。必要な.jsファイルと.cssファイルをlayout.htmlに追加しました。必要なクラスを作成するには、 toctreeを含むdivが必要です。手動で編集することで必要な結果を得ることができます。今度は自動化する必要があります。

ご協力いただきありがとうございます。

Sphinx で、次の見出し宣言があるとします。

次のようにレンダリングします。

    this is code、 これではありません！

これは良いことですが、参照を使用すると、たとえば次のようになります。

コードのフォーマットが失われ、次のようにレンダリングされます。

これはコードですが    、そうではありません。

それ以外の：

    を見てくださいthis is code、これは違います!

参照でコードの書式を保持することは可能ですか? そして、どうすればいいでしょうか？

生成されたドキュメントに適切に表示されるように、Sphinx/reST に xml を追加する推奨される方法は何ですか。