module: DHQauthor Schema
version: beta
date: October 2005
system: Digital Humanities Quarterly publication system
purpose: For authoring of DHQ article content (and other content)
for: digitalhumanities.org
originaldate: August 2005
creator: Wendell Piez for DHQ
contact: http://digitalhumanities.org/twiki/dhquarterly
credits: By Julia Flanders and Wendell Piez, derived informally from TEI and tuned for this application. Thanks to Syd Bauman, Kim Tryka, various assorted DHQers....
68 elements total listed in this schema.
Elements expected at the top of a text or division.
Referred to by [element.text]; [element.div]; [element.xtext]; [element.appendix].
Basic block-level elements for prose, verse or drama
Referred to by [abstract-contents]; [element.text]; [element.div]; [element.xtext]; [element.letter]; [element.ps]; [element.cell]; [element.quote-block]; [element.item]; [element.list-glossary]; [element.note]; [element.example]; [element.figure]; [element.caption]; [element.appendix].
These are elements that can appear mixed with text in some contexts (inside <p> for example), but that are ordinarily likely to appear at the paragraph level (i.e. mixed with blocks).
Referred to by [abstract-contents]; [element.text]; [element.div]; [element.xtext]; [element.letter]; [element.ps]; [element.cell]; [element.quote-block]; [element.item]; [element.list-glossary]; [element.p]; [element.note]; [element.example]; [element.figure]; [element.caption]; [element.appendix].
These are self-contained textual artifacts that may appear inside other texts (probably inside discursive elements like <quote>, or mixed with blocks. In more constrained DHQ ML applications such as DHQauthor, these should ordinarily not nest more deeply than one.
Referred to by [element.text]; [element.div]; [element.quote-block]; [element.note]; [element.example]; [element.figure]; [element.appendix].
inline elements (which include inline elements) are always mixed with text
DHQcrayonbox can add <seg> to this list
Referred to by [element.cell]; [element.quote-inline]; [element.quote-block]; [element.item]; [element.p]; [element.l]; [element.stage]; [element.note]; [element.caption]; [element.label]; [element.emph]; [element.called]; [element.hi]; [element.foreign].
Inline elements allowed to be mixed with text in restricted contexts such as article metadata
Referred to by [title-contents]; [subtitle-contents]; [teaser-contents].
Various sorts of inline elements marking up spans or phrases with various sorts of semantic information.
Referred to by [inline]; [metadata-inline]; [element.head]; [element.q]; [element.ref]; [element.title].
Several inline links are available, both internal and external.
Referred to by [inline]; [bibl-content]; [element.epigraph]; [element.cit].
References to binary data formats may appear in several forms.
Referred to by [inline]; [element.epigraph]; [element.example]; [element.figure].
Several elements are available to facilitate the description of (XML) encoding systems. Mostly for internal use.
Referred to by [inline]; [metadata-inline].
Articles are comprised of a text plus several optional supplemental elements (back matter).
Referred to by [element.DHQarticle]; [element.DHQdraft].
Bibliography items are specified as a mix of text with a set of descriptive elements describing a given cited work (and implicitly providing some of its metadata).
Referred to by [element.bibl-reviewTarget]; [element.bibl].
As of yet we have no global attributes.
Referred to by [element.DHQarticle]; [element.DHQdraft]; [element.DHQinclude]; [element.text]; [element.head]; [element.epigraph]; [element.div]; [element.xtext]; [element.letter]; [element.ps]; [element.closer]; [element.opener]; [element.dateline]; [element.salute]; [element.signed]; [element.table]; [element.row]; [element.cell]; [element.cit]; [element.quote-inline]; [element.quote-block]; [element.q]; [element.list]; [element.item]; [element.list-glossary]; [element.eg]; [element.p]; [element.lg]; [element.l]; [element.sp]; [element.speaker]; [element.stage]; [element.note]; [element.example]; [element.figure]; [element.graphic]; [element.media]; [element.caption]; [element.figDesc]; [element.label]; [element.name]; [element.emph]; [element.term]; [element.code]; [element.called]; [element.hi]; [element.foreign]; [element.ref]; [element.ptr]; [element.figures]; [element.notes]; [element.listBibl]; [attlist.bibl]; [element.vol]; [element.date]; [element.author]; [element.editor]; [element.pubPlace]; [element.publisher]; [element.idno]; [element.price]; [element.extent]; [element.gi]; [element.att]; [element.val]; [element.tag]; [element.class]; [element.appendix].
@idUniqueness is assumed to be checked by a subsequent process. Functionalities depending on @id values, such as cross-referencing between elements, assume uniqueness within document scope (at least).
Referred to by [element.div]; [element.xtext]; [element.letter]; [element.table]; [element.row]; [element.cell]; [element.item]; [element.list-glossary]; [element.note]; [element.example]; [element.figure]; [attlist.bibl]; [element.appendix].
@rendA hint to the processor as to the preferred rendition.
Referred to by [element.eg]; [element.hi].
DHQarticleAn article for DHQ, comprising metadata (a header) plus the article proper (main text and optional back matter). The <DHQheader> element is required.
DHQdraftA draft of an article for DHQ. Its <DHQheader> is optional (for authors' convenience). For submission to DHQ, a header should be completed and this element changed to (and validated as) <DHQarticle>.
DHQincludeMaterial included by reference not by value: expected to be transcluded where possible. Typically this is material not in DHQ ML, maintained in DHQ "Zone II" or "Zone III".
DHQinclude/@targetThe unique identifier (@id) of the target element, as described in a bibl in the header.
DHQinclude/@fileResolves as a relative URI to a file target.
DHQinclude/@typeThe declared format of the graphic (a MIME type).
Referred to by [divtop].
A metadata package for the article. In DHQauthor, only metadata for which authors are responsible are required.
This element is provided in a separate module.
Referred to by [element.DHQarticle]; [element.DHQdraft].
Provides additional elements to the contents of <title> elements (in the header).
Provides additional elements to the contents of <subtitle> elements (in the header).
A short synopsis of the argument or principal findings of the article.
A one- or two-sentence short lead to the article, suitable for listing in directories.
textThe main text of an article, essay or review.
Referred to by [article-content].
Compare the TEI P5 description of <text>
headA section head (extractable into a table of contents).
Referred to by [divtop].
Compare the TEI P5 description of <head>
epigraphSemantically similar to <cit>, this element appears at the beginning of a text or division. Its contents must be a <quote> with @type equal to block (which could contain anything), or arbitrary content referenced in an opaque format (<graphic> or <media>).
Referred to by [divtop].
Compare the TEI P5 description of <epigraph>
biblAt the top of a text or division, identifies a work under review. In this context, a <label> element is optional.
bibl/@typeThe value must be reviewTarget in this context.
Referred to by [divtop].
Compare the TEI P5 description of <bibl>
divA generic division (chapter, part, section or subsection) within a text.
Arbitrarily deep nesting is supported, but <div>, when it appears, can be followed only by <div> elements. This allows for unambiguous rendition in conventional print layouts, plus straightforward representation of text structure by mapping divs or their heads in outline (table of contents) format. If "loose" divs are desired (or to put in another way, if you wish to "come out of" a subsection and resume the containing section where you left off), try <xtext>.
div/@typeDescribes the type of division (chapter, section or whatever). No processing currently takes advantage of this information.
Referred to by [element.text]; [element.div]; [element.xtext]; [element.letter]; [element.ps]; [element.appendix].
Compare the TEI P5 description of <div>
xtextAn interpolated text or text fragment. In DHQauthor, this should not nest arbitrarily.
In DHQcrayonbox, we may allow <xtext> directly in <xtext>.
Referred to by [texts]; [element.div]; [element.appendix].
letterA text structured as a letter, with salutation and signature.
Referred to by [texts]; [element.xtext].
psA postscript to a <letter>.
Referred to by [element.letter].
closerA group of elements closing a <letter>.
Referred to by [element.letter]; [element.ps].
Compare the TEI P5 description of <closer>
openerA group of elements opening a <letter>.
Referred to by [element.letter]; [element.ps].
Compare the TEI P5 description of <opener>
datelineThe place and/or date of a letter or dated item.
Referred to by [element.closer]; [element.opener].
Compare the TEI P5 description of <dateline>
saluteThe salutation of a letter.
Referred to by [element.closer]; [element.opener].
Compare the TEI P5 description of <salute>
signedThe signature or signature line of a letter.
Referred to by [element.closer].
Compare the TEI P5 description of <signed>