問題タブ [restructuredtext]

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 投票する
2 に答える
1305 参照

restructuredtext - reStructuredTextで重複するターゲット名を処理するにはどうすればよいですか?

例:

異なるURLを指しているためDownload、docutilusは次のエラーレポートを提供します。

マークダウン中に、この2つに異なるIDを指定できますDownload

reStructuredTextで同様のことを行うにはどうすればよいですか?

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

python - restructuredText、docstring、pythonインタラクティブシェル

私はreStructuredTextを使用してコードを文書化し、epydocを使用してオフラインのHTMLページを取得しています。

結果は素晴らしいです。唯一の欠点は、Pythonインタラクティブシェルを使用すると、help()関数がドキュメント文字列のreSTメタデータを解析せず、代わりにすべてをそのまま表示することです。

docstringの最小限の解析を行うためにhelp()を使用する方法はありますか?

イタリックフォントやハイパーリンクのレンダリングは期待していませんが、読みやすさを向上させるために少なくともいくつかの最小限のクリーンアップを期待しています。

0 投票する
4 に答える
4354 参照

html - 画像をreRestructuredTextで中央揃えにする方法は?

この投稿では、次のディレクティブが画像を整列させる方法であると述べています。

ただし、画像は中央揃えではなく右揃えであり、HTMLは次のように生成されます。

これは、「HTMLタグの「align」属性に相当する画像の配置」という説明とは逆に、align-centerクラスとして定義されています。

私もCSSを持ってみました。

そして、それも機能しません。

これの何が問題になっていますか?

0 投票する
2 に答える
1581 参照

python - reStructuredText のマクロまたは同等物?

私は<form>いつもこのようなことがあります。

たとえば、同じ結果を得ることができるように、reStructuredText にマクロまたは同等のものはありますか?

0 投票する
2 に答える
1502 参照

sql - SQLのreStructuredText?

DocUtils と reStructuredText を使用して SQL コードにコメントを付けようとしています。複数行のコメント内にマークアップを含めると、これを機能させることができます。次に --Some text:: を使用して、コードの各ブロックを紹介します。

内部ハイパーリンクが機能しません。-- .. Step1_: と書きたいのですが、先頭のコメントのためにパーサーはこれを無視します。複数行スタイルの使用も失敗します。これを機能させる方法はありますか?

次に例を示します。

0 投票する
3 に答える
6342 参照

python - Python から reST/sphinx ソースを生成するには?

reST 経由でドキュメントを生成したいのですが、手動で reST ソースを書きたくないのですが、Python スクリプトにそれをさせてから、sphinx で他の形式 (HTML、PDF) を生成します。

バイナリ形式の電話帳があるとします。次に、Python スクリプトを使用してこれを解析し、すべての名前と番号を含むドキュメントを生成します。

次に、pdf と html を生成するために sphinx を呼び出します。

reSTを生成するためのAPIを提供するpythonモジュール(上記の例ではrestProducer)はありますか?または、いくつかの print ステートメントを介して reST マークアップをダンプする最良の方法はありますか?

0 投票する
3 に答える
8465 参照

python - 再構成されたテキストを含む 2 つのリンクに同じテキストを含める方法は?

これが私がやりたいことです:

取得するには:

コンテキストは出版物のリストであり、すべての出版物の最後に「DOI」とマークされたリンクが必要です。

ただし、これは次の場合に失敗するようです。

正確なエラーは、使用している docutils のバージョンに依存しているようですが、すべて失敗しました。

再構成されたテキストで同じテキストを含む複数のリンクを生成する方法はありますか?

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

restructuredtext - RestructuredText テーブルの垂直ヘッダー

RestructuredText では、次のようなテーブルにヘッダー行をレンダリングできます (ドキュメントから取得:

最初の列と同様のことを行うことは可能ですか? 明らかに機能しない例は、次のようになります (列 1 の最後にある double like に注意してください)。

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

latex - latex を rst/sphinx に変換する

rst と sphinx を使用してプロジェクトのドキュメントを書いています。しかし、以前に、私はすでにその一部をラテックスで書いていたので、それをrstに変換してドキュメントに追加したいと考えています。rst から latex への変換は明らかですが、逆の方法で Google 検索を行っても、直接何かが得られることはありませんでした。

私の質問: latex を rst に変換する方法はありますか?

編集
理想的には、特にスフィンクスで使用するために rST に変換したいと思います。そのため、数式を表示するための sphinx の拡張機能などを使用できるとよいでしょう。

0 投票する
2 に答える
34045 参照

markup - reStructuredTextでネストされたリストを作成するにはどうすればよいですか?

次のコードを使用して、適切にネストされたリストを作成しようとしています(Sphinxおよびdocutilsのドキュメントに従ってください)。

これにより2OL秒になると思いますが、代わりに次の出力が得られます。

私は何が間違っているのですか?次のような結果は得られませんか?