On Tue, 31 Jul 2001, Hojtsy Gábor wrote:

> >If Damien use his French ENTITY's, there is nothing wrong to 
> >put them into global.ent. 
> 
> globals.ent should contain global entities, as the name suggest.
> Language only entities should go IMHO to language-defs.ent
> (see hu dir). We started faqurls.ent for the same reason. This
> way you can find entities where they should be.
> 
> Goba

Language-only entities can (like any kind of errors) break the whole
documenting system. I'm not saying that all the translations should be the
same, and have exactly the same (link) entities. Actually, I think I'm
seconding Goba.

SO:

I'm not very sure what I'm writing about (had a few beers too much), but
it should be possible within the DSSSL / our configuration framework, to
just detect which version of a language specific *.ent should be used. I
mean after global.ent, overriding or adding something to it, according to
the needs of the translation team.

There is even a good example of this:

cat de/language-defs.ent
<!ENTITY PHPManual              "PHP Handbuch">
<!ENTITY Date                   "Datum:">
<!ENTITY GettingStarted         "Einführung">
<!ENTITY LanguageReference      "Sprachreferenz">
<!ENTITY Features               "Features">
<!ENTITY FunctionReference      "Funktionsreferenz">
<!ENTITY Appendixes             "Anhang">
<!ENTITY PEAR             "PEAR: the PHP Extension and Application
Repository">
<!ENTITY FAQ             "FAQ: Frequently Asked Questions">

Egon, this is something we have already been using quite many years. Now,
please fix that file :-; (But then some crazy guys added that PEAR and
FAQ. What the hell do they think about, especially with PEAR, that's
somewhat recent. ('FAQ' is not recent, many of those questions finally
answered are years old)

Yeah, it's possible that I haven't got a slightest idea what I'm writing
about. Just ranting.

-- Jouni

Reply via email to