How can I change from docbook to restructuredText?

Posted by Paul Biggar on Stack Overflow See other posts from Stack Overflow or by Paul Biggar
Published on 2009-05-17T14:29:55Z Indexed on 2010/05/09 17:08 UTC
Read the original article Hit count: 414

Filed under:

docbook

|

restructuredtext

|

jade

|

documentation

|

html

I have a 30-ish page manual in docbook. However, working with docbook is so painful that I don't really update it. I want to switch to restructedText instead.

I can't find any direct translator (the best I could find is ezComponents, but it fails on the docbook sgml). Maybe there is an indirect route through RTF or some other format, but I can't figure it out.

Any ideas?

PS The current conversion process is:

docbook -> jade -> html
docbook -> jade -> tex -> pdflatex -> pdf

© Stack Overflow or respective owner

Related posts about docbook

Docbook-xslt chapter id matching

as seen on Stack Overflow - Search for 'Stack Overflow'
Dear all, I would like to write a xslt rule if it matches a certain chapter ID that it sets autolabel to zero on the section. in pseudo code: IF CHAPTER == LOGBOOK SECTION.AUTOLABEL = 0 ELSE SECTION.AUTOLABEL = 1 ENDIF But after reading the docbook xsl website and docbook xsl reference… >>> More
problem with image urls in htmlhelp created by docbook xsl

as seen on Stack Overflow - Search for 'Stack Overflow'
I have a Docbook XML document that has some images with special characters in their names (German umlauts). I'm using Saxon 6.5.5 and the Docbook xslt Stylesheets to create HTMLHelp files based on that document. Unfortunately the filenames are then url-encoded (% and hexadecimal code), which internet… >>> More
DocBook macros?

as seen on Stack Overflow - Search for 'Stack Overflow'
Is there any way of defining macros (like tex macros o latex defines) in DocBook documents? DocBook is very verbose, and macros would help a lot. I didn't find them in quickstart tutorials. If so, could anyone provide a simple example or a link to? Thanks >>> More
DocBook sources of "Starting with Lift"

as seen on Stack Overflow - Search for 'Stack Overflow'
By the looks of it, I wouldn't be surprised if "Starting with Lift" has been created from DocBook. I looked in Lift's Git repositories, but I haven't been able to find the source DocBook documents. So, is it really based on DocBook? And if it is, is it available from some public repository? >>> More
Using RDFa with DITA and DocBook

as seen on Internet.com - Search for 'Internet.com'
Learn how to add RDFa metadata to DITA and DocBook documents, how to keep those documents valid, and what advantages this technique can bring to a DITA- or DocBook-based publishing system. >>> More

Related posts about restructuredtext

reStructuredText tool support

as seen on Stack Overflow - Search for 'Stack Overflow'
I love reStructuredText, however the tools that support it are scattered all over the Internet. The official tool list is incomplete and/or outdated, and can be updated only via commit privileges. For some time there was a comprehensive list at the Wikipedia reStructuredText page, but this apparently… >>> More
editors for tables in Sphinx/reStructuredText?

as seen on Stack Overflow - Search for 'Stack Overflow'
I'm looking at using Sphinx / reStructuredText for documentation, and it looks very promising, except tables look like a pain to do. Is there an editor that can help? >>> More
Sphinx, reStructuredText show\hide code snippets

as seen on Stack Overflow - Search for 'Stack Overflow'
Hi, I've been documenting a software package using Sphinx and reStructuredText. Within my documents, there are some long code snippets. I want to be able to have them hidden as default, with a little "Show\Hide" button that would expand them (Example). Is there a standard way to do that? If not… >>> More
How can I change from docbook to restructuredText?

as seen on Stack Overflow - Search for 'Stack Overflow'
I have a 30-ish page manual in docbook. However, working with docbook is so painful that I don't really update it. I want to switch to restructedText instead. I can't find any direct translator (the best I could find is ezComponents, but it fails on the docbook sgml). Maybe there is an indirect route… >>> More
Compare and contrast the lightweight markup languages (Textile, Markdown, and reStructuredText)

as seen on Stack Overflow - Search for 'Stack Overflow'
Please identify the most popular lightweight markup languages and compare their strengths and weaknesses. These languages should be general-purpose markup for technical prose, such as for documentation (for example, Haml doesn't count). See also: Markdown versus ReStructuredText >>> More