Download Central

Welcome to Download Central, which provides access to the information and materials you need to use the DHQ authoring schema.

Now appearing: the beta version of the DHQauthor RNG schema! find more info at DHQauthor Schema

Also see: Conversion Commons, where tools for handling other formats besides DHQ, such as arbitrary (feral) TEI, HTML, MS Office format, Open Office.org format, PDF, what have you ... we collect data and info here.

The DHQ processing infrastructure is based on an XML tag set designed with authoring in mind, specified by schemas and handled by stylesheets made available here. This tag set is currently under development, and we welcome feedback on it by authors and interested others. It is designed to be "TEI friendly", with the expectation that it will ultimately qualify for "TEI Conformable" status at least.

Below you can find a package of RNG schema files to be used for DHQauthor (currently considered to be beta versions), along with a couple of examples (soon to be more).

The schemas and files are designed to be installed and used locally, so please download them if you would like to try them out. Or if you're merely curious, you can simply link to the "Monkey House" tag zoo document. You'll need to use an XML-capable browser such as Firefox. The Tag Zoo demonstrates the use of the DHQ schema; to view the source XML, just choose "view source" in your browser.

On this page:

Example documents and stylesheets

Available in a convenient .zip archive, a collection of sample and starter files with proof and "tagged view" stylesheets: DHQauthor-samples.zip. (Download, inspect and consult the readme.txt for details.)

Note: to validate these documents or DHQauthor documents you create yourself, you will need the Schema files distributed separately.

Included in the .zip package are two stylesheets for viewing DHQauthor documents. Note that neither of these stylesheets is designed to emulate the DHQ look-and-feel as published. (We may have such a stylesheet for use in later stages of proofing, but authors should generally not have to be concerned about this. Let us know if you are an exception to this rule!)

• DHQarticle-proof-html.xsl - a "galley proof" stylesheet designed to render DHQ tagging cleanly into HTML, for authoring and copy editing purposes.
• faux-tagging-html.xsl - this stylesheet renders a DHQauthor document in HTML in a "tagged" rendition emulating raw source code, but somewhat more readably.

Also, link directly to

• DHQ-MonkeyHouse.xml: A tag zoo, a document with examples of tag structures in a DHQauthor document; if your web browser does XML (later IE and Moz-based browsers do; also try Opera and Safari), go ahead and click (now using the proof stylesheet)
• header-draft.xml: A sample DHQheader (for debate and discussion)
• a real-world sample from the journal

Schemas

The DHQauthor schema is the version of the DHQ markup language intended for use by authors in encoding their own articles. DHQ also maintains DHQpublish, the version that is used for published DHQ articles.

DHQ is currently developing a schema that is expressed as a TEI P5 customization.

The current version of DHQauthor is modelled through several specific schema files which are described in more detail below. We are using a Relax NG schema for structural validation of XML instances. This schema does not provide attribute typing or default attribute values. Attributes are defaulted by stylesheets when necessary; non-structural aspects of the documents may be validated by (one or more) Schematron assertion sets. A "minimally valid" document will validate to DHQauthor-schema.rng; a "submission ready" document will also validate to DHQauthor-ready.sch (though the latter also emits warnings about things not strictly prohibited, which we may simply want to know about).

The schema files can be downloaded as a single .zip file: DHQ-schemas.zip which contains the following:

• DHQ-schemas.zip: Now in a .zip! Package of current schema files
• Relax NG schemas
  • DHQauthor.rng: the DHQAuthor main schema module.
  • DHQauthor-header.rng: the module that constrains the DHQheader (the DHQ metadata component)
  • cc-license.rng: the module for the Creative Commons license component of the header; (RDF code for Creative Commons by-nc-nd 2.5 expressed as an RNG schema)
  • DHQpublish.rng: a Schematron assertion set for additional validation; this provides certain checks for preferred practice but is not required for authoring.
  • DHQauthor-ready.sch: "Author ready" schematron schema for constraints beyond those checked by the RNG

For schema documentation please see the DHQauthor Schema page.

Discussion of issues related to use of, and suggestions for changes to, the core model, is archived at (Issues and Suggestions) Discussion of schema development, including other schemas we may need - see Schema Requirements

In addition, document tagging is expected to conform to any guidelines including relevant usage guidelines in schema documentation, or even implicit “house style” (as determined and interpreted by the editors). The tag sets are designed with the intention that such conformance be easy to achieve.

— WendellPiez and friends - last touched 12 Jun 2008

Attachments on this page (synopsis)

• DHQauthor-samples.zip: Sample and starter files, proof stylesheets

• DHQarticle-proof-html.xsl: A "proof" stylesheet (for clean display not final production)

• DHQ-MonkeyHouse.xml: A "tag menagerie" demonstrating tag usage

• DHQ-schemas.zip: DHQ schemas, including DHQauthor, DHQpublish, and related files