Hi there

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? Is there a way
to make the reference less verbose?

-- 
jean                                              . .. .... //\\\oo///\\

Reply via email to