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?
.rst
les fichiers sont au format ReStructuredText . Ils ressemblent à des fichiers texte, mais peuvent être rendus en HTML avec le package Python docutils .
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.
Essayez restview