web-dev-qa-db-fra.com

Comment parcourir (sans éditeur de texte) les fichiers .rst?

Dans de nombreux projets Django, dans le répertoire docs, je peux voir les fichiers * .rst:

Quelle est la meilleure façon de les parcourir (sans utiliser un éditeur de texte bien sûr)?

Est-il possible de générer du HTML?

35
Eric

.rst les fichiers sont au format ReStructuredText . Ils ressemblent à des fichiers texte, mais peuvent être rendus en HTML avec le package Python docutils .

28
Mike DeSimone

Comme le dit zjk, vous pouvez utiliser restview:

restview est disponible à partir de Python Index du paquet: http://pypi.python.org/pypi/restview . Vous pouvez également installer pip restview.

Voici ce que j'ai fait pour le tester à l'aide d'un environnement virtuel:

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 

Cela a lancé un serveur Web et ouvert la page de documentation dans mon navigateur.

Remarque: J'ai utilisé virtualenv uniquement parce que je n'aime pas installer les choses à l'échelle mondiale. C'est peut-être exagéré pour beaucoup d'autres, mais j'ai également plus de chance avec ces environnements uniques. Quand j'ai essayé pip install restview sur un Ubuntu 14.04 VM il a échoué, alors que l'approche ci-dessus a fonctionné comme un charme pour moi sur ce système ainsi que celui-ci.

14
sage

Essayez restview

9
zjk