TEI Best Practices

From DPWiki
Jump to navigation Jump to search
Replacement filing cabinet.svg Attention

This page has been kept for Archival and Historical Purposes and does not reflect the latest information and documentation regarding DP. Please see the Official Documentation for the latest information, or ask around on the Forums. Thank you.

Note: PGTEI is no longer used at DP. Information on this page may be out of date.

Here is the on-going results of the Best Pratices discussion in the forums.

See the final example TEI doc at the end.

Title Page

Two ways to create:

(easy) <divGen type="titlepage" />

(hard) Create a manual title page.

TEI Example Doc

<?xml version="1.0" encoding="utf-8" ?>

<!DOCTYPE TEI.2 SYSTEM "http://www.gutenberg.org/tei/marcello/0.4/dtd/pgtei.dtd">

<TEI.2>
<teiHeader>
  <fileDesc>
    <titleStmt><title>Bluntman and Chronic</title>
      <author>Holden McNeil</author>
      <author>Banky Edwards</author>
    </titleStmt>
    <editionStmt><p></p></editionStmt>
    <publicationStmt><p></p></publicationStmt>
    <seriesStmt><p></p></seriesStmt>
    <sourceDesc><p></p></sourceDesc>
  </fileDesc>
  <encodingDesc></encodingDesc>
  <profileDesc></profileDesc>
</teiHeader>

<text>
<front>

<div>
  <divGen type="pgheader" />
</div>

<titlePage rend="text-align: center; page-break-before: right">

  <docTitle>
    <titlePart type="main" rend="font-size: xx-large">Bluntman and Chronic</titlePart><lb />
    <titlePart type="sub" rend="font-size: x-large">(Bonus Points If You Get This Reference)</titlePart>
  </docTitle>

  <byline rend="margin-top: 5; margin-bottom: 5">By <docAuthor>Holden McNeil</docAuthor> and 
    <docAuthor>Banky Edwards</docAuthor>
  </byline>

  <docImprint><name>New York</name><lb />
    <name>View Askew Publishers</name><lb />
  </docImprint>

  <docDate>1997</docDate>
</titlePage>

<div rend="page-break-before: right">
  <index index="pdf" />
  <head rend="text-align: center">Contents</head>
  <divGen type="toc" />
</div>

</front>

<body>

<div rend="page-break-before: right">
<index index="toc" level1="Chapter 1 - Chapters, Sections and Other Major Divisions in a Text" />
<head rend="text-align: center">Chapter 1</head>
<head type="sub" rend="text-align: center">Chapters, Sections and Other Major Divisions in a Text</head>

<p>Instead of using various numbers of blank lines to specify whether something is a chapter break/section/etc., TEI uses 

<div></div> markup to mark a section of text as a separate grouping.  By nesting these <div> markups, 

you can specify sections within chapters within parts ...</p>

<p>Note the "thought-break" below.  You can control the way this renders with the rend attribute.</p>

<milestone unit="tb" rend="stars: 5" />

<p>In this case, we used 5 asterisks.  You can also specify a blank line (default) or a horizontal rule of n% page 

width.</p>

  <div>
  <index index="toc" />
  <head rend="text-align: center">Sub-section to Chapter 1</head>

  <p>By nesting this section inside the previous section, it will appear as a subsection of Chapter 1.  Theoretically, 

this nesting effect could go on into infinity.  I think the farthest nesting I've run across in practice is about 4 

deep.</p>
  </div>

</div>
</body>

<back>

</back>
</text>
</TEI.2>

Results

The HTML results can be viewed here: [1]