By using this site, you agree to our updated Privacy Policy and our Terms of Use. Manage your Cookies Settings.
458,219 Members | 1,277 Online
Bytes IT Community
+ Ask a Question
Need help? Post your question and get tips & solutions from a community of 458,219 IT Pros & Developers. It's quick & easy.

Docutils rst2html.py gives <Error/3> Unknown Directive type "toctree"

P: n/a
Hi,

I am attempting to convert a bunch of .txt files into html using the
docutils package.

It works for most of the txt files except for the index.txt file which
gives 2 errors:
(1) <Error/3Unknown Directive type "toctree"
(2) (ERROR/3) Unknown interpreted text role "ref".

Any idea how I can fix this?

Would be glad if someone who is familiar with docutils could point me
in the right direction.

Thank you,
Calvin
Jun 27 '08 #1
Share this Question
Share on Google+
2 Replies


P: n/a
Getting the same error in the apache logs here, no idea where it's
coming from:

[Sun Jun 29 18:25:50 2008] [error] <string>:10: (ERROR/3) Unknown
directive type "toctree".
[Sun Jun 29 18:25:50 2008] [error]
[Sun Jun 29 18:25:50 2008] [error] .. toctree::
[Sun Jun 29 18:25:50 2008] [error] :maxdepth: 2
[Sun Jun 29 18:25:50 2008] [error]
[Sun Jun 29 18:25:50 2008] [error] <string>:16: (ERROR/3) Unknown
interpreted text role "ref".
[Sun Jun 29 18:25:50 2008] [error] <string>:17: (ERROR/3) Unknown
interpreted text role "ref".
[Sun Jun 29 18:25:50 2008] [error] <string>:18: (ERROR/3) Unknown
interpreted text role "ref".

On Jun 19, 11:19*pm, "Calvin Cheng" <calvin.ch...@od-eon.comwrote:
Hi,

I am attempting to convert a bunch of .txt files into html using the
docutils package.

It works for most of the txt files except for the index.txt file which
gives 2 errors:
(1) <Error/3Unknown Directive type "toctree"
(2) (ERROR/3) Unknown interpreted text role "ref".

Any idea how I can fix this?

Would be glad if someone who is familiar with docutils could point me
in the right direction.

Thank you,
Calvin
Jun 29 '08 #2

P: n/a
On Jun 19, 11:19*pm, "Calvin Cheng" <calvin.ch...@od-eon.comwrote:
Hi,

I am attempting to convert a bunch of .txt files into html using the
docutils package.

It works for most of the txt files except for the index.txt file which
gives 2 errors:
(1) <Error/3Unknown Directive type "toctree"
(2) (ERROR/3) Unknown interpreted text role "ref".

Any idea how I can fix this?

Would be glad if someone who is familiar with docutils could point me
in the right direction.

"toctree" is a directive specific to the sphinx documentation system:

http://sphinx.pocoo.org/concepts.html#the-toc-tree

You must have something like:

.. toctree::

in your file. docutils won't recognise this.

G.
Jun 29 '08 #3

This discussion thread is closed

Replies have been disabled for this discussion.