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

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).

Find out more on how to use the schemas on the page on Getting Started with DHQauthor.

• DHQ-schemas.zip: Now in a .zip! Package of current schema files
• Relax NG schemas
  • DHQauthor.rng: Relax NG schema (currently beta version) for DHQauthor
  • DHQauthor-header.rng: draft schema for the DHQheader subcomponent (you'll need this)
  • cc-license.rng: RDF code for Creative Commons by-nc-nd 2.5 as an RNG schema (should have this too)
  • DHQpublish.rng: Relax NG schema (currently beta version) for DHQpublish (unless you're on editorial or production staff, you don't need this)
  • Schema documentation - see the DHQauthor Schema page
    • or skip to issues related to use of, and suggestions for changes to, the core model, at (Issues and Suggestions)
  • Any other schemas we may need - see Schema Requirements
• Schematron assertion sets
  • DHQauthor-ready.sch: "Author ready" schematron schema for constraints beyond those checked by the RNG
  • Editorial checklists, etc.

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