<moduleRef>

<moduleRef> (module reference) references a module which is to be incorporated into a schema.
Moduletagdocs — 22 Documentation Elements
Attributesatt.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) att.readFrom (@source)
prefixspecifies a default prefix which will be prepended to all patterns from the imported module
Status Optional
Datatype 0–1 occurrences of 

<rng:data type="NCName"/>
xsd:NCName
separated by whitespace
Schematron

<sch:rule context="tei:moduleRef">
<sch:report
  test="//*[ not( generate-id(.) eq generate-id( current() ) ) ]/@prefix = @prefix">
The prefix attribute
of a moduleRef element should not match that of any other
element (it would defeat the purpose)</sch:report></sch:rule>
Note
Use of this attribute avoids name collisions (and thus invalid schemas) when the external schema being mixed in with TEI uses a name the TEI or some other included external schema already uses for a pattern.
includesupplies a list of the elements which are to be copied from the specified module into the schema being defined.
Status Optional
Datatype 0–∞ occurrences of 

<rng:data type="NCName"/>
xsd:NCName
separated by whitespace
exceptsupplies a list of the elements which are not to be copied from the specified module into the schema being defined.
Status Optional
Datatype 0–∞ occurrences of 

<rng:data type="NCName"/>
xsd:NCName
separated by whitespace
keythe name of a TEI module
Status Optional
Datatype

<rng:data type="NCName"/>
xsd:NCName
url(uniform resource locator) refers to a non-TEI module of RELAX NG code by external location
Status Optional
Datatype

<rng:ref name="data.pointer"/>
data.pointer
Used by
Contained by
May contain
tagdocs: content
Declaration

<rng:element name="moduleRef">
 <rng:ref name="att.global.attributes"/>
 <rng:ref name="att.global.linking.attributes"/>
 <rng:ref name="att.global.analytic.attributes"/>
 <rng:ref name="att.global.facs.attributes"/>
 <rng:ref name="att.global.change.attributes"/>
 <rng:ref name="att.readFrom.attributes"/>
 <rng:optional>
  <rng:attribute name="prefix">
   <rng:data type="NCName"/>
  </rng:attribute>
 </rng:optional>
 <rng:choice>
  <rng:optional>
   <rng:attribute name="include">
    <rng:list>
     <rng:zeroOrMore>
      <rng:data type="NCName"/>
     </rng:zeroOrMore>
    </rng:list>
   </rng:attribute>
  </rng:optional>
  <rng:optional>
   <rng:attribute name="except">
    <rng:list>
     <rng:zeroOrMore>
      <rng:data type="NCName"/>
     </rng:zeroOrMore>
    </rng:list>
   </rng:attribute>
  </rng:optional>
 </rng:choice>
 <rng:choice>
  <rng:optional>
   <rng:attribute name="key">
    <rng:data type="NCName"/>
   </rng:attribute>
  </rng:optional>
  <rng:optional>
   <rng:attribute name="url">
    <rng:ref name="data.pointer"/>
   </rng:attribute>
  </rng:optional>
 </rng:choice>
 <rng:optional>
  <rng:ref name="content"/>
 </rng:optional>
</rng:element>
element moduleRef
{
   att.global.attributes,
   att.global.linking.attributes,
   att.global.analytic.attributes,
   att.global.facs.attributes,
   att.global.change.attributes,
   att.readFrom.attributes,
   attribute prefix { xsd:NCName }?,
   (
      attribute include { list { xsd:NCName* } }?
    | attribute except { list { xsd:NCName* } }?
   ),
   ( attribute key { xsd:NCName }? | attribute url { data.pointer }? ),
   content?
}
Schematron

<sch:rule context="tei:moduleRef">
<sch:report test="* and @key"> child elements of moduleRef are only allowed when an external module
is being loaded
</sch:report></sch:rule>
Example
<moduleRef key="linking"/>

This includes all objects available from the linking module.

Example
<moduleRef key="linking" exclude="linkGrp link"/>

This includes all objects available from the linking module except for the link and linkGrp elements.

Example
<moduleRef key="linking" exclude="linkGrp link"/>

This includes all objects available from the linking module except for the link and linkGrp elements.

Example
<moduleRef key="linking" include="linkGrp link"/>

This includes only the link and linkGrp elements from the linking module.

Note
If neither include nor exclude is supplied, the effect of this element is to make all the declarations contained by the referenced module available to the schema being compiled. If both attributes are supplied, an ODD processor should signal an error.
A TEI module is identified by the name supplied as value for the ident attribute on a moduleSpec element. The source attribute may be used to specify an online source from which the specification of that module may be read. A URI may alternatively be supplied in the case of a non-TEI module, and this is expected to be written as a RELAX NG schema.