問題タブ [docutils]

私は Sphinx を学んでいて、ReST ファイルを編集する必要があります。そのためのインテリジェントなエディターはありますか? 同様に、コードの色付け、簡単なインデント、コード補完 (できれば) などを提供してくれるエディターです。

簡単なウェブサイトを作成するために、再構成されたテキストを使用しています。そのため、Google Analytics コードを追加したい *.rst ファイルがたくさんあります。しかし、私の知る限り、このようなものを追加することはできません?!

ファイルをhtmlに変換するためにrst2htmlを使用しています。

reStructuredText (docutils 経由) を使用してコンテンツをフォーマットする Python の CMS に取り組んでいます。私のコンテンツの多くは他のソースからインポートされ、通常はフォーマットされていないテキスト ドキュメントの形式で提供されます。reST は、デフォルトですべてがかなり正常に見えるため、これに最適です。

ただし、私が抱えている問題の 1 つは、警告が Web サーバーの stderr にダンプされ、ページのコンテンツに 挿入されることです。たとえば、Web ページで次のような警告が表示されます。

システム メッセージ: WARNING/2 (, 行 296); バックリンク

私の質問は次のとおりです。これらの警告を抑制、無効化、またはリダイレクトするにはどうすればよいですか?

理想的には、これらをログ ファイルに書き出したいと思っていますが、コンテンツに警告が挿入されないようにする方法を誰かが教えてくれれば、それで完璧です。

reST を HTML に解析するコード:

このドキュメント (http://docutils.sourceforge.net/docs/ref/rst/directives.html) では、.. raw:: を使用して docutils で HTML コードを渡す方法について説明しています。HTML コードは、生成されたの本体部分にあります。 HTML。

docutils で見出し部分 (..) に何かを入れるにはどうすればよいですか?

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

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

次に例を示します。

私は、C++ および Python プロジェクトでSphinxを使用することに慣れています。Clojureでプロジェクトを開始したばかりで、Sphinx/reStructuredText のスキルを再利用して Clojure コードを文書化したいと考えています。Clojure には組み込みドメインがないため、作成を開始しました。

皮肉なことに、Sphinx のドキュメントは拡張機能の作成にはまったく役に立ちません。というわけで、Python と Javascript の組み込みモードから始めて、いくつかの基本的な要素が機能するようになりました。次のディレクティブを使用して、関数のドキュメントを作成できます。

ただし、HTML 出力は C/Python スタイルの署名を生成します。前の例では、次のようなものが生成されます。

次のように Lisp 風の形式で署名を取得したいと思います。

docutils.addnodes署名を生成するコードは、モジュールまでずっと続いているようです。Sphinx 構文を使用して Sphinx に HTML を生成させるにはどうすればよいですか? テンプレートを使ってそれを行うことはできますか?それとも、これを行うにはビルダー システム全体をハックする必要がありますか?

拡張子が.rst. docutilsbuildhtml.pyは、拡張子.txtが . これは非常に迷惑です。Github に.txtファイルを RST または buildhtml として認識させてファイルを認識させる方法はあり.rstますか?

Restructured Textでテキストをストライクすることは可能ですか？

<strike>たとえば、HTMLに変換されたときにタグ としてレンダリングされるもの（ ReSTructuredTextなど）

私は、開発者が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 固有のオプションを含む引数は効果がありません。