問題タブ [restructuredtext]

問題: reStructuredTextを使用して「パラレル テキスト」を書き込もうとしています。「パラレル テキスト」とは、テキストが 2 段組みになっている、注釈付きのフィクション作品のようなものを意味します。左欄が本文、右欄が解説です。そこから HTML と Latex ドキュメントを生成するためにsphinxを使用します。

次の要件があります。

1. 前述のように、テキストを 2 つの列 (1 つは本文用、もう 1 つは注釈用) にタイプセットできるはずです。
2. 注釈は「文レベル」にすることができ、常に「段落レベル」であるとは限りません。つまり、段落内のさまざまな文または段落全体に注釈を付けたいと考えています。
3. 出力 HTML と Latex にはメイン テキストのみが含まれるように、すべての注釈をオフにするモードがあると便利です。この場合、コラムだけでなく、媒体の「不動産」全体を使用できるようにしたいと考えています。
4. 可能であれば、「注釈のリスト」機能があると非常に便利です。

私は reStructuredText と Sphinx にはかなり慣れていませんが、Python にはかなりの経験があります。自分のやりたいことを実現するためのアイデアを探しています。私は reStructuredText について読んでおり、Sphinx 拡張機能の作成についても読んでいるので、Sphinx の拡張機能を作成することは問題外ではありません。

誰かが以前に似たようなことをしたことがありますか?

ありがとう！

不確実性 Python パッケージのドキュメントは、 Sphinxドキュメント システム用の reStructuredText で書かれています。HTMLは正常に表示されます。PDF版を作りたいです。目標は、Web ページごとに「チャプター」を持つことです。

ただし、ReST ファイルによって生成された PDF は、(HTML)セクションをindex.html個々の章に変換します(これは望ましくありません。PDF にもセクションとして含める必要があります)。もう 1 つの問題は、メイン ページの後のすべての HTML ページが、ディレクティブが表示されるセクションのサブセクションtoctree(つまり、メイン ページの確認セクション) として PDF に表示されることです。

では、(1) Web ドキュメントが現在と同じように見え、 (2) 各 Web ページが PDF の章に対応するように、ReST ファイルをどのように構成する必要がありますか。どんな助けでも大歓迎です！

reStructured Text の横にテキストが表示された画像を表示する最良の方法を探しています。それがどのように行われたかを示すと称するサイトをいくつか見つけましたが、実際に機能する例を示しているサイトはありません。いくつかは、失敗例と思われるものを示しています。私は実際に Sphinx (v0.6.6) を使用しており、付属の「ネイティブ」CSS を必要以上に改変しないようにしたいと考えています。

reStructuredText から生成された jQuery lightBox 実装を Web サイトで使用しようとしています。lightBox は、画像の周りのリンクのタイトルを lightBox ディスプレイの画像のキャプションとして受け取ります。

しかし、reStructuredText でリンクにタイトル属性を提供する方法が見つからないようです。これを行う方法を知っている人はいますか? 私の画像は次のように定義されています：

したがって、alt属性は追加できますが、タイトルは追加できません。可能な代替手段は、次のようにターゲットを参照として使用することです。

この後者の場合、下部に定義されたリンクに属性を追加する方法がわかりません (可能な場合)。

最後の行に従って、ショートカットを使用して=（Section / Title reStructuredText構文から）必要なものを追加したいと思います。

したがって、（|カーソル位置である）と仮定します。

関数にマップされた特定のマッピングを押し=て、最後の行（ここで）に等しい数を追加すると、次のTitleようになります。

ディレクトリに多数のテキスト ファイルがありhelp_pages/、すべて reST でフォーマットされています。私はGNUにMakefileいくつかのルールを追加しようとしています:

1. 有効なhtmlファイルを吐き出すアプリを介して、拡張子「.rst」のディレクトリ（およびサブディレクトリ）内の各ファイルを実行しhelp_pagesます（現在、私はrst2html.
2. これらの出力 html ファイルをターゲット ディレクトリにコピーし、ディレクトリに存在していたディレクトリ構造を再現しhelp_pagesます。

したがって、たとえば、help_pages/some/dir/foo.rst最初に に変換されhelp_pages/some/dir/foo.html、次に にコピーされpublic/help/some/dir/foo.htmlます。

Makefile のイントラキャシーを学ぼうと一日中過ごしましたが、結局諦めました。これが私がすでに持っているものです：

この種の作品 - .rst ファイルは .html ファイルに変換されますが、それらを最終的なターゲット ディレクトリにインストールする方法がわかりません。メインのビルド レシピにコマンドを追加するcpと、ターゲット ディレクトリにファイルが存在しない場合、ファイルは再インストールされません。

理想的には、ヘルプ ファイルを作成するターゲット、それらをインストールするターゲット、およびこれら 2 つに依存する 3 つ目のターゲット (「ヘルプ」と呼ばれる) が必要です。これにより、最大の柔軟性が得られると思います。

これを達成する方法について誰かが私にいくつかのヒントを教えてもらえますか?

乾杯、

ReStructured Textで色を使用するにはどうすればよいですか？たとえば、に**hello**変換され<strong>hello</strong>ます。ReStructure（rst2html.py）に何か を変換させるにはどうすればよい<font color="####">text</font>ですか？

..raw :: htmlについて考えましたが、空白行が導入されています。空白行なしでHTMLタグを挿入したい。

この投稿で尋ねられ、回答されているように、きれいなコード リストにSyntaxHighlighterを使用できます。

ReStructuredText では、次のように raw ディレクティブを使用できます。

ただし、使用できるコード ディレクティブが必要です。

コード ディレクティブを次の HTML コードに変換するにはどうすればよいですか?

reStructuredText で示されたリンク内のテキストをどのようにフォーマットしますか?

具体的には、最初から次の HTML を生成したいと考えています。

結果は次のようになります。

optparse.OptionParser ドキュメンテーション

ここで、「optparse.OptionParser」の部分は等幅フォントです。

私は試した

しかし、これは

このように見える

`` documentation <http://docs.python.org/library/optparse.html>\optparse.OptionParser_

HTMLのコメントは<!-- .. -->、再構成されたテキストでこのコメントブロックを作成するにはどうすればよいですか？つまり、再構成されたテキストの一部の行をコメント化するにはどうすればよいですか？