問題タブ [docutils]

以下を達成する方法はありますか？

• ソースは、.rst複数の言語の翻訳が共存する単一のファイルです
• 言語ごとに (.htmlできればファイルで) Web ページのレンディションを生成します。
  • これは、読者が言語を切り替えることができる単一のファイル、または複数の個別の .html ファイルのいずれかです。
• できれば Web ページの生成は で行うことができますrst2htmlが、他の一般的なツールも歓迎されます

私が念頭に置いているユースケース。でfoo.rst（これらのようなタグが正確に欲しいという意味ではありません）：

結果は、前述したように、単一foo.htmlの 、または と のセットのいずれかにfoo_en.htmlなりfoo_de.htmlます。

reStructuredTextrstページ形式でペリカンを使い始めています。data-default-tpl="basename"ネストされたコンテンツのような div 属性で制御したいカスタム JavaScript (jQuery) があります。

何を拡張し、何を拡張するか。Directivesとを見てきましたがnodes、その方法について頭を悩ませることはできません。

ペリカンで最初からhtmlへ。

raw:: latex コマンドを使用して、sphinx 内に eps 画像を追加したいと思います。私は次のようなものを想像します：

sphinx-build コマンドの実行は完全に機能しますが、奇妙なことに ..raw:: latex ブロック内のすべてが html ファイルで無視されます。私は何を取りこぼしたか？

docutils.conf ファイルで raw コマンドを有効にする必要がありますか? /etc でそのファイルが見つかりませんでした。

私はutil（cmake、実際には）tarをダウンロードしました.docはblowのような構造の.rstファイルとして書かれていました。それを行う方法が見つかりませんか?教えてください、それを行う簡単なコマンドはありますか?どのように?

//doc ファイルの構造 (ubuntu で ls -l によって生成)

中にフィギュアを入れたテーブルを作ろうとしています。Docutils または他のマークアップ言語でそれを行う可能性があるかどうかを尋ねています。私はこの種のテーブルを試していました:

+-----------------+--------+--------------------------------------------+ | Prova | Prova | Cella Molto lunga | +-----------------+--------+--------------------------------------------+ | Visualizzazione | Figura | .. figure:: ~/Dropbox/rst/Pics/plantum.png | | | | :alt: Prova | +-----------------+--------+--------------------------------------------+
結果は

Numpy プロジェクトは、読みやすさと自動抽出をサポートするために、ドキュメントのフォーマットの仕様を提供しています (リンク)。また、いくつかの追加キーワードの抽出をサポートするために、Sphinx の拡張機能としてNumpydocも提供しています。

docutils の拡張機能を書き始める前に、既存の docstring をイントロスペクトし、Numpy 標準への非準拠を特定するのに役立つライブラリが存在しますか?

Numpy ドキュメンテーション仕様を採用したい広範なドキュメンテーションを備えた、より成熟したライブラリをイメージします。1 つのアプローチは、ライブラリをイントロスペクトし、ドキュメント文字列の状態を説明するレポートを生成することです。

これは、docutils または numpydoc の拡張としてこれを実装する前の偵察用の質問です。既存のソリューションを見逃していませんか、それとも洗練されたソリューションは存在しますか?

再構成されたテキスト文字列のコード ディレクティブからソース コードを逐語的に抽出したいと思います。

以下はこれを行うための私の最初の試みですが、より良い (つまり、より堅牢な、より一般的な、またはより直接的な) 方法があるかどうかを知りたいです。

Pythonで次の最初のテキストを文字列として持っているとしましょう：

2 つのコード ブロックを取得するには、次のようにします。

source_codeは、2 つのコード ブロックからの逐語的なソース コードのみを含むリストです。必要に応じて、 childのattributes属性を使用してコードの種類を調べることもできます。

それは仕事をしますが、より良い方法はありますか？

私はフィルター設計 GUI を設計しており、HTML 形式を必要とする QTextBrowser で Python の scipy.signal からのドキュメント文字列を表示したいと考えています。私はdocutilsが私のために仕事をするべきだと思うので、私は試しました

ここで、txtFiltInfoBox は QTextBrowser インスタンスです。ただし、publish_string は、docstring で検出された最初の見出し (「パラメーター」) でチョークします。

その理由は、メソッドの docstring 全体がインデントされており、reST マークアップが無効になっているためだと思います。docstring をデデントしたり、publish_string に特定の数の先頭の空白を無視するように指示したりする簡単な方法はありますか?

完全なコードはpyFDA projectにあります。