DHQ Tag Menagerie (Monkey House)

DHQ Tag Menagerie

There's nothing like a good epigraph.

Anonymous

This tag menagerie describes, and enacts, the tags available in the DHQ authoring schema. To see how any of the features in this document are encoded, just take a look at the source. The formatting, of course, is controlled by a stylesheet. If you're familiar with the TEI, you'll find the DHQ schema very familiar. It sticks close to vanilla TEI in many ways, but introduces some modifications to simplify authoring and to provide some added flexibility.

Heads are allowed but not required for each division of the text. Other things (like figures, tables, and bibliographic entries) have labels rather than heads; a head is something that might get listed in a table of contents for the article.

A DHQ document can consist of just paragraphs, but if it has any sections in it they should be encoded with <div>.

Basic block-level features

DHQ markup allows block quotes, which may contain prose or verse. Here's one with a line group: From perfect grief there need not be Wisdom, or even memory; One thing then learnt remains to me: — The woodspurge has a cup of three

And here's another with some prose: The block quote can contain either paragraphs or ordinary text with inline markup (discussed in the next section).

Along with your usual run of paragraphs, such as this one, it's also possible to write in verse (in addition to quoting it).

What's worse Is verse

Paragraphs can also include things that are explicitly marked as examples, such as: An example

Examples appear in many shapes and sizes, being another recursive structure (and hence, source for much fun and many confusions).

...but then going on to conclude with the end of the paragraph.

You can include simple tables in your markup, consisting of rows and cells, with a label at the top and a caption to follow:

German Immigration to the US since 1820 Decade Total Immigration German % of Total 1820-29 128,502 5,753 4.5 1830-39 538,381 124,726 23.2 1840-49 1,427,337 385,434 27.0 1850-59 2,814,554 976,072 34.7 1860-69 2,081,261 723,734 34.8 1870-79 2,742,137 751,769 27.4 1880-89 5,248,568 1,445,181 27.5 1890-99 3,694,294 579,072 15.7 1900-09 8,202,388 328,722 4.0 1910-19 6,347,380 174,227 2.7 1920-29 4,295,510 386,634 9.0 1930-39 699,375 119,107 17.0 1940-49 856,608 117,506 14.0 1950-59 2,499,268 576,905 23.1 1960-69 3,213,749 209,616 6.5 1971-80 4,493,000 66,000 1.5 1981-88 4,711,000 55,800 1.2 Totals 49,753,412 7,028,258 14.1

Lists

Lists can go anywhere, and come in many flavors. They can be simple and unadorned, like this one, which lists the kinds of lists you can have: bullet lists numbered lists plain "unordered" lists glossaries etc. etc.

Bulleted (unordered lists are also an option: bullet lists numbered lists plain lists glossaries etc. etc.

A glossary list, which should be encoded with a label inside each item: Ectoplasm

An unknown substance which emanates from the bodies of mediums, correlating to supernatural phenomena.

EMF Detector

Instrument that measures electrical management fields (sic).

Psychic Cold

The cold sensation received when a spirit is present, usually having defined boundaries.

And finally, a numbered (ordered list; the numbers are generated by the stylesheet: First thing Second thing Third thing

Phrase-level markup

DHQ thinks it's useful to mark interesting features in the content of articles, as well as the overall structure, and we include a number of tags for that purpose. Paragraphs (and similar things like block quotes, verse, abstracts, etc.) may include inline quotations from other sources (to be or not to be?) text which is in quotes to draw attention to it (this documentation scarcely deserves the name). Then there are cited quotes, provided with references, such as to be or not to bePiez 2008Wendell Piez 2008. They might also have special terminology (terms), or terms from some other lingua franca, unfairly called foreign. They have code||pseudo-code and emphasized text (by which we mean stressed). We also suggest that you mark up significant names like Roberto Busa, as well as titles of articles, journals, and books (What is Text Really?, Digital Humanities Quarterly, The Blackwells Companion to Digital Humanities).

Paragraphs can also include examples of code or encoding, such as this bit of stylesheet: <xsl:template match="q:eg"> <pre class="eg"> <xsl:apply-templates/> </pre> </xsl:template>If you want to include examples of XML markup, enclose them in a CDATA marked section (as in the example just given).

Finally, there's an all-purpose hi tag, capable of providing various sorts of inline rendering, alone or together, such as bold, italic, bold italic, quotes, bold quotes superscript, italic superscript, bold monospace underline, and even bold monospace underline strikethrough x. Whew!

Figures, notes and cross-references

You can include as many figures as you like. They're encoded in several parts (view the source of this document to see how the following example is encoded). The essential bits are the pointer to the graphic itself, and the figure description (which is provided for accessibility reasons). You can also include a label at the top and a descriptive caption at the bottom.

While figures can appear anywhere in the text (like this one), they may also be relegated to a special section in the back matter (for more convenient conversion from some formats into DHQauthor). Any given figure should appear only once, however; if you place any figures at the end, you may refer to them in the text but you need not duplicate them there.

Screen shot from Cybergeography A screen shot showing a multidimensional display of an information universe. This screen shot was taken on September 5, 2007, and shows...

References to works cited should take the form of a <ptr> element whose target attribute points to one of the works in your bibliography. The appropriate citation will be generated automatically, along with its punctuation and any internal location (coded with a loc attribute) you may have assigned it. Additionally, anomalously-formatted references can be coded simply by creating a hyperlink with a ref: (Anon., 1995). The bibliography for your article will go at the end. You can also insert references to external sites (such as the World Wide Web Consortium), either as web-style links (like that one) or as simple ptr elements whose link content will be generated, such as ). Finally, you can cross-referenceto other sections in the text.

You can also include notes, such as this oneA note provides commentary and extra information and even references to citations DHQ 2006DHQ committee. Citations and their misuses. DHQ 0, 2006.. But any citation (bibl) elements used here will be displayed with the other citations in the back matter, just as usual. if you like. Notes can be encoded inline, or at the end of the document (in a notes element), and simply referenced with a ptr.. (You can also refer to a note more than once using ptr.)

Included texts

Sometimes you need to be able to embed an entire text inside your own text--it might be a sample document, or an extended quotation that has internal subdivisions and can't easily be accommodated using the <quote< element. We provide a special element called xtext which can go within <div> or <text>. It has the same basic internal structure as <text>.

A sample xtext

The first division Which contains another xtext.

Stories inside stories; Scheherezade, eat your heart out. This nesting of xtexts is permitted by the schema, but expect to get warnings for it (you shouldn't do it without a good reason).