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

Calvin Cheng

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

Subscribe Reply

7393

Thijs Triemstra | Collab

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...@o d-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

Gerard Flanagan

On Jun 19, 11:19*pm, "Calvin Cheng" <calvin.ch...@o d-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

Similar topics

2310

distutils question->when do install, says header (.h) file is an unknown file type!?!?!

by: Christian Seberino | last post by:

I have a program that has Python and C code. I added Extension stuff to setup.py and all .c and .h files get into tarball fine. (I have something like Extension("foo", glob.glob("bar/*.") ) When I try to INSTALL the package it says header (.h) file is an unknown type. How fix this???

Python

5349

Method with unknown return type

by: Nuno Barros | last post by:

Hello, I am writting a c++ code to crete a kind of a table in memory. Each table has an container of columns, which can be of any type. To do this i created a virtual class Column which has some daugther classes like ColumnInt, ColumnFLoat, etc etc. The problemis that i must access the data in the columns by using an Object (pointer) of the type Column.

C / C++

1586

Deserialization of Unknown Object Type

by: Dan Noel | last post by:

I am implementing a DataStore/Settings object that stores objects in XML by serializing the objects in XML and then associating these objects with key names. At some later point, I want to retrieve the object associated with a given keyname, but I am running into trouble deserializing objects into the correct object type. Nearly all of the examples that I have found that use XmlSerializer pass in a type ahead of time, but in my case...

.NET Framework

2747

VC++ .NET 2003: XmlValidatingReader via DTD - Unknown node type

by: SHC | last post by:

Hi all, I created an application from the Console Application (.NET) of VC++ .NET 2003, and I did "Build" the application of the attached .cpp file, volcanoes.xml and geology.dtd on my VC++ .NET 2003 - Windows XP Pro PC suscessfully. But when I ran it from the command line - C:\Documents and Settings\SHC\My Documents\Visual Studio Projects\XMLdtdValidatingReader\Debug>XMLdtdValidatingReader valcanoes.xml, I got the following message in...

.NET Framework

2448

unknown directive

by: DevarajA | last post by:

What is #pragma used for?

C / C++

25777

Creating Instance of Unknown Generic Type

by: Joanna Carter \(TeamB\) | last post by:

I want to be able to use a generic type, bind its generic parameters to specific type(s) and then hold newly created instances in a list of generic ypes. Sort of like this : class Agent<T> { ... }

C# / C Sharp

3756

deserialization of xml with unknown object type?

by: KenK | last post by:

Hi all, Been reading all day about object serialization techniques in C# and my problem is that everything I read is requiring a "known" object class. Is there a way to create an object from the xml code itself without casting it through an object? If not, what is the best way to allow the end user to create their own object classes?

C# / C Sharp

3888

MS Access + C# OdbcDataReader -- Unknown SQL type - 0.

by: bjlemaire | last post by:

Hello, I am writing an app that is retrieving data via an ODBC connection to an Access database. I am returning many columns, and it seems that for certain columns that I try to read, I get the following error: "Unknown SQL type - 0." Am I doing a cast wrong somewhere? Are null values affecting the data reader? Any help would be appreciated.

Microsoft Access / VBA

9586

What is ONU?

by: marktang | last post by:

ONU (Optical Network Unit) is one of the key components for providing high-speed Internet services. Its primary function is to act as an endpoint device located at the user's premises. However, people are often confused as to whether an ONU can Work As a Router. In this blog post, we’ll explore What is ONU, What Is Router, ONU & Router’s main usage, and What is the difference between ONU and Router. Let’s take a closer look ! Part I. Meaning of...

General

9990

The easy way to turn off automatic updates for Windows 10/11

by: Hystou | last post by:

Overview: Windows 11 and 10 have less user interface control over operating system update behaviour than previous versions of Windows. In Windows 11 and 10, there is no way to turn off the Windows Update option using the Control Panel or Settings app; it automatically checks for updates and installs any it finds, whether you like it or not. For most users, this new feature is actually very convenient. If you want to control the update process,...

Windows Server

9861

Discussion: How does Zigbee compare with other wireless protocols in smart home applications?

by: tracyyun | last post by:

Dear forum friends, With the development of smart home technology, a variety of wireless communication protocols have appeared on the market, such as Zigbee, Z-Wave, Wi-Fi, Bluetooth, etc. Each protocol has its own unique characteristics and advantages, but as a user who is planning to build a smart home system, I am a bit confused by the choice of these technologies. I'm particularly interested in Zigbee because I've heard it does some...

General

8869

AI Job Threat for Devs

by: agi2029 | last post by:

Let's talk about the concept of autonomous AI software engineers and no-code agents. These AIs are designed to manage the entire lifecycle of a software development project—planning, coding, testing, and deployment—without human intervention. Imagine an AI that can take a project description, break it down, write the code, debug it, and then launch it, all on its own.... Now, this would greatly impact the work of software developers. The idea...

Career Advice

6672

Couldn’t get equations in html when convert word .docx file to html file in C#.

by: conductexam | last post by:

I have .net C# application in which I am extracting data from word file and save it in database particularly. To store word all data as it is I am converting the whole word file firstly in HTML and then checking html paragraph one by one. At the time of converting from word file to html my equations which are in the word document file was convert into image. Globals.ThisAddIn.Application.ActiveDocument.Select();...

C# / C Sharp

5298

Trying to create a lan-to-lan vpn between two differents networks

by: TSSRALBI | last post by:

Hello I'm a network technician in training and I need your help. I am currently learning how to create and manage the different types of VPNs and I have a question about LAN-to-LAN VPNs. The last exercise I practiced was to create a LAN-to-LAN VPN between two Pfsense firewalls, by using IPSEC protocols. I succeeded, with both firewalls in the same network. But I'm wondering if it's possible to do the same thing, with 2 Pfsense firewalls...

Networking - Hardware / Configuration

5446

Windows Forms - .Net 8.0

by: adsilva | last post by:

A Windows Forms form does not have the event Unload, like VB6. What one acts like?

Visual Basic .NET

3561

How to add payments to a PHP MySQL app.

by: muto222 | last post by:

How can i add a mobile payment intergratation into php mysql website.

PHP

2814

Comprehensive Guide to Website Development in Toronto: Expert Insights from BSMN Consultancy

by: bsmnconsultancy | last post by:

In today's digital era, a well-designed website is crucial for businesses looking to succeed. Whether you're a small business owner or a large corporation in Toronto, having a strong online presence can significantly impact your brand's success. BSMN Consultancy, a leader in Website Development in Toronto offers valuable insights into creating effective websites that not only look great but also perform exceptionally well. In this comprehensive...

General