Reading.
Get started

Library / Literature & Fiction

The Project Gutenberg RST Manual

by Marcello Perathoner

Pages
about 18
Category
Literature & Fiction
Language
English
Reading time
19 min at 250 wpm
Start readingThe whole book, as cards or one word at a time. 11 min at 450 wpm in Read mode.

From the opening

Assuming you don't have python yet. If you have either version 2.6 or 2.7 already installed, skip this.

From http://www.python.org/download/releases/2.7/ download the :file:`Windows x86 MSI Installer (2.7)` and run it.

3. Install Groff. (You can skip this step if you don't want to generate plain text files.)

From http://gnuwin32.sourceforge.net/packages/groff.htm download `Complete package, except sources - Setup` (:file:`groff-1.20.1-setup.exe`) and run it.

4. Install TexLive. (You can skip this step if you don't want to generate PDF files.)

This will open the TeX Live installation wizard. Follow the instructions. When in doubt use the defaults.

This will take quite a while. (3 hours on an old Dell Vostro 1000 laptop. It installs about 2.5 GB in 93,000 files.) If you experience download problems, restart the wizard: it will resume the download where it left off.

5. Install HTML Tidy. (You can skip this step if you only want to process RST files and don't want to build EPUBs from HTML input.)

Start | Control Panel | System | Advanced | Environment Variables. Click "Path" in the User variables at the top. Click "Edit"

If the field contains data, go to the end of that data and add a semicolon if there isn't one already and then add the string above.

(Does not work with python 3 yet. If your distribution uses python 3 as default (not likely!), you'll have to parallel install python 2.6 or 2.7.)

# apt-get install python python-setuptools python-lxml # apt-get install groff tidy # apt-get install libpng-dev libjpeg-dev libfreetype6-dev

Note: To get PDF generation to work, you have to use TeX Live version 2009-11 or newer. You can get those from debian testing or unstable. If don't want to switch from debian stable, you have to install TeX Live manually.

Else, to install TeX Live manually, go to http://mirror.ctan.org/systems/texlive/tlnet and download the file :file:`install-tl-unx.tar.gz`. Unpack it. Then::

A short sample. Read the whole book

More to read

Public-domain text from Project Gutenberg, Standard Ebooks or a similar open source. Copyright differs between countries. Rights holder? See our takedown process.