2009-07-28 16 views
14

reStructuredTextを使用して、素敵なHTMLページを生成することを主目的としたドキュメントを作成する予定です。このためには、docutilsのrst2html.pyツールを使用します。reStructuredTextをプレーンテキストに変換する方法

しかし、reStructuredTextマークアップがなく、テキスト出力で段落の折り返しや同様の素敵な書式設定が実行されているような素晴らしいプレーンテキスト形式でドキュメントを表示する必要がある場合もあります。しかし、docutilsにはrst2txt.pyツールはありません。

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

+3

私はreStructuredTextは、あなたが最初に探している "素敵なプレーンテキストフォーマット"だと思います! –

答えて

9

スフィンクスは、txt出力形式でTextBuilderです。ちょうどそれを試してみて、それはあなたが探しているものを行うようだ。

しかし、デフォルトのMakefileにないため、少し古いかもしれません。しかし、かなり複雑なドキュメント(150ページのpdfページ)ではうまくいきました。 、それを使用するだけで、それに次のターゲットを追加するには:

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

また、スフィンクスは、RST仕様のサブセットのみを実装するに注意してください。私も、これは、その後のような、コマンドラインHTMLブラウザを使用して、プレーンテキストにHTMLを変換し、rst2htmlを使用してHTMLにレンダリングすることで行って見てきました

+0

Thoriannさん、ありがとう、私はこれをmakefileを通して動作させることができました。また、PythonからTextBuilderを直接使用したいと思っていますが、これに関するドキュメントは見つかりませんでした。 TextBuilderクラスのドキュメントの場所や、Pythonからの使用方法を示す短い例がわかりますか?よろしくお願い致します。Morten –

+0

私はこのことに関するいかなる文書も知らない。例として、Sphinxのソースコードからcmdline.pyを見ることができます。もしあなたが本当にそれを望むなら、実践できると思う。 – tsg

+0

こんにちはThoriann、お返事ありがとうございます。良い週末を。よろしくお願い致します。 –

11

これらのブラウザはそれぞれ、コマンドラインスイッチまたはあなたが「rst2txt」と呼ばれる2行のスクリプトを作成することができますので、.txtファイルに出力をレンダリングする同様のを持っているようなもの:NoTex.chオンラインテキストを

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

これは私のために一番うまくいった。私は「正しい」ことは、XLSTスタイルシートを書いてtxtに変換し、おそらくorg-modeにすることだと思います – JeffG

0

エディタ(rSTをサポート)には、プレーンテキスト変換(SphinxのTextBuilderに基づく)のサポートが含まれています。

関連する問題