問題タブ [restructuredtext]

実行時

私のdoc/ディレクトリでは、次の出力が得られます。

このファイルにはインポートがあり、少し調査したところ、sphinx が使用する RST マークアップの文書化numpyの方法に問題があるようです。numpynumpy インポートを取り出すと、html が正常にビルドされます。

この問題を解決する最善の方法は何ですか?

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

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

いくつかの PDF を生成していますが、フロントページのヘッダーを無効にしたいと考えています。rst2pdf に組み込みのテンプレートがあり、1 つのテンプレートが呼び出されるcoverPageことは知っていますが、それを機能させることができないようです。

マニュアルには、

ステートメントですが、カバーページの前に空が挿入されるため、ヘッダーなしでoddevenディレクティブを使用せずにカバーページを作成するにはどうすればよいですか (残りのすべてのページで同じヘッダーを使用したい)。

ご提案いただきありがとうございます。

Emacs では、暗い背景と明るいテキストの配色を使用しています。.rst ファイルを操作する場合、rst.el を使用するモードがあります。ただし、rst.el は見出しを明るい背景色で強調表示するため、明るいテキストを読むことができません!

これは、背景色を担当する rst.el のコードのセクションだと思います。

「灰色」を別のものに変更しようとしましたが、何も変わりません。何か助けはありますか？

日食の下でreStructuredText用のWiKiTextエディタープラグインはありますか？.textileファイルを編集すると、さまざまなインテリジェントな編集機能（行の折りたたみなど）とプレビューパネルが表示されます。さまざまなMyLynパッケージの下にreStructuredTextへの参照があることがわかりましたが、それらをインストールした後でも、reStructuredTextエディターが見つかりません。ないからですか？

ありがとう。ケント

私はepydocでreStructuredTextを使用しています。内部リンクのテキストをリンクのターゲットとは異なるものにするにはどうすればよいですか? 私は持っている：

Product リンクは正常に見え、Product オブジェクトにリンクしています。Product.manufacturer リンクは適切なメンバー変数に移動しますが、テキストが Product.manufacturer ではなく、単に製造元になりたいと思います。

これは、epytext を使用すれば実行できることはわかっていますが、必要に応じて後でドキュメント ジェネレーターを切り替えることができるように、reStructuredText を使い続けたいと考えています。

私はrestructuredTextを使用しており、smartypantsがMarkdownに対して行うことを気に入っています。restructuredTextで同じことを有効にする方法はありますか？

RestructuredTextで書かれたドキュメントを提供するためにDjangoアプリを書いています。私は*.rstで書かれた多くの文書を持っています、それらのそれぞれは多くのセクション、サブセクションなどでかなり長いです。

ドキュメント全体を単一のページに表示することは、Djangoフィルターを使用しても問題ありませんが、最初のページにトピックインデックスだけを表示し、単一のセクション/サブセクションを表示できるURLにリンクします（これにはいくつかの必要があります） '前へ|上へ|ホーム|次へ'リンクだと思います...）。docbook/XMLからHTMLへの変換のような「複数のHTMLページ出力」と同様の方法で。

* .rstドキュメントのドキュメントツリーを構築し、その1つのセクションを解析する方向を誰かに教えてもらえますか、または同様の結果を取得するための賢い方法を提案できますか？

軽量のマークアップ言語を使用して、大学の授業でノートを取りたいと考えています。

私が選んだエディタは gedit で、reStructuredText Tools for Geditを見つけました。これは reStructuredText プロセッサを実行し、gedit のペインに HTML をレンダリングします。これは素晴らしいことで、80% はそこまで進んでいます。

しかし、私のクラスの多くでは、ノートに数学の方程式やギリシャ文字を含める必要があります。私は LaTeX にあまり詳しくありませんが、LaTeX にはこれらの機能があることを理解しています。

reST ドキュメントで LaTeX を使用するにはどうすればよいですか? reSTドキュメントをLaTeXに処理してからHTMLにレンダリングする必要がありますか、それとももっと良い方法がありますか? マークダウンはこれを簡単にしますか? 必要に応じて gedit プラグインを変更できます。

最後に、これを行う人はいますか？プレーン テキスト エディターでクラスのノートを取るための他の提案はありますか?

ありがとう！

Python コンポーネントと JavaScript コンポーネントを含むライブラリを文書化しています。全体的なユーザー ドキュメントと Python API ドキュメントは、Sphinx で処理された reStructuredText にあります。JavaScript API は jsdoc にあり、jsdoc-toolkit で処理されます。主な出力形式は HTML です。reST、Sphinx、jsdoc は初めてです。

生成されたすべての HTML ページが単一のディレクトリ ツリーにダンプされるように、ビルド システムをセットアップしました。ここで、メイン ページ (reST から生成) に、生成された Javascript ドキュメントへのリンクを挿入する必要があります。ドキュメントは異なるインストールの異なる場所にある可能性があるため、これは相対リンクである必要があります。reST は完全な URL を自動的に解析しますが、相対リンクを挿入する方法がわかりません。:ref:や:doc:のような構造は、ターゲットが reST であることを期待しているため、役に立たないようです。

何か案は？