問題タブ [docutils]

参照: http://diveintopython.net/native_data_types/lists.html#d0e5623

で生成されたコード例を含む Web サイトを持っていますがdocutils、CSS は常に正しくありません。

あるなら知りたい

• コードを表示するための CSS のベスト プラクティス (つまり、折り返し、長い行、色付けの可能性を処理できるか)

• 小さな数値コールアウトのベスト プラクティス (上記の dieintopython を参照)

そして最後に、docutils HTML 出力で動作し、実際に「見栄えがする」ように設計された (オープンな) CSS があるかどうか疑問に思っています。テーブルを「マイクロソフト プロフェッショナル グレー」などに見せる CSS を提供できれば幸いです。

Windows 7 で django の docutils を有効にしようとしています。urls.y と settings.py のリンクを有効にし、docutils の最新のスナップショットをダウンロードしてインストールしました。ただし、管理者のドキュメント リンクにアクセスしようとするたびに、docutils のインストールを求めるページが表示されます。

何か案は？

ありがとう

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

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

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

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

私はクラスにメソッドを書いていますが、プロジェクトを国際化するのが好きです。今、私は本当に多言語システムを開発しています。ドキュメントを翻訳したい。
メソッドの定義後に改行を変換する方法については、djangoのドキュメントには何もありません。
私は書いてみます：

ただし、admin-docでは効果がありません。

さらに処理とチェックを行うために、Pythonで最初にsphinxベースを解析できるようにしたいと思います。何かのようなもの：

docutils.core.publish_fileを使用してdocutilsで何かが可能であるようです：

しかし、それはスフィンクス固有のディレクティブなどについては何も知りません...

reStructuredText のドキュメントがいくつかあります。そのスニペットをオンライン ヘルプで使用したいと考えています。1つのアプローチは、参照によってマークアップの一部を「切り取る」ことのようです。

python/docutils/sphinx を使用して _my_interesting_section マーカーのマークアップを抽出するにはどうすればよいですか?

多くのテーブルを含むドキュメントを作成しています。しかし、テキストでそれらを参照する方法を知る唯一の方法は、a:ref:'my_table'を使用することです。これにより、テーブル名全体「テーブルの長いタイトル」がテキストブロックに配置されます。代わりに「表1.3」に入れてもらいたいのですが…可能ですか？

別の、しかしテーブルに関連する質問：テーブル名/キャプションを上部ではなく下部に配置するためのsphinx / docutilsオプションはありますか、それともスタイルシート/ラテックスのものですか？

Pythonスクリプト内のラテックスから作成されたpdf出力を生成したい。私はpython xyを使用してWindowsで作業しており、ラテックスをインストールできないため、pythonxy（sphinxやdocutilsなど）のパッケージを使用してラテックス出力を生成する方法があるかどうかを知りたいです。

簡単なreSTスニペットは次のとおりです。

レンダリングされたデモを次に示します。

最初の行あり：http
：//rst.ninjs.org/？n = ff67380d732a33c7844f350c240804d0 最初の行なし：http： //rst.ninjs.org/？n = 550ea2c1b4233affdce1d158c5dc4d99

次のPythonを使用してreSTをレンダリングしています。

<h2>最初の行なしで小見出し（具体的にはタグ）を取得するにはどうすればよいですか？小見出しの上に2つのレベルの階層を提供していますか？ページヘッダーを単純に提供しても役に立ちません：http：//rst.ninjs.org/？n = e874f6eaad17c8ae7fd565f9ecb2212b

reStructuredText の太字のテキストにリンクを挿入しようとしましたが、失敗しました。

これは私の最初のソースです：

しかし、私は得ました：

私はこれを取得したい: