The element desc
provides a description of a concept, person, or thing referred to by the parent element (or the current document, if the parent element is <head>
). <desc>
is, in effect, a <comment>
about that concept, person, or thing. It has two possible structures, one human-readable and the other computer-readable.
Under the first, human-readable approach, <desc>
takes merely a descriptive text about the entity, optionally with @xml:lang.
If you provide descriptions in other languages, it best to make sure that each version says roughly the same thing.
Under the second, computer-readable approach, <desc>
takes an IRI + name pattern plus <location>
and @href
pointing to a <TAN-c>
file, which provides contextual information about the concept, person, or thing.
Formal Definition
(~metadata-desc
| (@which
| (@href
| (<IRI>
,~metadata-human
,<checksum>
*,<location>
+))))
Defined at:
TAN-core.rng
Caution | |
---|---|
All text must be normalized (Unicode NFC). |
Example 8.118. <desc>
<TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:model-object-refs" TAN-version="2018"> <head> ......... <license> ......... <name>Creative Commons Attribution 4.0 International License</name> <desc>Exclusive of rights held and licenses offered by rightsholders of the source or sources listed below, this data file, insofar as it constitutes an independent work, is licensed under a Creative Commons Attribution 4.0 International License.</desc> </license> ......... <definitions> ......... <algorithm xml:id="xslt1"> ......... <name>Stylesheet to populate a TAN-A-div file from collections.</name> <desc>Stylesheet at: ../do%20things/convert/convert%20TAN%202017%20to%20TAN%202018.xsl</desc> </algorithm> ......... </definitions> ......... </head> ......... </TAN-T>
Note | |
---|---|
Taken from ar.cat.eng.1926.edghill.obj |
Example 8.119. <desc>
<TAN-T id="tag:kalvesmaki.com,2014:tan-t:ar.cat.eng.1926.edghill:semantic-refs" TAN-version="2018"> <head> ......... <license> ......... <name>Creative Commons Attribution 4.0 International License</name> <desc>Exclusive of rights held and licenses offered by rightsholders of the source or sources listed below, this data file, insofar as it constitutes an independent work, is licensed under a Creative Commons Attribution 4.0 International License.</desc> </license> ......... <definitions> ......... <div-type xml:id="ic"> ......... <name>independent clause</name> <desc>used to identify two or more sentence parts that have a subject and predicate and function as a sentence.</desc> </div-type> ......... </definitions> ......... </head> ......... </TAN-T>
Note | |
---|---|
Taken from ar.cat.eng.1926.edghill.sem |