Re: [dita] More Catalog Errata: Public ID for RNG MathML Module

[Eliot Kimber <ekimber@contrext.com>]

I have defined an improvement to the mathmlDomainProxy.rng that simplifies
the integration of the MathML domain with new topic types.

The correction is to change the current definition to this:

<grammar
   xmlns="http://relaxng.org/ns/structure/1.0";
   xmlns:a="http://relaxng.org/ns/compatibility/annotations/1.0";
   datatypeLibrary="http://www.w3.org/2001/XMLSchema-datatypes";>

   <include href="mathml/mathml3/mathml3.rng">
     <define name="anyElement">
       <parentRef name="any"/>
     </define>

   </include>

</grammar>


This simply re-uses the "any" pattern that every topic type shell has to
already define in order to handle ID-type attributes.

Without this change new topic types would need to use modified versions of
the mathmlDomainProxy.rng file in order to add the new topic type name to
the list of elements that have an ID-type attribute. That's clearly no
good.

This change removes that need and eliminates the need for topic type
authors and shell authors to do anything special when integrating the
MathML domain.

I've run this change by George Bina and he agrees that this approach is
sound.

Cheers,

E.


----
Eliot Kimber, Owner
Contrext, LLC
http://contrext.com




On 6/9/16, 11:44 AM, "Eliot Kimber" <dita@lists.oasis-open.org on behalf
of ekimber@contrext.com> wrote:

>I'm doing more exploration of this issue and may have a better solution
>that does not, itself, require topic type specialization shells to
>directly refer to the mathml3.rng file.
>
>This change is still probably warranted just for completeness.
>
>I'm waiting on confirmation from George Bina that my adjustment to the
>mathmlDomainProxy.rng file is appropriate, but if it works it provides a
>significant simplification for topic specialization authors without
>requiring any change to any existing topic type shells.
>
>Cheers,
>
>E.
>
>----
>Eliot Kimber, Owner
>Contrext, LLC
>http://contrext.com
>
>
>
>
>On 6/9/16, 9:35 AM, "Eliot Kimber" <dita@lists.oasis-open.org on behalf of
>ekimber@contrext.com> wrote:
>
>>In order to properly configure the integration of the MathML domain into
>>specialized topic types it is necessary to create local versions of the
>>OASIS-supplied mathmlDomainProxy.rng file. The OASIS-supplied file uses a
>>direct URI reference to the mathml/mathml3/mathml3.rng file. However,
>>non-OASIS users will want to use a URN to refer to this file.
>>
>>Thus we need to add a catalog entry to the RNG catalog for the
>>mathml/mathml3/mathml3.rng file.
>>
>>My proposal would be to add this entry to the
>>rng/technicalContent/catalog.xml file:
>>
>><uri name="urn:oasis:names:tc:dita:rng:mathml3.rng"
>>           uri="rng/mathml/mathml3/mathml3.rng"/>
>>
>>
>>I'm deliberately using an OASIS-managed name because this is a
>>DITA-specific use of the MathML module and we do not want the possibility
>>of a different version of this module being used in a DITA context.
>>
>>
>>Cheers,
>>
>>Eliot
>>----
>>Eliot Kimber, Owner
>>Contrext, LLC
>>http://contrext.com
>>
>>
>>
>>
>>---------------------------------------------------------------------
>>To unsubscribe from this mail list, you must leave the OASIS TC that
>>generates this mail.  Follow this link to all your TCs in OASIS at:
>>https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
>>
>>
>
>
>
>---------------------------------------------------------------------
>To unsubscribe from this mail list, you must leave the OASIS TC that
>generates this mail.  Follow this link to all your TCs in OASIS at:
>https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php
>
>