問題タブ [restructuredtext]

rst2html によって生成された HTML 出力では、すべてのレベルのセクションがすべて「section」というクラスになっています。設定できますか？

したがって、独自の CSS を HTML 出力に適用したい場合、トップレベルのセクションとサブセクションに異なるスタイルを使用することはできません。それらは同じクラス名を持っているからです。

異なるレベルのセクションに異なるスタイルを適用したい場合、この問題を解決するにはどうすればよいですか?

私は、開発者がreStructuredTextを使用してパッケージを記述できるようにするフレームワークを作成しています。そのreStructuredTextをHTMLに解析して、GUIで表示できるようにします。

私は優れたSphinxに精通していますが、reStructuredTextを解析したことはありません。reStructuredTextの文字列と、場合によってはいくつかの追加の引数を取り、HTMLの文字列を返す関数のようなものを想像しました。

そこで、reStructuredTextの解析を担当するDocutilsを調べました。この関数を見つける方法がまったくわかりませんでした。Web上のドキュメントはむらがあります。モジュール内の機能の多くは、docutils.parsers.rstファイル名を対象としているように見えました。私はファイル名を持っていません！文字列を扱っているだけです。

ParseraとaDocumentを作成してメソッドを使用しようとしましたparseが、設定が欠落しているというエラーが表示され.tab_widthます。

reStructuredTextをHTMLに解析する方法を知っている人はいますか？

以下は私のコードです

次のエラーが発生しました。

したがって、次のように変更argsします。

今、エラーはありません。しかし、 HTML出力に挿入されたスタイルシートは の内容ではありません/home/wonder/lab/css/note.css。まだ/usr/local/lib/python2.7/dist-packages/docutils/writers/html4css1/html4css1.cssです。

つまり、publish_cmdline を使用する場合にコマンド ラインでオプションを指定する場合とは異なり、publish_string を使用する場合、settings_overridesHTML 固有のオプションを含む引数は効果がありません。

私はPyCharmにファイルを持っていて、それは以前は単なる.txtファイルでした。.rst今私は（reStructuredText）を使いたいと思いました。

初めてファイルを終了せずに開くと、PyCharmがファイルの種類と構文の解釈方法を尋ねてきます。

どういうわけかそのダイアログを再度開くことはできますか、それとも他の方法で関連付けを変更できますか？

reStructuredTextを使用して簡単なチェックリストに取り組んでいます。この目的のために箇条書きリストを使用しますが、標準の箇条書きを空のチェックボックスなどのカスタム記号に置き換えたいと考えています。最適には、HTML および/または PDF ドキュメントでチェックボックスをクリックできるようにします。

reSTでそれが不可能/自明である場合、可能な場合は他のテキストベースの形式をお勧めできますか?

バルトシュ

私の Django ベースのプロジェクトのドキュメントを書きたいと思います。Django の人々は、この目的のために reStructureText と Sphinx を使用していることがわかりました。以下の質問があります。

• reStructureText と Sphinx を使用してドキュメントを書き始めるにはどうすればよいですか?
• ドキュメントを適切に整理し、理解しやすく、管理しやすいようにバージョン管理するには、どのようなベスト プラクティスに従う必要がありますか?

JSDocと同様の機能を備えたJavascriptAPIドキュメントフレームワークを探していますが、コードコメント（htmlではなく）で入力しやすい再構成されたテキストまたはマークダウンを使用します

ボーナス：Sphinxとうまく統合できます。ただし、個別のドキュメントを維持したくはありませんが、コメントからAPIドキュメントを生成します。

http://code.google.com/p/jsdoc-toolkit/

RST では、ブロックの前にいくつかの空白を使用して、これがコード ブロックであることを示します。Python も空白を使用してコード ブロックをインデントするため、Python コードを記述している場合は、RST コード ブロックでこれらの空白を保持したいと考えています。どうやってやるの？

クラスがあるとしましょう：

__init__そして、このクラスのメンバーであるというメソッドを書きたいと思います。このメソッドは別のコード ブロックに属していますが、この 2 番目のブロックが前のブロックの続きであることが読者にわかるように、視覚的な手がかりが必要です。現時点では、次#のようにコード ブロックの垂直方向のガイドラインをマークするために使用します。

がなければ、#とdef __init__(self)同じインデント レベルで出力されclass Test(object)ます。もっとエレガントな方法があるはずです。

ReStructured Text ( rst2html.py ) を使用してテキストで色を使用する方法、または空白行なしで HTML タグを挿入する方法に従ってください。次のように、テーブル内のテキストの背景を設定できました。

その結果、文字の背後に緑色の背景を持つ「avail」という単語が表示されますが、これらの文字の背後にあるセルの一部だけでなく、セル全体に色付きの背景を持たせるにはどうすればよいですか?

私は自分のプロジェクトのドキュメントを生成するためにSphinxを使用しています。

このプロジェクトでは、使用可能なコマンドのリストをyamlファイルに記述します。このファイルが読み込まれると、次のような形式の辞書が作成さ{command-name : command-description}れます。

私が知りたいのは、サイクル中にyamlファイルをロードし、python辞書をreStructuredText形式（定義リストなど）に変換し、html出力に含める方法がsphinxにある場合です。make html

私の.rstファイルは次のようになると思います：

内部で次のように変換されます。

HTMLに変換される前。