[PHPTAL] Any updates to translation tools?

[Kornel Lesiński]

On Tue, 23 Aug 2011 06:15:57 +0100, Darrell Hamilton <darrellh at 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