Django のマークアップ パッケージを使用して、restructuredText を html に変換しています。<p>各タグにクラス属性を追加するように HTML ライターをカスタマイズする方法はありますか?

段落ごとにクラス ディレクティブを使用することもできますが、このプロセスを自動化したいと考えています。

たとえば、次の再構成されたテキストが必要です。

このhtmlに変換します。

クラスを挿入したい理由は、「ハイフネーション」クラスを持つすべてのタグにハイフンを追加することで機能するハイフネータ ライブラリを使用しているためです。ハイフネート クラスをコンテナ タグに追加することもできますが、その場合、すべての子がハイフネート クラスを継承してしまいます。javascript を使用して動的にクラスを追加することもできましたが、restructuredText を使用して簡単に追加できる方法があるのではないかと考えました。

助けてくれてありがとう、

ジョー

restructuredText でいくつかのシンボルを使用したい。これどうやってするの？(たとえば、Markdownでは、標準 HTML 文字エンティティ→のリストで定義されている「→」記号が生成されます。w3c リファレンスも参照してください)

注: 数式のサポートを依存関係として要求したくありません。

PHP プロジェクトのドキュメンテーション システムが必要で、コード コメントから生成されたドキュメンテーションと外部ドキュメンテーション (ユース ケース、プロジェクト スコープなど) を統合できるようにしたいと考えていました。phpDocumentor は正確に適切な機能セットを備えているようですが、外部ドキュメントは DocBook で作成する必要があり、これは私たちのチームにとって複雑すぎます。

それが Python の場合、sphinx はこの仕事にほぼ完璧です (ReST は間違いなく docbook よりも簡単です)。外部の ReST ドキュメントを phpdoc から抽出したドキュメントと統合する方法はありますか? 外部ドキュメントを分離する必要がありますか (たとえば、外部には ReST を使用し、内部には phpdoc を使用します)。または、外部ドキュメントを管理するためのより良い提案はありますか?

関連：軽量フォーマット（テキスタイル、マークダウン）をデータベースに保存する方法は？

コメントのフォーマットをマークアップ言語でDBに保存したいと思います。ただし、複数のフォーマット言語（マークダウン、テキスタイル、restructuredText）を許可する必要があります。それらの間で変換できるように、それらの機能のスーパーセットを保存する必要があるようです。

• これは機能しますか？
• そのようなスーパーセットはありますか？
• それらを切り替えるライブラリはありますか？
• DBにコメントを保持する必要があるより構造化された形式はありますか？

（重要な場合はPython / Google App Engine）

Sphinxは、 Tracの対応するチケット/チェンジセットのよう#112なテキストを自動的にリンクする方法はありますか？r1023

例：

その他の例については、 TracLinksを参照してください。

ブログ/cms の代わりに、いくつかの (めったに更新されない) ページを含む静的な html ベースのサイトが欲しいです。それらを更新する最も簡単な方法は、ソースをReSTのような形式に保ち、更新するたびにコンパイルすることだと思います。この用途に推奨されるコンパイラは何ですか? 独自のテーマ/デザインを持ちたいのですが、適切な ReST 構文以外は必要ありません (たとえば、Sphinx は多すぎます)。

DRYを適用するために、パラメーターを宣言するのと同じ行に（必要に応じて）各パラメーターを文書化することを好みます

私がこのようなコードを持っている場合：

doc文字列でパラメーターを繰り返さないようにし、パラメーターの説明を保持するにはどうすればよいですか？

避けたい：

これは、Python2.6またはPython3で、ある種のデコレータ操作を使用して可能ですか？他に方法はありますか？

最初に自動ヘッダー番号を付ける方法はありますか？それは次のようなものです：

これは次のようにレンダリングされます。

1.いくつかのセクション

..。

1.1いくつかのサブセクション

..。

1.2別のサブセクション

..。

2.別のセクション

..。

私はレポート ツールに取り組んでおり、pdf、html、Excel (.xls または Excel で簡単に開くことができる任意の形式) を含むさまざまな形式でレポートを生成する必要があります。

xhtml または restructuredtext(rst) で基本的なレポートを生成し、それを他の形式に変換することを考えています。pdf 変換に xhtml2pdf または rst2pdf を使用できますが、xhtml または rst を実行できるツール/ライブラリを見つけることができません。変換。

Q1. Excel コンバーターへの rst または xhtml はありますか?

他の選択肢は何ですか？たとえば、基本的なドキュメントを python オブジェクトのリストとして生成し、それらを reportlab 経由で pdf に変換するか、xlwt ( http://pypi.python.org/pypi/xlwt )経由で Excel に変換することを考えています。

Q2. そのような python ドキュメント モデルは既にありますか?

Q3. rst を生成し、それを解析して xlwt を使用して xls ファイルを生成するのはどれほど簡単でしょうか?

私はSphinxとreStructuredTextを使用してソフトウェアパッケージを文書化しています。

私のドキュメントには、長いコードスニペットがいくつかあります。それらを展開する小さな「表示/非表示」ボタンを使用して、デフォルトで非表示にできるようにしたいと思います（例）。

それを行うための標準的な方法はありますか？