Re: building docs

Jean-Marc van Leerdam wrote:
> Hi Steve,
>
> On 03/04/2008, *Stefan Küng* <tortoisesvn_at_gmail.com
> <mailto:tortoisesvn_at_gmail.com>> wrote:
>
> Hi,
>
> As some of you have noticed, the pdf docs for zh_CN is wrong. It
> seems to be a problem with fop-0.25, which I can't find a way around
> (I tried).
>
> I've now converted to using fop-0.94 and also the latest xsl
> stylesheets (1.73.2). After adjusting a lot of our custom xsl files
> I think I have it 'good enough' to commit.
> 'good enough' means that there are still a lot of UI problems left,
> but the docs are readable (even zh_CN as far as I can tell)
>
> I'll commit these changes tomorrow evening (CEST, GMT+2) if nobody
> objects. Of course that means you all have to download the updated
> tools.zip file, otherwise the doc build will fail.
>
> After that commit, I hope that a lot of people will go through the
> different doc types (html, chm, pdf) and report (or even fix?)
> layout/style problems.
>
>
> First off: I am not one of the doc translators, so these remarks may be off.
>
> Would it reduce the amount of work for translators if the English docs
> are tested & fixed first and translations are held back until the docs
> stabilize?
>
> Say take a week to proofread the different English versions of the docs
> & fix any layout glitches and then signal the doc translators to pick up
> again?

That's up to the translators. We don't force them to translate every
change we make to the docs. If they want, they can wait a while until
Simon tells us that the docs are (almost) finished for the 1.5 release.

But that has nothing to do with the changes in the build system. I doubt
that a lot of translators build the docs themselves.

I'm still having problems with the pdf docs though: the images don't get
resized properly to fit the page width - some of the images are way too
big to fit on a page.

Stefan

-- 
        ___
   oo  // \\      "De Chelonian Mobile"
  (_,\/ \_/ \     TortoiseSVN
    \ \_/_\_/>    The coolest Interface to (Sub)Version Control
    /_/   \_\     http://tortoisesvn.net