問題タブ [docutils]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票する
1 に答える
112 参照

python-sphinx - ドキュメントにサブセクションが追加された後、レベルを上げるにはどうすればよいですか?

次のようないくつかの階層セクションを含む再構成テキスト ドキュメントがあります。

これはうまく機能します。Sphinx を使用してコンパイルすると、正しい HTML 形式が得られます。

私の質問は次のとおりです。階層レベルを上げて、いくつかのサブセクションの後にテキストを追加するにはどうすればよいですか?

例えば:

私は基本的に、階層のレベルを上げる方法を探しています。

これは可能ですか?

ありがとう!

0 投票する
0 に答える
615 参照

python-sphinx - rst2odt.py を使用したスフィンクス

私は Sphinx の多くの機能をとても気に入っていますが、最終出力は docx にする必要もあります。私は rst2odt.py ( docutils) と LibreOffice を使用して .rst -> .odt -> .docx でうまくいきました。Sphinx が "Docutils XML" を生成できることに気付きました。私の考えでは、それを使用して、rst2odt.py と同じメカニズムで .odt にアクセスできるはずです。しかし、私はそれについてどのように行くかわかりません。パッケージがあることは認識していますが、実験に基づいてテーブルサポートがかなり制限されている内部でsphinxcontrib-docxbuilder使用されています。python-docx列/行のスパンを非常にきれいな方法で実行できるため、特に rst を使用しています。

私が現在検討している代替手段は、jinja2Sphinx が必要とするすべてのことを実行し、rst2odt.py に固執するようなものを使用することです。

0 投票する
0 に答える
1936 参照

python - sphinx tabularcolumns ディレクティブの正しい使用

http://sphinx-doc.org/markup/misc.html?highlight=tabularcolumns#tablestabularcolumnsに記載されているように、ディレクティブを使用して単一のテーブル列を中央に配置しようとしています

簡単な例:

私の読みによると、これは最初の列を中央に配置する必要がありますが、列 1 の HTML 出力は常に左揃えになります。私は何かを読み間違えたり、誤解したりしていますか?

sphinx-build バージョン 1.3.1 の使用

0 投票する
1 に答える
248 参照

python - 変数名/タグを asciidoc ドキュメントに割り当てて、それらの名前を jinja テンプレートで使用できるようにする

Asciidoc ファイルからタグを抽出して Python 辞書に保存する方法が必要です。私は一般的に書いてAsciidocいますが、Python辞書を作成するためのキーとして抽出できるAsciidocで変数名を作成する方法がわかりません。私はドキュメントを探していましたが、役に立ちませんでした。

したがって、このasciidocマークアップを次のような辞書に変換する方法が必要です

asciidoc ファイルを xml に変換してから、xmltodict でこれを辞書に変換しようとしました。しかし、ディクショナリに多くの xml 形式のものを取得したため、それはうまく機能しませんでした。私はbeautifulsoupなどのさまざまなパーサーを見ましたが、asciidocはcloseタグを使用しないため、それが機能するかどうかもわかりません. 助言がありますか。

0 投票する
0 に答える
842 参照

python - 再構成されたテキスト docstring を HTML に解析中にエラーが発生しました

そのため、python sklearnライブラリを使用して簡単なアプリケーションを作成しています。sklearn estimator モデルのいずれかの docstring を解析する必要があります。私は reSTRuctured テキストに精通していませんが、sklearn の「Contributing documentation」ページからのいくつかの簡単な調査では、これらの docstring が reSTRuctured テキスト形式であることを示唆しているようです。この質問に続いて、次のことを試しました(例としてサポートベクター分類器SVCを使用)

それを必要とする人にとって、生のdocstringは

ただし、パーサーエラーが発生します

私が本当に望んでいるのは、本格的なパーサーを自分で書かなくても、sklearn オブジェクトの docstring を HTML に変換する方法だけです。そうする方法がない場合は、パーサーを作成するための提案を歓迎します。前もって感謝します。

0 投票する
1 に答える
366 参照

restructuredtext - rst2html.pyスタイルシート

Docutils の rst2html.py を使用して、スタイルシートへのリンクをhead:に含めることは可能<head>...<link rel=stylesheet href="friendly+dinosaur.css" />...</head>ですか?

したがって、明確にするために、私はを生成したり使用したりすることに興味はありません<style>...{{ contents on friendly+dinosaur.css }}...</style>@import

が存在することに気付きましたが--link-stylesheet、引数をとらず、代わりに への参照を追加するだけhtml4css1.cssです。--stylesheet-path私の質問とは無関係のようです。