Skip to content

Latest commit

 

History

History

doc

Introduction

The TinyOS Extension Proposals (TEPs) are written using the reStructuredText. Converting them into HTML documents can be performed using the "rst2html" tool from the python Docutils package::

http://docutils.sourceforge.net

Installing Docutils using a native package

Many Linux distributions provide a native Docutils package. We provide short instructions for installing the package on Fedora Core 3, Fedora Core 4 and Debian.

Fedora Core 3

The Docutils package is part of the "extras" distribution channel.

When using the "yum" package manager, the "extras" repository can be added by creating a new extras.repo file in the /etc/yum/yum.repos.d directory with the content::

[extras]
name=Fedora Extras - $releasever - $basearch
baseurl=http://download.fedora.redhat.com/pub/fedora/linux/extras/$releasever/$basearch/
gpgcheck=1
enabled=1

After that, Docutils can be installed by issuing::

sudo yum install python-docutils

Alternatively, the Docutils RPM package can be downloaded manually from::

http://download.fedora.redhat.com/pub/fedora/linux/extras/3/i386/python-docutils-0.3.9-1.fc3.noarch.rpm 

and installed using:

sudo rpm -ivh python-docutils-0.3.9-1.fc3.noarch.rpm 

Fedora Core 4

In Fedora Core 4, the "extras" repository is already configured, but disabled by default. The docutils package can be installed using::

sudo yum --enablerepo=extras install python-docutils

Alternatively, the Docutils RPM package can be downloaded manually from::

http://download.fedora.redhat.com/pub/fedora/linux/extras/4/i386/python-docutils-0.3.9-1.fc4.noarch.rpm

and installed using:

sudo rpm -ivh python-docutils-0.3.9-1.fc4.noarch.rpm 

Debian

The Docutils are packaged in the python-docutils DEB package and can be installed using:

sudo apt install python-docutils

Alternatively, the Docutils DEB package can be download (for Debian stable) from::

http://packages.debian.org/cgi-bin/download.pl?arch=all&file=pool%2Fmain%2Fp%2Fpython-docutils%2Fpython-docutils_0.3.7-2_all.deb&md5sum=4f21cac36c65f9edc080bc5b77169c51&arch=all&type=main

and installed using::

sudo dpkg -i  python-docutils_0.3.7-2_all.deb

Installing Docutils from sources

The latest Docutils source release (0.3.9) can be downloaded from::

http://prdownloads.sourceforge.net/docutils/docutils-0.3.9.tar.gz?download

The source is packaged using python Distutils and can be installed using::

sudo python setup.py install