restructuredtext - reStructuredTextをプレーンテキストに変換する方法

Question

私はreStructuredTextを使用して、いくつかの素晴らしいHTMLページを生成することを主な目的としたドキュメントを作成する予定です。このために、私はdocutilsrst2html.pyツールを使用します。

ただし、reStructuredTextマークアップがなく、段落の折り返しや同様の適切なフォーマットがテキスト出力で実行される、適切なプレーンテキスト形式でドキュメントを表示する必要がある場合もあります。ただし、docutilsにはrst2txt.pyツールはありません。

おそらくdocutilsの特別なオプションを使用して、reStructuredTextを素敵なプレーンテキスト形式に変換する方法はありますか？

Answer 1

また、rst2html を使用して html にレンダリングし、次のようなコマンドライン html ブラウザを使用して html をプレーン テキストに変換することで、これが行われることも確認しました。

• リンクスhttp://lynx.browser.org
• リンクhttp://links.sourceforge.net
• w3m http://w3m.sourceforge.net
• elinks http://elinks.or.cz

これらの各ブラウザーには、出力を .txt ファイルにレンダリングするためのコマンド ライン スイッチまたは同様のものがあるため、次のような「rst2txt」という 2 行のスクリプトを作成できます。

rst2html docs.rst docs.html
lynx -dump docs.html > docs.txt

Answer 2

Sphinxには、txt出力形式用のTextBuilderがあります。試してみたところ、探していることを実行しているようです。

ただし、デフォルトのMakefileにないため、少し古くなっている可能性があります。しかし、それは私のかなり複雑なドキュメント（150 pdfページ）ではうまく機能しました。使用するには、次のターゲットを追加するだけです。

text:
    $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) _build/text
    @echo
    @echo "Build finished."

また、Sphinxは最初の仕様のサブセットのみを実装していることに注意してください。