問題タブ [docutils]

.rstファイル内のプレースホルダーを実際の値でカスタマイズするにはどうすればよいですか？

たとえば、example.rst次の内容のファイルがあります。

次のコマンドを実行${custom_text}して、プロパティを値に置き換えたい：this is the value of custom property

.propertiesまた、ファイルを使用してテンプレートをカスタマイズすることは可能かどうか疑問に思います。たとえば、次の内容のファイルをrst2html example.rst -o example.html -p example.properties使用してコマンドを実行したいと思います。example.properties

出来ますか？reStructuredTextはテンプレート機能をまったくサポートしていますか？

編集：.propertiesコマンドラインから、または従来のファイル（Ant / Mavenビルド管理ツールで使用可能）を使用してテンプレートをカスタマイズしたいことに注意してください。

reStructuredText 構文で複数のテキスト ファイルを取り、Docutils で 1 つの LaTeX ファイルを作成する Python スクリプトを作成しています。Docutils が必要のない余分な構文を大量に作成することを除けば、すべてがうまく機能します。

たとえば、単純なサブセクションを使用すると、Docutils は次のように記述します。

私だけが必要なとき

Pandoc が追加の構文をあまり作成しないことを確認しましたが、これは CSV テーブルをサポートしていないため、自分のプロジェクトでは使用できません。

すべての docutils 設定を調べましたが、出力を制限するオプションが実際には見つかりません。必要な構文だけを作成するように Docutils を設定する方法はありますか?

ブログ/ウェブサイトにreStructuredTextを使用していて、グローバルインクルードファイルを追加したいと思います。HTML出力の生成に使用している設定ファイルにアクセスでき、変更できてうれしいです。どちらの構文も理解できません。

1. デフォルトのインクルードファイルをパーサーに追加する
2. Pythonのdocutilsを使用してPythonでdirective/inline-rolesなどを定義する

ソースコードとドキュメントを読んでみましたが、理解するのが少し難しいと思いました。非常に明白な何かを見逃したことを願っていますが、次のようなことをしたいと思います（最初の部分はすでにそこにあるものです-ファイルの残りの部分はjekyll-rstプラグインで見ることができますソース（それに直接リンク）

これを行う簡単な方法はありますか？defaults.rstファイルを定義して、毎回ロードするのは素晴らしいことです。

編集：これは私がグローバルに含めることができるようにしたいもののいくつかの例です（カスタムディレクティブもいいでしょうが、おそらくそれらをコードで書くでしょう）

私は主要なレポートを書いており、付録として含めたい 2 つの PDF ファイルがあります。レポートは ReStructuredText を使用して作成され、rst2pdf を使用して変換されます。

docutils または rst2pdf には、付録として外部ファイルの機能がありますか?

次の reST 入力があるとします。

私が最終的にやりたいのは、次のような口述です:

私はこれを使用しようとしました：

フィールドリストを解析しますが、最終的に疑似 XML がtree["whole"]?次のようになります。

treedict には他の有用な情報が含まれておらず、単なる文字列であるため、reST ドキュメントからフィールド リストを解析する方法がわかりません。どうすればいいですか？

を使用docutilsすると、reStructuredText で画像を水平方向と垂直方向の両方に配置することはできないようです。垂直方向の配置は置換に対してのみ受け入れられますが、水平方向の配置はインライン画像に対してのみ機能します。したがって、次のようになります。

と

クラッシュ。

垂直方向と水平方向の両方の配置を制御する方法はありますか?

Docutils は素晴らしいパッケージです。Django を使用している場合、admindocs パッケージには docutils が必要です。Web ブラウザーを使用してインストールするための手順が用意されていますが、リモートで SSH 経由で端末にログインしている場合はどうでしょうか。その場合の取り付け方法は？端末で仕事をするための簡単なレシピが必要な場合はどうしますか?

これ（編集済み）を見たとき、私はdocutilソースコード（Pythonにあります）を見ていました：

私が話している行はこれです：

「[:]」は正確には何をしますか? その上のコメントはある種のコピーを示唆していますが、私のグーグル検索はそれほど成功していませんでした。それが言語機能なのか、何らかのトリック/ショートカットなのかわかりません。

最初のファイルの構文を強調表示するために、docutils と pygment をインストールします。コマンドを使用して：

良い結果を得ることができます。

pycharm を使用して rst ファイルを作成すると、rst を変換するための組み込みスクリプトがあります。

ファイル「rst2smth.py」を読みました。システムにインストールされた docutils コマンド rst2html を使用しているようですが、構文ハイライト コード スニペットのない html を取得しました。簡単に説明するために、以下のスクリーンショットを撮りました: https://www.dropbox.com/s/frmf933t3kjcvum/pycharm_rst2html.png

端末で使用するコマンドと同じように、pycharm を作成して rst を html に変換する方法はありますか?

以下は、pycharm の python インタープリター設定です: https://www.dropbox.com/s/qas4352r4fmi6iq/pycharm_packages.png

多くのPythondoctestを含む大きなReStructuredTextファイルには、各doctestの前に実行したいtestsetupブロックと、一部のdoctestの前に実行したいいくつかのtestsetupブロックがあります。グループでこれを行う方法は知っていますが、testsetupブロックを実行する順序を指定する方法はありますか？

これがfoo.rstというファイルです。

実行すると、次のように表示されます。

逆の順序を強制する方法はありますか？グループ固有のセットアップの前に、最も広く適用可能なセットアップが実行されますか？