<comment>
Comment in a Citation
Container element for unstructured text within a bibliographic reference.
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>.
Attributes
Content Model
<!ELEMENT comment (#PCDATA %comment-elements;)* >
Expanded Content Model
(#PCDATA | email | ext-link | uri | inline-supplementary-material | related-article | related-object | bold | fixed-case | italic | monospace | overline | roman | sans-serif | sc | strike | underline | 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)*
Description
Any combination of:
- Text, numbers, or special characters
- Linking Elements
- Related Material Elements
- Emphasis Elements
- <alternatives> Alternatives For Processing
- Inline Display Elements
- Inline Math Elements
- Math Elements
- Other Inline Elements
- Internal Linking Elements
- Baseline Change Elements
This element may be contained in:
Example 1
In an element-style bibliographic reference (punctuation and spacing removed):
... <ref> <element-citation publication-type="commun"> <person-group> <name><surname>Nightingale</surname> <given-names>Florence</given-names></name> </person-group> <comment>115 Park Street, W, [London, GB]</comment> <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> ...
Example 2
Reference translated from Chinese to English that also includes a transliteration of the Chinese characters:
...
<ref id="CIT0005">
<label>Bā (z.j.)</label>
<mixed-citation publication-type="book">
<person-group person-group-type="author">
<name-alternatives>
<string-name name-style="eastern" xml:lang="zh">巴金</string-name>
<string-name><surname>Bā</surname> <given-names>Jīn</given-names>
</string-name>
</name-alternatives>
</person-group>, <source xml:lang="zh-Hant">第四病室</source>
<trans-source content-type="transliteration">Dì sì bìngshǐ</trans-source>
[<trans-source xml:lang="en">Ward number 4</trans-source>].
<publisher-loc>香港 Hong Kong</publisher-loc>:
<publisher-name>南國出版社 Nánguó Chūbǎnshè</publisher-name>,
<comment>n.y. Probable year of publication between 1956 and
1964</comment>.</mixed-citation>
</ref>
...