SBL 2022 DH Handout

This is a digital handout for my paper, "Introducing Criticus: A suite of tools for transcribing, collating, and creating an apparatus criticus"

screenshot of Criticus version 0.38.1

Criticus

Markdown to TEI

TEI Example

<!DOCTYPE TEI>
<TEI xmlns="http://www.tei-c.org/ns/1.0">
    <teiHeader>
        <fileDesc>
            <titleStmt>
                <title n="31506" type="document">A Transcription of GA 1506</title>
                <respStmt>
                    <resp when-iso="2020-09-12">Transcribed by </resp>
                    <name type="person"> David A Flood, II</name>
                </respStmt>
            </titleStmt>
        </fileDesc>
    </teiHeader>
    <text xml:lang="grc">
        <body>
            <div type="book" n="B06">
                <div type="chapter" n="B06K11">
                    <pb n="323v" type="folio"/>
                    <lb/><note type="commentary">One line of untranscribed commentary text</note>
                    <ab n="B06K11V4">
                        <lb/><w>αλλα</w><w>τι</w><w>λεγει</w><w>αυτω</w><w>ο</w><w>χρ<supplied>η</supplied>μα
                        <lb n="10"/>τισμος</w><pc>.</pc><w>κατεληψα</w><w>εμαυτω</w><w>επτακισχιλιους</w><w>ανδρας</w><w>οιτινες</w><w>ουκ</w><w>ε
                        <lb n="11"/>καμψαν</w><w>γωνοι</w><w>τη</w><w>βαλ</w><note type="local">expected βααλ</note>
                    </ab>
                    <ab n="B06K11V5">
                        <w>ουτως</w><w>ουν</w><w>και</w><w>εν</w><w>τω</w><w>νυν</w><w>καιρω</w><w>λημμα</w>
                        <lb n="12"/><w>κατ</w><w>εκλογη<unclear>ν</unclear></w>
                        <w><supplied>χαρι</supplied>τος</w><w>γεγονεν</w>
                    </ab>
                </div>
            </div>
        </body>
    </text>
</TEI>

Existing Software for Creating TEI Transcriptions

Normal Markdown Example

# A line that begins with a single hash is rendered as an H! element
If no markup, then the line will be rendered as a paragraph element.
Words enclosed with *single asterisks* will be rendered in italics.
Words enclosed with **double asterisks** will be rendered as bold.
Markup <div>tags in angle brakets</div> are pass through unchanged.

Converted HTML

<h1>
    A line that begins with a single hash is rendered as an H! element
</h1>
<p>
    If no markup, then the line will be rendered as a paragraph 
    element. Words enclosed with <em>single asterisks</em> will be 
    rendered in italics. Words enclosed with <strong>double 
    asterisks</strong> will be rendered as bold. Markup <div>tags in 
    angle brakets</div> are pass through unchanged.
</p>

MarkdownTEI 'Kitchen Sink' Example

# A Simple Transcription Example
## FirstName LastName
### 2021-05-12
...................................
#### Romans
##### 11
<pb n="323v"/>
<lb/> words are tokenized
<lb/><v n="5">shortcut tag for verse unit
<lb/> [supp]lied [text] in brackets
<lb/> unclear `text` in back`ticks`
<lb/> some text followed by commentary <comm/>
<comm lines="3"/>
<lb/> **marginalia in double-asterisks**
<lb/> a word bro-
<lb n="8"/>ken over two lines
<lb/> {unencoded notes in braces}
<lb/> *encoded editer's note in single asterisks*
<lb/> ++ corrcdet tetx | corrected text ++
<lb/> add attributes to an `element`{reason='damage to page'}</v>
#####
####

MarkdownTEI Converted to TEI

<!DOCTYPE TEI>
<TEI xmlns="http://www.tei-c.org/ns/1.0">
    <teiHeader>
        <fileDesc>
            <titleStmt>
                <title type="document">A Simple Transcription Example</title>
                <respStmt>
                    <resp when-iso="2021-05-12">Transcribed by</resp>
                    <name type="person">FirstName LastName</name>
                </respStmt>
            </titleStmt>
        </fileDesc>
    </teiHeader>
    <text xml:lang="grc">
        <body>
            <div type="book" n="B06">
                <div type="chapter" n="B06K11">
                    <pb n="323v" type="folio"/>
                    <lb/><w>words</w><w>are</w><w>tokenized</w>
                    <lb/><ab n="B06K11V5"><w>shortcut</w><w>tag</w><w>for</w><w>verse</w><w>unit</w>
                    <lb/><w><supplied>supp</supplied>lied</w><w><supplied>text</supplied></w><w>in</w><w>brackets</w>
                    <lb/><w>unclear</w><w><unclear>text</unclear></w><w>in</w><w>back<unclear>ticks</unclear></w>
                    <lb/><w>some</w><w>text</w><w>followed</w><w>by</w><w>commentary</w><note type="commentary">untranscribed commentary text</note>
                    <lb/><note type="commentary">One line of untranscribed commentary text</note>
                    <lb/><note type="commentary">One line of untranscribed commentary text</note>
                    <lb/><note type="commentary">One line of untranscribed commentary text</note>
                    <lb/><seg type="margin">marginalia in double-asterisks</seg>
                    <lb/><w>a</w><w>word</w><w>bro
                    <lb n="8"/>ken</w><w>over</w><w>two</w><w>lines</w>
                    <lb/>{unencoded notes in braces}
                    <lb/><note type="local">encoded editer's note in single asterisks</note>
                    <lb/><app><rdg type="orig" hand="firsthand"><w>corrcdet</w><w>tetx</w></rdg><rdg type="corr" hand="corrector"><w>corrected</w><w>text</w></rdg></app>
                    <lb/><w>add</w><w>attributes</w><w>to</w><w>an</w><w><unclear reason="damage to page">element</unclear></w></ab>
                </div>
            </div>
        </body>
    </text>
</TEI>

Markdown to TEI: How?

  1. Criticus preprocesses the MarkdownTEI
  2. The MarkdownTEI text is rendered by a much-customized Python-Markdown package
  3. Criticus postprocesses the rendered XML and creates a few TEI-specific elements.

Export Collation to DOCX

Simplified TEI Collation Example

<app type="main" n="1Cor1.3" from="4" to="4">
      <lem wit="NA28">υμιν</lem>
      <rdg n="a" varSeq="1" wit="01 0151 02 03 04 06 33 NA28 RP">υμιν</rdg>
      <rdg n="ar1" type="subr" varSeq="1" wit="P46">υμειν</rdg>
      <rdg n="b" wit="0150 2110 1506" varSeq="3" type="om"/>
</app>

Export Collation to DOCX: Output

A word docx page. The heading is centered and identifies the scripture reference, under it the verse is printed with an even number starting with 2 centered under each word. These indices are used to identify variation units.

Criticus: What's Next?

For more information and communication:

Return to Blog

Tags

digital humanities