2013-09-02 4 views
0

Я использую Fedora 18 в виртуальной коробке на рабочем столе Windows XP, чтобы изучить Django. Пройдя через файлы документации .txt, я обнаружил, что эти файлы были написаны с использованием RestoredText. Я провел последний день или около того, пытаясь понять, как преобразовать файлы в нечто читаемое (HTML, Latex, PDF и т. Д.). Первое, что я сделал, - установить docutils (с source - страница загрузки) и использовать rst2html.py для преобразования файлов в HTML для чтения.Чтение документации Django с restview

Когда я использовал этот инструмент, я получаю Unknown interpreted text role "doc", Unknown interpreted text role "ref", Unknown interpreted text role "term" ошибки, и многое другое при открытии docs/intro/index.txt, docs/intro/install.txt и docs/intro/tutorial01.txt файлы. Мне удалось найти очень мало в Google, описывая точную проблему, с которой я столкнулся, поэтому я попытался использовать другой вариант.

Наивное мнение о том, что ошибки были родными для docutils Я решил найти другой инструмент и нашел this page и установил restview. Ну, я не понимал, что restview использовал docutils, поэтому я оказался на четвертом месте.

Как избавиться от этих и других ошибок? Я правильно установил docutils и восстановил?

Пожалуйста, скажите мне, если мне нужно, чтобы добавить дополнительную информацию

ответ

2

Вы должны использовать Sphinx. Этот инструмент is used by the Django project и он определяет дополнительные конструкции reStructuredText, которые дополняют те, которые определены docutils. Такие, как

+0

мне придется смотреть в него больше. Я уже установил его, но думал, что это только для подготовки документации. Я думаю, это имеет смысл, я могу читать ReST с ним – David

+0

Я посмотрел ссылку, которую вы отправили в проект Django, и он сказал мне, что именно делать. К сожалению, я получил еще одну ошибку, но я двигаюсь в правильном направлении. благодаря – David

 Смежные вопросы

  • Нет связанных вопросов^_^