Mailinglist Archive: opensuse-doc (6 mails)

< Previous Next >
[opensuse-doc] Important: Resolving &productname; entities

the entities &productname; &productnamereg; and &productnumber; used to
be resolved by processing instructions, so the product is
automatically set to the value defined with the accompanying variables
in the DC-file.

Although this solution was very convenient, it needed a lot of code in
the SUSE stylesheets that was difficult to maintain. Therefore we
decided to drop that code with the latest version of the
suse-xsl-stylesheets (>= 1.9.6).

From now on the entities &productname; &productnamereg; and
&productnumber; need to be defined as follows in xml/entity-decl.ent:

<!ENTITY productname '<phrase os="osuse">&opensuse;</phrase><phrase
os="sles">&sls;</phrase><phrase os="sled">&sled;</phrase>'>

<!ENTITY productnamereg '<phrase
os="sles">&slsreg;</phrase><phrase os="sled">&sledreg;</phrase>'>

<!ENTITY productnumber '<phrase os="osuse">12.1</phrase><phrase
os="sles;sled">11 SP2</phrase><phrase os="sled">11 SP2</phrase>'>

The only drawback of this solution is that DocBook4/NovDoc does
not allow <phrase> in <literal> and <guimenu>, so you need to fix that
in (very few) places.

Note: The new solution is backwards compatible, so if you do not use
the latest SUSE stylesheets (as available from Documentation:Tools),
yet, switching to the new product* entities will not hurt.


Frank Sundermeyer, Technical Writer, Documentation
SUSE Linux Products GmbH, Maxfeldstr. 5, D-90409 Nuernberg
Tel: +49-911-74053-0, Fax: +49-911-7417755;
SUSE Linux Products GmbH, GF:
Jeff Hawn, Jennifer Guild, Felix Imend├Ârffer, HRB 16746 (AG N├╝rnberg)
"Reality is always controlled by the people who are most insane" Dogbert
To unsubscribe, e-mail: opensuse-doc+unsubscribe@xxxxxxxxxxxx
To contact the owner, e-mail: opensuse-doc+owner@xxxxxxxxxxxx

< Previous Next >
This Thread
  • No further messages