Jean Jordaan wrote: > > I have a question regarding verbosity and appropriateness of tags. > > Using the entity style of writing, I might have for example:: > > <!ENTITY gui "<acronym>GUI</acronym>"> > <!ENTITY sql "<acronym>SQL</acronym>"> > <!ENTITY api "<acronym>API</acronym>"> > <!ENTITY ie "<foreignphrase><acronym>i.e.</acronym></foreignphrase>"> > > Using XXE's preferred 'xi:include' mechanism, that becomes, I believe:: > > <glossentry> > <glossterm>gui</glossterm> > <glossdef> > <phrase id="gui">"<acronym>GUI</acronym>"</phrase> > </glossdef> > </glossentry> > > <glossentry> > <glossterm>sql</glossterm> > <glossdef> > <phrase id="sql">"<acronym>SQL</acronym>"</phrase> > </glossdef> > </glossentry> > > <glossentry> > <glossterm>api</glossterm> > <glossdef> > <phrase id="api">"<acronym>API</acronym>"</phrase> > </glossdef> > </glossentry> > > <glossentry> > <glossterm>ie</glossterm> > <glossdef> > <phrase > id="ie">"<foreignphrase><acronym>i.e.</acronym></foreignphrase>"</phrase> > </glossdef> > </glossentry> > > When referencing, the entity case would look like:: > > the day-to-day operation of &system;, including > > The 'xi:include' case looks like:: > > the day-to-day operation of > <xi:include href="./terms.xml" > xmlns:xi="http://www.w3.org/2001/XInclude"; > xpointer="sss" />, including > > Is this an appropriate way of replacing the usage of entities? Is there > a better element than 'glossary' to handle this use case?
No need to use a glossary and phrases just for that. A document containing something as simple as: <para> <acronym id="gui">GUI</acronym>, <acronym id="sql">SQL</acronym>, ... <foreignphrase id="ie"><acronym>i.e.</acronym></foreignphrase>. </para> should work fine. > Is there a way > to make the reference less verbose? No.
