[haiku-doc] Re: User Guide: Choosing a language

  • From: Humdinger <humdingerb@xxxxxxxxxxxxxx>
  • To: haiku-doc@xxxxxxxxxxxxx
  • Date: Thu, 23 Jul 2009 17:45:05 +0200

Vincent Duvert wrote:
I think the easiest way to do this would be to add <!-- LANG_MENU --> in the source page, and have a function in the tool to replace this with the actual menu in each generated page.

That's the right way, I guess. Michael Pfeiffer did something quite similar in the docs-buildsystem of BePDF.

Now another question arises: What do we do when not all pages of the user guide are yet translated?

Good question. If a page was not translated in some language, it could be possible to update all links in other pages pointing to this page so they point to the English version but this would be tricky. I'd better generate pages even if they are not translated, or create symlinks.

As you noted, symlinks aren't an option with SVN or when hosting the actual 
HTML online.
Since those are only text files, I guess we wouldn't waste too much space to simply copy the English pages into the {LANGUAGE} folders until a page is at 100% and is replaced by it's translation. ATM the HTML takes ca. 500kb.

We already have a related problem: What about images?

Maybe it would be better to put back the images in a not language-dependant folder, and wait for the apps to be translated for putting them into the {LANG}/ folders :)

Not really a solution, as localized images will be possible soon with Pulkomandy hacking away like this... So, we'll have to deal with that sometime.

ATM the images take ca. 2.5mb. A bit much to go with the redundant-approach of the HTML pages, isn't it? Though, these redundancies become rapidly less taxing once the translations are making headway.

OTOH, we could also use kind of absolute addressing for images, like ../en/images/X.png instead of ./images/X.png and replace /en/ with /{LANGUAGE}/ when generating HTML if there exists a ./images/X.png.

Regards,
Humdinger

--
--=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-=--=-
Deutsche Haiku News @ http://www.haiku-gazette.de

Other related posts: