Home
Reference
Reference information on editorial practices, TEI-encoding standards, and image sources.
TEI Style Manual
TEI encoding practices for the Knowledge Project.
Subdivisions
Encoding for subdivisions in entries, planned for r2.

Reference
Reference information on editorial practices, TEI-encoding standards, and image sources.
- Editorial standards
  The following editorial principles are employed in creating this digital edition.
- Image Sources
  Bibliographic information on image sources.
- Naming Conventions
  Lists the naming conventions we use for editions, sections, folders, and files.
- TEI Style Manual
  TEI encoding practices for the Knowledge Project.
  - Author Names
    Encoding author initials at the end of entries.
  - Bidirectional Text
    Managing Hebrew and Arabic Text
  - Callouts
    How to encode callouts included in the text from the 11th ed. supplied by Project Gutenberg.
  - Choice
    Use <choice> to encode alternate versions
  - Citation, Drama, Speech, and Verse
    Encoding elements for verse and drama passages, planned for r2.
  - Cross References
    Encoding for cross references, planned for r2.
  - Entry Terms
    Encoding entry terms.
  - Foreign Text
    Tagging words or phrases in a different language, planned for r2.
  - Formulas
    Encoding math and chemical formulas in TEI, planned for r2.
  - Images
    Treatment of images in EB11 files from Project Gutenberg.
  - Keywords
    Working with indexing in TEI
  - Lists
    Formatting lists in TEI
  - Music
    Encoding musical notes and staffs, planned for r2.
  - Notes
    TEI encoding of foot- and marginal notes.
  - Page Numbers
    Specifies encoding method for page numbers in TEI.
  - Source Text Problems
    Indicate where text in the print edition is missing, illegible, or incorrect.
  - Subdivisions
    Encoding for subdivisions in entries, planned for r2.
  - TEI tag
    Encoding instructions for the TEI tag
  - Typographical Values
    TEI encoding we use for semantically significant typographical features, with their CSS equivalents.
- Unicode Characters
  List of Unicode characters and entities used frequently in the Encyclopedia and not on the standard US keyboard.

Subdivisions

Encoding for subdivisions in entries, planned for r2.

Use <div> codes with the appropriate @type to indicate subdivisions of long entries. Use <head> for section headings.


`@type` value	level	usage
entry	1	The outermost tag for the entire entry. See Page Numbers.
section	2	A subdivision nested within an entry.
subsection	3-∞	A subdivision nested with a section or a subsection.
index	2	An index section for an entry.

If a section has both a heading and a subheading immediately following, but there are no subsections, then add @type="sub" to <head> instead of creating a new <div>. If a section has multiple subsections, then use <div>s to define them.

This is a minimalist encoding scheme that leaves room for further refinement, with additional <div>s for things like poems and quotes. For now, we are just trying to encode the sections already identified in the entry by the author.

Example:

<div type="entry">
   <p><label>STEAM</label></p>
      <div type="section">
         <head>SECTION I — THE GENERAL NATURE OF STEAM.</head>
                . . .
               <div type="subsection">
                    <head>Pressurization</head>
                    . . .
                </div>
       </div>
</div>