web-dev-qa-db-ja.com

.rstファイルの閲覧方法（テキストエディターなし）

多くのDjangoプロジェクトでは、docsディレクトリに* .rstファイルがあります。

（もちろんテキストエディターを使用せずに）それらを閲覧する最良の方法は何ですか？

HTMLを生成することは可能ですか？

djangodocumentation
35
Eric

.rstファイルは ReStructuredText 形式です。テキストファイルのように見えますが、Python docutils パッケージでHTMLにレンダリングできます。

28
Mike DeSimone

Zjkが言うように、restviewを使用できます：

restviewはPython Package Index： http://pypi.python.org/pypi/restview から入手できます。restviewをpipインストールすることもできます。

仮想環境を使用してテストするために私がしたことは次のとおりです。

mkdir restview
cd restview/
virtualenv-2.7 venv   # The second system I used just used 'virtualenv venv'
./venv/bin/pip install restview
./venv/bin/restview ~/path/MANUAL.rst

これにより、Webサーバーが起動し、ブラウザーでドキュメントページが開きました。

注：グローバルにインストールするのが好きではないので、virtualenvのみを使用しました。他の多くの人にとってはやり過ぎかもしれませんが、これらの一時的な環境では幸運にも恵まれています。試してみたpip install restview Ubuntu 14.04 VMそれは失敗しましたが、上記のアプローチは、このシステムだけでなく、そのシステムでも魅力的でした。

14
sage

restview を試してください

9
zjk