Important: Resolving &productname; entities

classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|

Important: Resolving &productname; entities

Frank Sundermeyer
Hi,

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="osuse">&opensusereg;</phrase><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.

--
Regards
        Frank

Frank Sundermeyer, Technical Writer, Documentation
SUSE Linux Products GmbH, Maxfeldstr. 5, D-90409 Nuernberg
Tel: +49-911-74053-0, Fax: +49-911-7417755;  http://www.opensuse.org/
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: [hidden email]
To contact the owner, e-mail: [hidden email]