Journal of the Text-Encoding Initiative Article Schema
Schema and guidelines for encoding an article for the journal

3. Basic Text Structure

A jTEI journal article is a relatively simple TEI document consisting of a teiHeader and a text.

3.2. Front Matter

The front matter must consist of an abstract, encoded in <div type="abstract">. This should consist of one or two short paragraphs, covering the purpose and content of the article.

The only other thing that may appear in the front matter is a brief acknowledgements section. If you need to include this to acknowledge contributors, funding agencies etc., insert it after the abstract, encoded as <div type="acknowledgements">. It should be no longer than one short paragraph.

3.3. The Body

The content of the article appears in the body. It should be divided into sections using div elements. Each div element should have an xml:id attribute, and its first child should be a head element with a suitable heading (in title case). div elements may be nested to provide subsections.

Do not provide section numbering in explicitly in the heads of your divs. These will be provided automatically by the rendering tools.

3.4. Back Matter: the Bibliography and Appendices

The back matter consists of a bibliography (required), which is encoded in <div type="bibliography">, and optional appendices, each of which if present must be encoded using <div type="appendix">. Appendices must appear after the bibliography.

The bibliography consists of a listBibl element containing a series of bibl elements. Each bibl element should contain a reference formatted as required by the Chicago Manual of Style (16th edition), including all required punctuation, with a couple of exceptions:

  • Do not provide quotation marks around article titles. Instead, tag them with <title level="a"> (for chapters or contributions in a monograph, or journal articles) or <title level="u"> (for unpublished materials). The rendering tools will then provide the quotation marks.
  • Tag titles that would normally be in italics using <title level="j"> (for journal titles) or <title level="m"> (for monographs).

Give each bibl element a unique xml:id attribute, so that you can link to it from the quotations in the body of your text. In your bibliography entries, put the appropriate tags around the following components:

  • titles: title, with an appropriate value for level (see above)
  • editions: edition
  • dates: date
  • authors: author
  • editors: editor
  • publishers: publisher
  • publication places: pubPlace
  • name of series: series
  • scope of a bibliographic reference: biblScope, with an appropriate value for unit (volume, issue, page, chapter, part)
  • id numbers such as DOIs: idno, with an appropriate value for type
  • web urls (use ref)

Note: if you have both a formal identification number such as a DOI code and a hyperlink to an online version, the DOI code should be placed last in the bibliographic description.

Here is a short example:

<div xml:id="bibliography"
 type="bibliography">

 <listBibl>
  <bibl xml:id="aoki07">
   <author>Aoki, Paul M.</author>
   <date>2007</date>.
  <title level="a">Back Stage on the Front Lines: Perspectives and
       Performance in the Combat Information Center</title>. In
  <title level="m">Proceedings of the SIGCHI Conference on
       Human Factors in Computing Systems</title>,
  <biblScope unit="page">717–26</biblScope>. CHI ’07.
  <pubPlace>New York</pubPlace>: <publisher>ACM</publisher>. <ref target="http://doi.acm.org.ezproxy.lib.utexas.edu/10.1145/1240624.1240735"> http://doi.acm.org.ezproxy.lib.utexas.edu/10.1145/1240624.1240735
   </ref>. doi:<idno type="doi">10.1145/1240624.1240735</idno>.
  </bibl>
  <bibl xml:id="banski10">
   <author>Bański, Piotr</author>. <date>2010</date>.
  <title level="a">Why TEI Stand-off Annotation Doesn’t Quite Work and
       Why You Might Want to Use It Nevertheless</title>. In
  <title level="m">Proceedings of Balisage: The Markup Conference 2010</title>.
  <series>Balisage Series on Markup Technologies</series>,
  <biblScope unit="volume">vol. 5</biblScope>.
     doi:<idno type="doi">10.4242/BalisageVol5.Banski01</idno>.
  </bibl>
  <bibl xml:id="bowers12">
   <author>Bowers, John</author>. <date>2012</date>.
  <title level="a">The Logic of Annotated Portfolios: Communicating the
       Value of <soCalled>Research through Design.</soCalled>
   </title> In
  <title level="j">Proceedings of the Designing Interactive Systems
       Conference</title>, <biblScope unit="page">68–77</biblScope>.
  <title level="s">DIS ’12</title>. <pubPlace>New York</pubPlace>:
  <publisher>ACM</publisher>. doi:<idno type="doi">10.1145/2317956.2317968</idno>.
  </bibl>
<!-- ... -->
 </listBibl>
</div>

TEI Guidelines Originally generated on 2014-01-30T13:29:15Z using oddbyexample.xsl. Progressively modified after that.. This page generated on 2015-04-06T13:16:09Z.