The DHQheader

The DHQheader element in DHQauthor is modeled in a separate module from the main schema. Eventually modules will be even more finely separated, as requirements emerge for DHQpublish. See DHQauthor-header-doc.html for an automated rendering of the schema.

Blank templates can be provided for DHQheader documents (please ask), for editing environments that don't provide tag prompting.

For now (and feel free to complete this!) use examples and sample documents at Download Central for guidance on DHQheader structures.

Note: actual usage for the DHQheader should be the realm of the ME, editors and taggers: authors should not have to provide extensive headers!

DHQauthor rules for the header

Authors are expected to provide certain minimal information for the header; these are required elements in the schema. They include:

• title
• author (one for each author), including name, affiliation, address (optional) and bio
• abstract
• teaser

DHQpublish rules for the header

When an article is made ready for publication, header information must be completed. This primarily includes adding a PublicationStmt, an element not allowed in the DHQauthor model but required by the DHQpublish model.

A sample PublicationStmt looks like this:

<publicationStmt>
  <idno type="DHQarticle-id">00000X</idno>
  <idno type="volume">25</idno>
  <idno type="issue">5</idno>
  <issueTitle>Special 25th Anniversary Issue<!-- 
    look up this value to confirm
    its correctness for the given volume/issue --></issueTitle>
  <articleType>opinion</articleType>
  <date when="2032-04-01">April 1, 2032</date>
  <availability>
    <cc:License xmlns:cc="http://web.resource.org/cc/"
      xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
      rdf:about="http://creativecommons.org/licenses/by-nc-nd/2.5/"/>
  </availability>
</publicationStmt>

Note the following:

• Three distinct idno elements, distinguished by @type. All are required.
• An issue title. This will be the issue the article appears in, for example "Spring 2008"
• The article type, which must be one of a controlled set of values, including "article", "review", "editorial" and "opinion".
• The date of publication
• Licensing information. Using this boilerplate is safe. If the Creative Commons "use with attribution, non-commercial, no derivatives" is not appropriate, raise the issue with the editors, as the schema may have to be extended to allow another value.

All this information will quite possibly be duplicated elsewhere in the system, so take care that it is consistent. It is placed here in order that the article may be self-contained for purposes of processing, distribution and cataloging.

-- JuliaFlanders - 23 Jun 2008