Re: [PHPTAL] DocBook killer

2010-10-27 Thread romtek
2010/10/25 Kornel Lesiński > > BTW: I wonder whether it's better to have one large file for entire > documentation, or one file per chapter? > > I prefer using one file for the entire documentation because it helps me look for things of interest. ___ PH

Re: [PHPTAL] DocBook killer

2010-10-25 Thread Anton Andriyevskyy
I think does not matter as long as you make editing enough simple. Maybe some online tool - so we do not have to download anything? Please work out the most easy way for users to contribute in translation, and then you will get quicker feedback. Even me would like to continue Russian translation i

Re: [PHPTAL] DocBook killer

2010-10-25 Thread Kornel Lesiński
On 25 Oct 2010, at 11:47, Anton Andriyevskyy wrote: > Kornel, I remember that I have not finished translation to Russian, > the problem partially is because there are no useful tools for DocBook. > > Maybe with Markdown we will go faster? > Or it's not related to site translation at all? There a

Re: [PHPTAL] DocBook killer

2010-10-25 Thread Anton Andriyevskyy
Kornel, I remember that I have not finished translation to Russian, the problem partially is because there are no useful tools for DocBook. Maybe with Markdown we will go faster? Or it's not related to site translation at all? Anton Andriyevskyy Expert in Business Automation & Web Development

[PHPTAL] DocBook killer

2010-10-25 Thread Kornel Lesiński
Does anyone have reason for keeping documentation in DocBook format? It's getting on my nerves — xmlto, tool used to generate PHPTAL documentation, is pain to install (triggers avalanche of dependencies), and DocBook markup is inflexible and verbose at the same time. I'd prefer to write documen