◇◆
<comment> Comment in a Citation
Container element for unstructured text within a bibliographic reference.
Usage/Remarks
Usage
This element is not necessarily a comment in
the formal sense of commentary.
In the <mixed-citation> element, text,
numbers, and special characters such as punctuation are allowed everywhere, so the
element
<comment> will rarely be needed. Inside
<mixed-citation>, any non-specific text can
merely be left as untagged text.
In the <element-citation> element, the
element <comment> can be used to contain
additional information within a citation that is not appropriate in any of the other
specific, named information elements. Typical comments might include:
<comment>[Abstract]</comment> <comment>translated from Russian</comment>
Best Practice
In <mixed-citation>s, the <comment> element should be used only to mark substantive text; it should not be used to mark punctuation that occurs between elements. In contrast, in <element-citation>s, the <comment> element can be used to preserve any text, spacing, remarks, or punctuation that will
not fit in any of the named reference elements. Frequently, there is material at the
end of an element-styled citation that can fit into a <comment>.
Models and Context
May be contained in
Description
Any combination of:
- Text, numbers, or special characters
- Linking Elements
- Related Material Elements
- <hr> Horizontal Rule
- Emphasis Elements
- <bold> Bold
- <fixed-case> Fixed Case
- <italic> Italic
- <monospace> Monospace Text (Typewriter Text)
- <overline> Overline
- <overline-start> Overline Start
- <overline-end> Overline End
- <roman> Roman
- <sans-serif> Sans Serif
- <sc> Small Caps
- <serif> Serif
- <strike> Strike Through
- <underline> Underline
- <underline-start> Underline Start
- <underline-end> Underline End
- <ruby> Ruby Annotation Wrapper
- <alternatives> Alternatives For Processing
- Inline Display Elements
- Inline Math Elements
- Math Elements
- Other Inline Elements
- Internal Linking Elements
- <sub> Subscript
- <sup> Superscript
- <x> X - Generated Text and Punctuation
Content Model
<!ELEMENT comment (#PCDATA %comment-elements;)* >
Expanded Content Model
(#PCDATA | email | ext-link | uri | inline-supplementary-material | related-article | related-object | hr | bold | fixed-case | italic | monospace | overline | overline-start | overline-end | roman | sans-serif | sc | serif | strike | underline | underline-start | underline-end | ruby | alternatives | inline-graphic | inline-media | private-char | chem-struct | inline-formula | tex-math | mml:math | abbrev | index-term | index-term-range-end | milestone-end | milestone-start | named-content | styled-content | fn | target | xref | sub | sup | x)*
Tagged Sample
Unmappable text in element citation
...
<ref>
<element-citation publication-type="commun">
<person-group>
<name><surname>Nightingale</surname>
<given-names>Florence</given-names></name>
115 Park Street, W, [London, GB]
</person-group>
<source>Letter to: Marquis Townshend</source>
<year iso-8601-date="1864-07-27">1864</year>
<month>Jul</month>
<day>27</day>
<size units="leaves">4 leaves</size>
<comment>Located at: Modern Manuscripts Collection,
History of Medicine Division, National Library of
Medicine, Bethesda, MD; MS F 179</comment>
<annotation><p>Nightingale responds to Townshend’s
request on behalf of a Mrs. Montague for funds to
support old nurses</p></annotation>
</element-citation>
</ref>
...