Difference between revisions of "Recommended Practices"

From TEIWiki
Jump to navigation Jump to search
(Introduction)
(div)
Line 61: Line 61:
 
==div==
 
==div==
  
The <front>, <body>, and <back> elements all use the nested <div> structure to organize primary sections as well as child sections. The <div> elements are identified by a unique xml:id, and also have an n attribute to aid in reference. A type attribute is also used to describe the kind of division. Type includes the following values:
+
The <code><front></code>, <code><body></code>, and <code><back></code> elements all use the nested <div> structure to organize primary sections as well as child sections. The <code><div></code> elements are identified by a unique <code>@xml:id</code>, and also have an <code>@n</code> attribute to aid in reference. A <code>@type</code> attribute is also used to describe the kind of division. Type includes the following values:
  
 
<table border="1">
 
<table border="1">

Revision as of 18:59, 19 January 2010

Introduction

These recommended practices are for publishers intending to use TEI P5 as their encoding schema. They are intended to highlight features necessary for publishing both journal articles and books.

General Recommendations

Introduction

This document describes the specifications for the encoding of textual matter in accordance with the Text Encoding Initiative’s Guidelines for Text Encoding and Interchange (P5)

We will be using the following modules as part of our schema:

  • core
  • header
  • textstructure
  • figures
  • linking
  • analysis
  • tagdocs
  • namesdates
  • textcrit
  • verse
  • transcr

This is a working document and as such assumes that further explication will be added as the need arises. Not every element nor attribute has been covered in this document, and the TEI online documentation should be able to assist in clarification. When in doubt, the authors of this document will provide updates to ensure best practices.

Basic Structure: Monographs

<TEI xmlns="http://www.tei-c.org/ns/1.0" xml:id="isbn-book">
 <teiHeader> 
      <!-- header goes here -->
 </teiHeader>
 <text>
      <front>
           <div type="halftitle">[text]</div>
           <titlePage>[text]</titlePage>
           <div type="copyright">[text]</div>
           <div type="dedication">[text]</div>
           <div type="contents">[text]</div>
      </front>
      <body>
           <div type="introduction">[text]</div>  
           <div type="chapter">[text]</div>  
           <div type="chapter">[text]</div>  
           <div type="chapter">[text]</div>  
           <div type="conclusion">[text]</div>     
      </body>
      <back>
           <div type="endnotes">[text]</div>
           <div type="bibliography">[text]</div>
           <div type="index">[text]</div>
      </back> 
 </text>
</TEI>    

text

The <teiHeader> is followed directly by the mandatory <text> element, which contains the textual matter being encoded. The <text> element is broken down into three subelements: <front> for frontmatter, <body> for the main body of the work, and <back> for backmatter. Only the <body> element is required. Additionally, groups of discrete texts can be packaged together in one document using the <group> element as a parent for the separate <text> elements.

div

The <front>, <body>, and <back> elements all use the nested

structure to organize primary sections as well as child sections. The
elements are identified by a unique @xml:id, and also have an @n attribute to aid in reference. A @type attribute is also used to describe the kind of division. Type includes the following values:
Value Description
copyright copyright information
dedication dedication
contents table of contents
frontispiece frontispiece
acknowledgments acknowledgments
preface preface
introduction frontmatter or body introduction
epigraph epigraph
halftitle halftitle
volume volume
part part
chapter chapter
appendix appendix
endnotes endnote section
glossary glossary
bibliography bibliography
index index
colophon colophon
illustrations illustrations
maps maps
ahead ahead
bhead bhead
chead chead
fmhead frontmatter head
bmhead backmatter head
halftitle halftitle
other other
The examples for
elements can be found in other relevant sections.