README: Docutils2fo 0.6
- Contact:
- paulhtremblay@gmail.com
- Date:
- 2011-09-26
- Copyright:
- This document has been placed in the public domain.
Introduction
This directory contains stylesheets to convert docutils.xml to XSLFO. Once the document is converted to XSLFO, you would convert it to PDF in this way:
rst2xml.py my_file.rst > my_file.xml docutils_to_fo.py my_file.xml > my_file.fo fop my_file.fo my_file.pdf
Or, to do all in one pass:
rst2xml.py my_file.rst | docutils_to_fo.py | fop -fo - -pdf my_file.pdf
Completion
Ability to create custom pages of simple layout, of first page layout, of odd-even layout, and first, odd-even layout.
Sections
Transitions
Paragraphs
Bullet Lists
Enumerated Lists
Definition Lists
Field Lists
Bibliographic Fields
Option List
Line Blocks
Block Quotes
Headers and Footers, with the ability to create custom headers and footers for the first, odd, and even pages; and the ability to create custom headers and footers for the Table of Contents secions for the first, odd, and even pages; and the ability to suppress headers and footers on the first page.
Doctest Blocks
Tables
Footnotes
Citations
Hyperlinks
Interpreted Text
inline Literals
Specific Admonitions
Generic Admonition
Image
Figure
Topic
Sidebar
Parsed Literal Block
Rubric
Epigraph
Highlights
Pull-Quote
Compound Paragraph
Container
documenttion of XSLT stylesheets
Develop code to process XSlT stylesheet (using lxml)
TODO
Python Code
Develop code to read configuration file (in process of doing)
Develop code to check configuration file (in process of doing)
Develop code to output a customized XSLT stylesheet (in process)
Documentaion
Write a quick overview
Write a detailed overview
Limitations
Cannot do transitions as well as latex
Cannot put borders around page
Cannot do sidebars