Quotations
Posted by mholmes on 15 Dec 2009 in Hit by a bus
Quotes are complicated in this project, because of the need to handle glossing of them. Below is a set of example markups, with explanations.
- Simple inline quote:
<cit><q>This is the quotation that will be rendered inline.</q> <bibl>53</bibl></cit>
Note that the quotation marks are not included in the text itself; these are supplied by the rendering. This enables us to standardize the appearance of quotes, and avoid errors with straight vs. smart quotes. Also, the<bibl>
(page reference or whatever) doesn't require parentheses; these are supplied by the rendering engine. Any<bibl>
element inside a<cit>
element will acquire parentheses. - Simple blockquote:
<cit rend="block"><q>This is the quotation that will be rendered as a block.</q> <bibl>53</bibl></cit>
As above, no parentheses required for the<bibl>
content. Blockquotes like this are encoded inside the paragraph (<p>
) in which they appear. - Blockquote with gloss:
<cit rend="block"><q>This is the quotation that will be rendered as a block.</q> <bibl>53</bibl></cit> <cit rend="block"><q><gloss>This is the gloss of the above quotation.</gloss></q> <bibl>65</bibl></cit>
Note that the gloss may come from a published translation, in which case its<bibl>
will reflect that source; or it may be supplied by the article author, in which case there may not be a<bibl>
element in the second<cit>
. - Inline parenthetical reference:
According to Bloggs, this novel is rubbish <cit><bibl>189</bibl></cit>.
This is just like a normal inline quotation, but there's no quote. The parentheses will be supplied by the processing. (If this seems like overkill, it's because there's a long-term plan to link all such inline references to the bibliographical details at the end of the document. Someday this will be accomplished.) - Inline quote with gloss:
<cit><q><orig>Det er typisk norsk å være god</orig> <gloss>It is typically Norwegian to be good</gloss></q> <bibl>Brundtland</bibl></cit>
This is like a normal quote, but the q tag is subdivided into<orig>
and<gloss>
; the former will be given quotation marks in the rendering, and the latter will get square brackets. - Fragmented quotations: These occur when the quotation is separated from the reference info, and so they can't be contained by the same
<cit>
tag. Each needs its own<cit>
:Bjørn Sørenssen suggests <cit><q>Wild and enthusiastic</q></cit> as a more accurate translation of the title <cit><bibl>235</bibl></cit>.