On Tue, 23 Aug 2011 06:15:57 +0100, Darrell Hamilton <darre...@4over.com>
wrote:
Does anyone have any additional input on this point? From what I've
gathered, pandoc is what you want if your converting between any number
of markup languages. It can convert to DocBook, RST, Markdown, and many
others. Unfortunately, it does not take DocBook as an input format.
pandoc is difficult to install for me. Did you get it working?
DocBook -> HTML -> Markdown might work?
Based on the links provided by Christoph, there are some tools for
converting DocBook to RST, but they appear to be in their infancy. I
have not experimented with them yet.
As a broader question, is Markdown the preferred format? Or is the
format open to general discussion? I do not have a preference at this
time nor do I know enough of the pros/cons of each to say anything about
which is the
better tool for the job, but it might be worth hearing from people who
have more experience with them.
I have slight preference for Markdown, since it uses single backtick for
inline code. reStructuredText is fine though.
The next step would be to look into tool that produces multipage
documentation from the single source file. I don't know of any for
Markdown, so if reStructuredText has good (post)processors, it might be
better. Otherwise, I'll probably write something myself.
--
regards, Kornel Lesiński
_______________________________________________
PHPTAL mailing list
PHPTAL@lists.motion-twin.com
http://lists.motion-twin.com/mailman/listinfo/phptal