Я использую 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 и восстановил?
Пожалуйста, скажите мне, если мне нужно, чтобы добавить дополнительную информацию
мне придется смотреть в него больше. Я уже установил его, но думал, что это только для подготовки документации. Я думаю, это имеет смысл, я могу читать ReST с ним – David
Я посмотрел ссылку, которую вы отправили в проект Django, и он сказал мне, что именно делать. К сожалению, я получил еще одну ошибку, но я двигаюсь в правильном направлении. благодаря – David