Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

The IbiScript DSL

by Andrea Marruzzo

Logo
**IbiScript** is a domain-specific markup language for epigraphic and philological editing, designed to combine the agility of Leiden Conventions with the semantic precision of EpiDoc. ]

IbiScript gives the editor immediate control over the text. Developed in Rust and powered by the ANSELMUS parsing engine, it transforms the uncertainty of the artefact into solid digital data, acting as an architecture of thought that shapes the researcher’s epistemic contribution.

  • Fluid Hermeneutics: Encode epigraphic phenomena and critical apparatus without the visual interference of XML tags.
  • Technical Subsidiarity: Native generation of EpiDoc, HTML, Typst PDF and Unicode outputs; full integration with the BEDA ecosystem via WebAssembly.
  • Scientific Rigour: A bridge between the physicality of the artefact and a shared digital memory, where every character is a validated scientific thesis.

The name combines the sacred Ibis of Thoth, guardian of writing, with the Latin adverb ibi: to interrogate the word “there, in that place,” upon the rough surface of ancient matter.

IbiScript processing pipeline diagram.
IbiScript processing pipeline diagram.

Notation Guide

This guide is organised according to the incremental logic of the ANSELMUS system, reflecting the transition from material data to editorial interpretation.

Atomic Textual Units — Minimal units of textual segmentation that cannot contain or nest other notations within themselves.

Phenomena — A set of notations designed to describe the state of the textual tradition, the condition of the support, and the variations that occurred during the genesis or transmission of the text.

Critical and Editorial Apparatus — A set of notations for the meta-textual phenomena that constitute the philological analysis of the inscribed text. Includes assessments of epistemicity and interpretative plausibility, discursive critical apparatus notes, linguistic annotations, and bibliography.

Formatting and Internal Annotation — Tools dedicated to managing typographic emphasis and inserting metatextual comments. Includes markers for graphic relief (bold, italics) and documentation features for internal use (line or block comments) not intended for the publication of the critical text.

Each phenomenon is documented atomically, systematically listing the combinations defined by the AST. However, for the sake of clarity, the treatment follows a maximum nesting depth of two levels: when phenomenon A may contain phenomenon B, the manual illustrates the case A(B) in the section dedicated to A, referring the reader to B’s own section for a full account of what B may itself contain.

Unless otherwise stated, any phenomenon that admits internal content accepts all phenomena compatible with the physical/editorial distinction documented in each section.

General Guidelines

IbiScript is designed to be intuitive, flexible, and easily typed on standard European keyboards, while maintaining maximum compatibility with the established Leiden System.

Unless explicitly stated otherwise, the system’s parsing logic is agnostic to white spaces or line breaks. This makes IbiScript robust against minor formatting inconsistencies and, above all, prioritizes explicit semantic encoding over visual layout.

The notation is defined using a specific set of reserved Unicode characters (the STOP_SET sequence). To use any of these characters as literal text, an escaping mechanism is provided via the backslash \ character.

The question mark ? acts as a low certainty operator. While it generally indicates a doubtful interpretation by the editor, its specific meaning adapts to the phenomenological context: for instance, in the case of gaps, the ? operator shifts the description from an exact measurement to an approximate estimate.

Conversely, the exclamation mark ! acts as a high certainty or precision operator. It expresses a strong and definitive editorial assertion regarding the described phenomenon; in the context of measurements, the ! operator guarantees the pinpoint precision of the quantitative data provided, explicitly excluding any margin of approximation or executive uncertainty.

Some phenomena support an extended syntax for metadata, expressed as a sequence of label:value pairs separated by semicolons. Values may themselves contain plausibility notation, allowing the editor to express graduated judgements over alternative readings — a feature documented in detail in the plausibility assessment section (cf. Interpretative Plausibility Assessment) and referenced in the sections of each phenomenon that supports it.

Atomic Textual Units

Minimal units of textual segmentation that cannot contain or nest other notations within themselves.

As-Written Signs

Signs used in the critical text which do not constitute the notation of phenomena.

IbiScript supports the native rendering of any Unicode character, but each writing system benefits in its own way from the various rendering options available.

Realised Signs

Textual signs rendered graphically within the text as Unicode glyphs.

Syntax

Any number of Unicode characters not in STOP_SET, i.e. those special characters used to notate other phenomena.

Overview

NotationConceptual ASTPaper Output
𝑆×𝑁Plain(𝑆×𝑁)𝑆×𝑁
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).

Examples

NotationPaper Output
𒀭𒂗𒆤
𒀭𒂗𒆤
𓄤𓆑𓂋
𓄤𓆑𓂋
φῶς
φῶς
𐌀𐌕𐌉
𐌀𐌕𐌉
rēs
rēs
𐭬𐭫𐭪
𐭬𐭫𐭪

EpiDoc Outputs

NotationEpiDoc (XML)
𒀭𒂗𒆤
<ab>𒀭𒂗𒆤</ab>
𓄤𓆑𓂋
<ab>𓄤𓆑𓂋</ab>
φῶς
<ab>φῶς</ab>
𐌀𐌕𐌉
<ab>𐌀𐌕𐌉</ab>
rēs
<ab>rēs</ab>
𐭬𐭫𐭪
<ab>𐭬𐭫𐭪</ab>

Structural Analysis (Conceptual AST)

NotationAST
𒀭𒂗𒆤
Plain("𒀭𒂗𒆤")
𓄤𓆑𓂋
Plain("𓄤𓆑𓂋")
φῶς
Plain("φῶς")
𐌀𐌕𐌉
Plain("𐌀𐌕𐌉")
rēs
Plain("rēs")
𐭬𐭫𐭪
Plain("𐭬𐭫𐭪")

Whilst this input method is ideal for commonly used characters, it proves inadequate for rare glyphs or those belonging to historical writing systems. Indeed, the direct insertion of specific Unicode characters not only risks generating incorrect substitute characters if the font being used is incomplete, but also compromises the logical consistency of the editorial layout. This occurs in particular when introducing graphemes with opposing writing directions (as in the case of Middle Persian characters inserted into a Latin transcription), causing unpredictable alterations to the text layout.

Coded Signs

Textual signs represented in the form of abstract notation.

Syntax

  • Any sequence of Unicode hexadecimal character codes separated by semicolons ;, enclosed in curly brackets {…} and preceded by the \u command.
  • Any sequence of text notation groups separated by semicolons ;, enclosed in curly brackets {…} and preceded by the command \u. Each text notation group consists of:
  • a four-letter ISO 15924 code identifying the writing system;
  • a colon :;
  • a single alias or a sequence of Unicode character aliases separated by commas , (belonging to the same writing system as a group).

Overview

NotationConceptual ASTPaper Output
\u{Cᵤ;…}Plain(𝑆ᵤ×𝑁)𝑆ᵤ×𝑁
  • Cᵤ = Unicode codepoint.
  • cₛ = four-letter ISO 15924 code of the writing system.
  • a = Unicode character alias.
  • 𝑆ᵤ = any sign (Unicode character) obtained from the coded form.
  • 𝑁 = number of characters (represented by char or digits).

Examples

NotationPaper Output
\u{10E7E}
𐹾
\u{arab:rumi-2/3}
𐹾
\u{xsux:an,en,kid}
𒀭𒂗𒆤
\u{egyp:f035,i009,d021}
𓄤𓆑𓂋
\u{grek:phi,omega-with-perispomeni,final-sigma}
φῶς
\u{ital:a,te,i}
𐌀𐌕𐌉
\u{latn:r,e-with-macron,s}
rēs
\u{phli:m,l,k}
𐭬𐭫𐭪
\u{deva:sha; deva:virama; deva:ra; deva:ii}
श्री

EpiDoc Outputs

NotationEpiDoc (XML)
\u{10E7E}
<ab>𐹾</ab>
\u{arab:rumi-2/3}
<ab>𐹾</ab>
\u{xsux:an,en,kid}
<ab>𒀭𒂗𒆤</ab>
\u{egyp:f035,i009,d021}
<ab>𓄤𓆑𓂋</ab>
\u{grek:phi,omega-with-perispomeni,final-sigma}
<ab>φῶς</ab>
\u{ital:a,te,i}
<ab>𐌀𐌕𐌉</ab>
\u{latn:r,e-with-macron,s}
<ab>rēs</ab>
\u{phli:m,l,k}
<ab>𐭬𐭫𐭪</ab>
\u{deva:sha; deva:virama; deva:ra; deva:ii}
<ab>श्री</ab>

Structural Analysis (Conceptual AST)

NotationAST
\u{10E7E}
Plain("𐹾")
\u{arab:rumi-2/3}
Plain("𐹾")
\u{xsux:an,en,kid}
Plain("𒀭𒂗𒆤")
\u{egyp:f035,i009,d021}
Plain("𓄤𓆑𓂋")
\u{grek:phi,omega-with-perispomeni,final-sigma}
Plain("φῶς")
\u{ital:a,te,i}
Plain("𐌀𐌕𐌉")
\u{latn:r,e-with-macron,s}
Plain("rēs")
\u{phli:m,l,k}
Plain("𐭬𐭫𐭪")
\u{deva:sha; deva:virama; deva:ra; deva:ii}
Plain("श\u{94d}री")
IbiScript allows any Unicode character to be represented in encoded form, provided the corresponding Unicode character code is known (cf. example 1).

However, the most convenient and reliable input method is the key:value system, which IbiScript supports for 111 modern and historical writing systems (cf. Writing systems supported for key:value entry for the full list of codes). Each Unicode character can be referred to via one or more nominal aliases that correspond to the official character names, suitably stripped of superfluous elements; numerical forms, in particular, can also be written by directly using numeric digits (cf. example 2). It is not necessary to repeat the ISO 15924 code before each nominal alias (cf. examples 3–8), as the sequence is recognised automatically (cf. example 9 for a case of explicit repetition with optional spaces after the semicolons).

White Space

Significant white space within the text, whether isolated or occurring between epigraphic phenomena. The following rules define a white space as significant:

  • isolated in plain text (cf. example 1).
  • inserted in plain text between text blocks as a word separator (cf. example 2).
  • inserted inside blocks of epigraphic phenomena or nested epigraphic phenomena (cf. example 3).
  • inserted, even alone, inside an Omitted phenomenon to express a deliberate omission of a white space by the scribe (cf. example 4). White spaces appearing before or after delimiters are not significant and are thus ignored, treated with laxity as editorial typos.

Syntax

Any white space character.

Overview

NotationConceptual ASTPaper Output
Whitespace
  • 𝑊 = any white space.

Examples

NotationPaper Output
 
 ab c 
ab c
[ ab c ]
ab c
< >

EpiDoc Outputs

NotationEpiDoc (XML)
 
<ab> 
</ab>
 ab c 
<ab> ab c </ab>
[ ab c ]
<ab>
    <supplied reason="lost" cert="medium"> ab c </supplied>
</ab>
< >
<ab>
    <supplied reason="omitted" cert="medium">
    </supplied>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
 
WS
 ab c 
WS
Plain("ab")
WS
Plain("c")
WS
[ ab c ]
Supplied[medium]
  WS
  Plain("ab")
  WS
  Plain("c")
  WS
< >
Omitted[medium]

Line Break

A line break within the text, optionally accompanied by explicit line numbering.

Standard “newline” characters are not evaluated as philologically significant line breaks; instead, they produce Newline units that are treated merely as notational noise. Simple carriage returns can therefore be used to format IbiScript code at will—for instance, by moving long sequences of linguistic annotations to the next line (cf. Linguistic Annotation of a Lexical Unit).

From an epigraphic perspective, IbiScript requires that every significant line of text—that is, any line clearly identifiable on the support—be explicitly marked in the code. This is achieved by appending the notation (illustrated below) at the end of the line, as if notifying the system of a carriage return by analogy.

Should the user forget to insert an explicit line break at the final line of text (e.g., in the case of single-line inscriptions), IbiScript will automatically supply it.

Syntax

A single slash / optionally followed by a natural number for explicit line numbering.

Overview

NotationConceptual ASTPaper Output
/nᵟLineBreak(νₐᵟ)/
  • 𝑛ᵟ = an optional number 𝑛 ∈ ℕ (natural numbers).
  • = a new line
  • νₐᵟ = any natural number or none.
  • νₑᵟ = n EpiDoc attribute followed by a natural number or none.

Examples

NotationPaper Output
/
/2
abc
def
abc def
abc/
def
abc def

EpiDoc Outputs

NotationEpiDoc (XML)
/
<ab>
    <lb/>
</ab>
/2
<ab>
    <lb n="2"/>
</ab>
abc
def
<ab>abcdef</ab>
abc/
def
<ab>
    <lb/>abcdef</ab>

Structural Analysis (Conceptual AST)

NotationAST
/
LineBreak
/2
LineBreak(n=2)
abc
def
Plain("abc")
NL
Plain("def")
abc/
def
Plain("abc")
LineBreak
NL
Plain("def")

Remarks

Since standard carriage returns (i.e., those inserted with the “Enter” key) are non-significant, inscriptions consisting of very short lines can be written on a single line of code, e.g., line1/line2/line3/.

Word Break

Indicates a word break, marking the exact point where a sequence of signs or a word is interrupted, such as by a line break or a physical fracture in the epigraphic medium.

This node solely describes a graphical or positional event and does not imply a linguistic division: the actual separation or categorisation of lexical units is instead managed using the specific notation provided by LexicalUnit.

Syntax

A hyphen -.

Overview

NotationConceptual ASTPaper Output
-WordBreak-

Examples

NotationPaper Output
-
-
-abc
-abc
abc-
abc-
ab-c
ab-c

EpiDoc Outputs

NotationEpiDoc (XML)
-
<ab>
    <lb break="no"/>
</ab>
-abc
<ab>
    <lb break="no"/>abc</ab>
abc-
<ab>abc<lb break="no"/>
</ab>
ab-c
<ab>ab<lb break="no"/>c</ab>

Structural Analysis (Conceptual AST)

NotationAST
-
WordBreak
-abc
WordBreak
Plain("abc")
abc-
Plain("abc")
WordBreak
ab-c
Plain("ab")
WordBreak
Plain("c")

Text Language

Notation used to identify the language of the inscription or part of it.

Syntax

Any valid metadata key followed by an equal sign = and a valid #link(“https:

Overview

NotationConceptual ASTPaper Output
$kₘ=Cᵣ$Language(Cᵥ)
  • kₘ = any valid metadata key (listed below).
  • Cᵣ = RFC 5646 language code.
  • Cᵥ = validated language code.

Supported Metadata Keys

KeyMeaningFormattingMinification
language, lang, llanguagelangl

Examples

NotationPaper Output
$lang=latn$ abc /
abc
$language=pal-Phli$ 𐭠𐭡𐭢 /
𐭠𐭡𐭢

EpiDoc Outputs

NotationEpiDoc (XML)
$lang=latn$ abc /
<ab xml:lang="latn">
    <lb/> abc</ab>
$language=pal-Phli$ 𐭠𐭡𐭢 /
<ab xml:lang="pal-Phli">
    <lb/> 𐭠𐭡𐭢</ab>

Structural Analysis (Conceptual AST)

NotationAST
$lang=latn$ abc /
Language(latn)
WS
Plain("abc")
LineBreak
$language=pal-Phli$ 𐭠𐭡𐭢 /
Language(pal-Phli)
WS
Plain("𐭠𐭡𐭢")
LineBreak

Text Direction

Notation used to denote the direction of writing, essential for retrograde (right-to-left) or boustrophedon (alternating) inscriptions.

Syntax

A hyphen - followed by the greater-than sign > for the rightward arrow, or a hyphen - preceded by the less-than sign < for the leftward arrow, enclosed within the dollar-sign wrapper $…$.

Overview

NotationConceptual ASTPaper Output
$->$Direction(LeftToRight)

Examples

NotationPaper Output
$->$ abc /
abc
$<-$ 𐭠𐭡𐭢 /
𐭠𐭡𐭢

EpiDoc Outputs

NotationEpiDoc (XML)
$->$ abc /
<ab>
    <lb style="text-direction:l-to-r"/> abc</ab>
$<-$ 𐭠𐭡𐭢 /
<ab>
    <lb style="text-direction:r-to-l"/> 𐭠𐭡𐭢</ab>

Structural Analysis (Conceptual AST)

NotationAST
$->$ abc /
Direction(→)
WS
Plain("abc")
LineBreak
$<-$ 𐭠𐭡𐭢 /
Direction(←)
WS
Plain("𐭠𐭡𐭢")
LineBreak

Text Subdivision

Indicates that the following text is part of the subsection indicated by the notation.

Syntax

Any valid metadata key (see below) followed by an equal sign =, a free-text identifier for the selected text subdivision, and an optional certainty notation, all enclosed in dollar signs $…$.

Overview

NotationConceptual ASTPaper Output
$kₘ=iₚ‽ᵟ$`SectionBreak {
unit: Lᵥ, n: iₚ, cert: γ }`§iₚ
  • kₘ = any valid metadata key (listed below).
  • Lᵥ = validated level code (subdivision).
  • iₚ = free text identifier of the subdivision.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Supported Metadata Keys

KeyMeaningFormattingMinification
column, col, ccolumncolc
line, ln, llinelnl
section, sec, sect, ssectionsects
page, pag, p, pgpagepagp
entry, nentryentryn

Examples

NotationPaper Output
$sect=First section$ abc /
abc
$frag=4?$ abc /
abc

EpiDoc Outputs

NotationEpiDoc (XML)
$sect=First section$ abc /
<ab>
    <lb/>
</ab>
<div type="textpart" subtype="sect" n="First section" cert="medium">
    <ab> abc</ab>
</div>
$frag=4?$ abc /
<ab>
    <lb/>
</ab>
<div type="textpart" subtype="fr" n="4" cert="low">
    <ab> abc</ab>
</div>

Structural Analysis (Conceptual AST)

NotationAST
$sect=First section$ abc /
TextPart(sect First section, medium)
WS
Plain("abc")
LineBreak
$frag=4?$ abc /
TextPart(fr 4, low)
WS
Plain("abc")
LineBreak

Lexical Unit Boundary

Represents the logical boundary of a lexical unit (word). It is used to mark the end of a word regardless of its physical layout on the support, allowing the system to reconstruct units split by fractures or line breaks.

Syntax

Any number of Unicode characters enclosed within ampersands &…&. Optionally, linguistic annotations can follow after a semicolon ;.

If the user wishes to easily identify a series of lexical units, the entire sequence can be enclosed within ampersands &…& with individual units separated by a forward slash /.

Overview

NotationConceptual ASTPaper Output
&𝑆×𝑁;λₛ=λᵥ;…&LexicalUnit([𝘜], LinguisticAnalysis{λₖ:λᵥ,…})𝑆×𝑁
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • λₛ = label, which may also be in abbreviated form, for linguistic annotation.
  • λᵥ = value of the linguistic annotation (plausibility scale).
  • λₖ = canonical key for the linguistic annotation derived from the corresponding label.

Examples

NotationPaper Output
&ab-c&
ab-c
&*ab* [c]&
ab c
&
abc defg  hijk l
&
abc defg hijk l
&abc/def/hijk&
abcdefhijk

EpiDoc Outputs

NotationEpiDoc (XML)
&ab-c&
<ab>
    <w>ab<lb break="no"/>c</w>
</ab>
&*ab* [c]&
<ab>
    <w>
        <unclear cert="medium">ab</unclear> 
        <supplied reason="lost" cert="medium">c</supplied>
    </w>
</ab>
&
abc defg  hijk l
&
<ab>
    <w>abc defg hijk l</w>
</ab>
&abc/def/hijk&
<ab>
    <w>abcdefhijk</w>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
&ab-c&
LexicalUnit
  Plain("ab")
  WordBreak
  Plain("c")
&*ab* [c]&
LexicalUnit
  Unclear[medium, legibility: normal]
    Plain("ab")
  WS
  Supplied[medium]
    Plain("c")
&
abc defg  hijk l
&
LexicalUnit
  Plain("abc")
  WS
  Plain("defg")
  WS
  Plain("hijk")
  WS
  Plain("l")
&abc/def/hijk&
LexicalUnit
  Plain("abc")
  LineBreak
  Plain("def")
  LineBreak
  Plain("hijk")

Phenomena

A set of notations designed to describe the state of the textual tradition, the condition of the support, and the variations that occurred during the genesis or transmission of the text.

Vacat

A space intentionally left empty by the inscriber of the text, not due to a loss of the support, but for purposes of layout or textual distinction.

Delimiters

SideSignNameUnicode
Left[Left Square BracketU+005B
Right]Right Square BracketU+005D

Uninscribed Signs or Spaces (v. or vac.)

Uninscribed signs or spaces.

Syntax

The greather-than sign > followed by the letter c for “character” and a number corresponding to the character count (followed by the optional precision notation), the whole enclosed within square brackets […].

Overview

NotationConceptual ASTPaper Output
[>cN‽ᵟ]Vacat{ count: n, unit: Char, precision: γ }vac. char. n◇ᵟ
  • 𝑛 ∈ ℕ (natural numbers).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • 𝑁 = number of characters (represented by char or digits).

Examples

NotationPaper Output
[>c]
vac. char.
[>c3]
vac. char. 3
[>c7?]
vac. char. 7
[>c5!]
vac. char. 5

EpiDoc Outputs

NotationEpiDoc (XML)
[>c]
<ab>
    <space quantity="1" unit="character" precision="medium"/>
</ab>
[>c3]
<ab>
    <space quantity="3" unit="character" precision="medium"/>
</ab>
[>c7?]
<ab>
    <space quantity="7" unit="character" precision="low"/>
</ab>
[>c5!]
<ab>
    <space quantity="5" unit="character" precision="high"/>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[>c]
Vacat(char. 1, medium)
[>c3]
Vacat(char. 3, medium)
[>c7?]
Vacat(char. 7, low)
[>c5!]
Vacat(char. 5, high)

Uninscribed Remainder of Line (vacat)

The uninscribed remainder of the line.

Syntax

The greather-than sign ! followed by the letter l for “line” and a number corresponding to the character count (followed by the optional precision notation), the whole enclosed within square brackets […].

Overview

NotationConceptual ASTPaper Output
[>lN‽ᵟ]Vacat{ count: n, unit: Line, precision: γ }vacat n◇ᵟ
  • L = non-digit genitive plural of the Latin cardinal numeral corresponding to N.
  • 𝑛 ∈ ℕ (natural numbers).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.

Examples

NotationPaper Output
[>l]
vac. lin.
[>l2]
vac. lin. 2
[>l4?]
vac. lin. 4
[>l3!]
vac. lin. 3

EpiDoc Outputs

NotationEpiDoc (XML)
[>l]
<ab>
    <space extent="1" unit="line" precision="medium"/>
</ab>
[>l2]
<ab>
    <space extent="2" unit="line" precision="medium"/>
</ab>
[>l4?]
<ab>
    <space extent="4" unit="line" precision="low"/>
</ab>
[>l3!]
<ab>
    <space extent="3" unit="line" precision="high"/>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[>l]
Vacat(lin. 1, medium)
[>l2]
Vacat(lin. 2, medium)
[>l4?]
Vacat(lin. 4, low)
[>l3!]
Vacat(lin. 3, high)

Gaps

Physical losses of the support that resulted in the disappearance of portions of the original text; the extent of the loss can be certain, estimated, or unknown.

Delimiters

SideSignNameUnicode
Left[Left Square BracketU+005B
Right]Right Square BracketU+005D

Gap of Known Extent

A gap of known extent. The editor indicates a precise number of missing characters by repeating a gap sign inside square brackets.

Syntax

Any natural number flanked by double full stops .…., followed by the optional precision notation the whole enclosed within square brackets […].

Overview

NotationConceptual ASTPaper Output
[.𝑁.‽ᵟ]Gap{ quantity: Known{ count: 𝑁 }, precision: γ }[·𝑁◇ᵟ·]
  • 𝑁 = number of characters (represented by char or digits).
  • 𝑛 ∈ ℕ (natural numbers).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
[.7.]
7
[.3.?]
.3.
[.4.!]
.4.

EpiDoc Outputs

NotationEpiDoc (XML)
[.7.]
<ab>
    <gap reason="lost" quantity="7" unit="character" precision="medium"/>
</ab>
[.3.?]
<ab>
    <supplied reason="lost" cert="low">.3.</supplied>
</ab>
[.4.!]
<ab>
    <supplied reason="lost" cert="high">.4.</supplied>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[.7.]
Gap(known=7, medium)
[.3.?]
Supplied[low]
  Plain(".3.")
[.4.!]
Supplied[high]
  Plain(".4.")

Gap of Ranged Extent

A gap whose extent is expressed as a plausible numeric range.

Syntax

Any natural numbers couple separated by an hyphen - (followed by the optional precision notation), enclosed between square brackets […].

Overview

NotationConceptual ASTPaper Output
[𝑛₁-𝑛₂‽ᵟ]Gap{ quantity: Range{ min: 𝑛₁, max: 𝑛₂ }, precision: γ }[·𝑛₁–𝑛₂◇ᵟ·]
  • 𝑛₁, 𝑛₂ ∈ ℕ (natural numbers), with 𝑛₁𝑛₂.
  • 𝑁 = number of characters (represented by char or digits).
  • 𝑛 ∈ ℕ (natural numbers).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
[1-3]
1–3
[2-4?]
2–4
[5-6!]
5–6

EpiDoc Outputs

NotationEpiDoc (XML)
[1-3]
<ab>
    <gap reason="lost" atLeast="1" atMost="3" unit="character" precision="medium"/>
</ab>
[2-4?]
<ab>
    <gap reason="lost" atLeast="2" atMost="4" unit="character" precision="low"/>
</ab>
[5-6!]
<ab>
    <gap reason="lost" atLeast="5" atMost="6" unit="character" precision="high"/>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[1-3]
Gap(range=1–3, medium)
[2-4?]
Gap(range=2–4, low)
[5-6!]
Gap(range=5–6, high)

Gap of Unknown Extent

A gap of unknown extent.

Syntax

Zero or more white spaces enclosed between square brackets […].

Overview

NotationConceptual ASTPaper Output
[𝑊×𝑁₀₋ₙ‽ᵟ]Gap{ quantity: Unknown, precision: γ }[··◇ᵟ·]
  • 𝑊 = any white space.
  • 𝑁₀₋ₙ = zero or more repetitions.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
[]
·
[?]
·
[!]
·

EpiDoc Outputs

NotationEpiDoc (XML)
[]
<ab>
    <gap reason="lost" extent="unknown" unit="character" precision="medium"/>
</ab>
[?]
<ab>
    <gap reason="lost" extent="unknown" unit="character" precision="low"/>
</ab>
[!]
<ab>
    <gap reason="lost" extent="unknown" unit="character" precision="high"/>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[]
Gap(unknown, medium)
[?]
Gap(unknown, low)
[!]
Gap(unknown, high)

Fractures

Breaks in the inscribed support, with the Fracture indicated after which the text is present, without providing any details about the text that follows.

Syntax

  • Left-hand fracture: the less-than sign < enclosed within curly brackets {…} (cf. Example 1).
  • Right-hand fracture: the greater-than sign > enclosed within curly brackets {…} (cf. Example 2).
  • Top fracture: the caret ^ enclosed within curly brackets {…} (cf. Example 3).
  • Bottom fracture: the letter v enclosed within curly brackets {…} (cf. Example 4).

Overview

NotationConceptual ASTPaper Output
{<}Fracture(Left)

Unclear Signs

Signs remaining on the support but difficult to read due to physical degradation or poor preservation.

Delimiters

SideSignNameUnicode
Left*AsteriskU+002A
Right*AsteriskU+002A

*abc* ↓ Formatter optimisation for human legibility ↓ ⁎abc⁑

SideSignNameUnicode
LeftLow AsteriskU+204E
RightTwo Asterisks Aligned VerticallyU+2051

Internally Allowed Constructs

ConstructSpecific ReferenceGeneral Reference
Plain📖🔎 Plain
Whitespace🔎 Whitespace
Newline🔎 Newline
WordBreak🔎 WordBreak
PreviousSeen📖🔎 PreviousSeen
ApparatusMark🔎 ApparatusMark
PlausibilityAssessment🔎 PlausibilityAssessment
Strong🔎 Strong
Emphasis🔎 Emphasis
Comment🔎 Comment

Unclear As-Written Signs

Signs whose remaining traces on the support are readable enough to be restored. Alternative readings may be possible.

Syntax

Any number of Unicode characters enclosed (followed by the optional certainty notation) between asterisks *…*. The optional " operator, placed before the final delimiter, can be used to indicate a particularly difficult reading.

Overview

NotationConceptual ASTPaper Output
*𝑆×𝑁‽ᵟ"ᵟ*Unclear { content: [Plain("𝑆×𝑁")], cert: γ, legibility: λ }⦇𝑆×𝑁◇ᵟ~ᵟ⦈
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • 𝑛 ∈ ℕ (natural numbers).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • λ = legibility level (normal or severe) based on the presence or absence of the " operator.
  • ~ᵟ = severe legibility marker ~ or nothing in case of normal legibility.

See Unclear Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
*abc*
abc
*abc?*
abc
*abc!*
abc
*abc"*
abc
*abc?"*
abc
*abc!"*
abc

EpiDoc Outputs

NotationEpiDoc (XML)
*abc*
<ab>
    <unclear cert="medium">abc</unclear>
</ab>
*abc?*
<ab>
    <unclear cert="low">abc</unclear>
</ab>
*abc!*
<ab>
    <unclear cert="high">abc</unclear>
</ab>
*abc"*
<ab>
    <unclear cert="medium" reason="illegible">abc</unclear>
</ab>
*abc?"*
<ab>
    <unclear cert="low" reason="illegible">abc</unclear>
</ab>
*abc!"*
<ab>
    <unclear cert="high" reason="illegible">abc</unclear>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
*abc*
Unclear[medium, legibility: normal]
  Plain("abc")
*abc?*
Unclear[low, legibility: normal]
  Plain("abc")
*abc!*
Unclear[high, legibility: normal]
  Plain("abc")
*abc"*
Unclear[medium, legibility: severe]
  Plain("abc")
*abc?"*
Unclear[low, legibility: severe]
  Plain("abc")
*abc!"*
Unclear[high, legibility: severe]
  Plain("abc")

Unclear Signs Seen by Previous Editors

Signs seen by previous editors whose remaining traces on the support are readable enough to be restored. Alternative readings may be possible.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within PreviousSeen wrapped by low lines _…_ and enclosed between asterisks *…*. The optional " operator, placed before the final delimiter, can be used to indicate a particularly difficult reading.

Overview

NotationConceptual ASTPaper Output
*_⊙_‽ᵟ"ᵟ*Unclear { content: [PreviousSeen { ⊙ }], cert: γ, legibility: λ }⦇⸤⊙⸥◇ᵟ~ᵟ⦈
  • PREVIOUS_SEEN_ALLOWED = any phenomena allowed within PreviousSeen (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • λ = legibility level (normal or severe) based on the presence or absence of the " operator.
  • ~ᵟ = severe legibility marker ~ or nothing in case of normal legibility.

See Unclear Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
*_abc_*
abc
*_abc_?*
abc
*_abc_!*
abc
*_abc_"*
abc
*_abc_?"*
abc
*_abc_!"*
abc

EpiDoc Outputs

NotationEpiDoc (XML)
*_abc_*
<ab>
    <unclear cert="medium">
        <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
    </unclear>
</ab>
*_abc_?*
<ab>
    <unclear cert="low">
        <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
    </unclear>
</ab>
*_abc_!*
<ab>
    <unclear cert="high">
        <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
    </unclear>
</ab>
*_abc_"*
<ab>
    <unclear cert="medium" reason="illegible">
        <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
    </unclear>
</ab>
*_abc_?"*
<ab>
    <unclear cert="low" reason="illegible">
        <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
    </unclear>
</ab>
*_abc_!"*
<ab>
    <unclear cert="high" reason="illegible">
        <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
    </unclear>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
*_abc_*
Unclear[medium, legibility: normal]
  PreviousSeen[medium]
    Plain("abc")
*_abc_?*
Unclear[low, legibility: normal]
  PreviousSeen[medium]
    Plain("abc")
*_abc_!*
Unclear[high, legibility: normal]
  PreviousSeen[medium]
    Plain("abc")
*_abc_"*
Unclear[medium, legibility: severe]
  PreviousSeen[medium]
    Plain("abc")
*_abc_?"*
Unclear[low, legibility: severe]
  PreviousSeen[medium]
    Plain("abc")
*_abc_!"*
Unclear[high, legibility: severe]
  PreviousSeen[medium]
    Plain("abc")

Supplied Signs

Signs no longer visible or never inscribed, critically restored by the editor to recover the meaning of the text.

Delimiters

SideSignNameUnicode
Left[Left Square BracketU+005B
Right]Right Square BracketU+005D

Internally Allowed Constructs

ConstructSpecific ReferenceGeneral Reference
Plain📖🔎 Plain
Whitespace🔎 Whitespace
Newline🔎 Newline
WordBreak🔎 WordBreak
Unclear🔎 Unclear
ApparatusMark🔎 ApparatusMark
PlausibilityAssessment🔎 PlausibilityAssessment
Strong🔎 Strong
Emphasis🔎 Emphasis
Comment🔎 Comment

Supplied As-Written Signs

Signs restored by the editor as once having been inscribed but now lost.

Syntax

Any number of Unicode characters (followed by the optional certainty notation) enclosed between square brackets […].

Overview

NotationConceptual ASTPaper Output
[𝑆×𝑁‽ᵟ]Supplied { content: [Plain("𝑆×𝑁")], cert: γ }[𝑆×𝑁◇ᵟ]
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • 𝑛 ∈ ℕ (natural numbers).
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.

Examples

NotationPaper Output
[abc]
abc
[abc?]
abc
[abc!]
abc

EpiDoc Outputs

NotationEpiDoc (XML)
[abc]
<ab>
    <supplied reason="lost" cert="medium">abc</supplied>
</ab>
[abc?]
<ab>
    <supplied reason="lost" cert="low">abc</supplied>
</ab>
[abc!]
<ab>
    <supplied reason="lost" cert="high">abc</supplied>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[abc]
Supplied[medium]
  Plain("abc")
[abc?]
Supplied[low]
  Plain("abc")
[abc!]
Supplied[high]
  Plain("abc")

Testimonies by Earlier Editors

Signs, gaps, or epigraphic phenomena no longer visible through direct autopsy on the support, but documented in earlier scholarly editions or notebooks.

Delimiters

SideSignNameUnicode
Left_Low LineU+005F
Right_Low LineU+005F

Internally Allowed Constructs

ConstructSpecific ReferenceGeneral Reference
Plain📖🔎 Plain
Whitespace🔎 Whitespace
Newline🔎 Newline
WordBreak🔎 WordBreak
Gap-Known📖🔎 Gap-Known
Gap-Range📖🔎 Gap-Range
Gap-Unknown📖🔎 Gap-Unknown
Fracture🔎 Fracture
Unclear🔎 Unclear
Supplied🔎 Supplied
Erasure📖🔎 Erasure
Ligature📖🔎 Ligature
ApparatusMark🔎 ApparatusMark
PlausibilityAssessment🔎 PlausibilityAssessment
Strong🔎 Strong
Emphasis🔎 Emphasis
Comment🔎 Comment

Signs Seen by Earlier Editors

Signs seen by earlier editors but no longer visible on the support.

Syntax

An optional sequence of witness identifiers separated by semicolons ; interrupted by a colon :, followed by any number of Unicode characters (followed by the optional certainty notation) enclosed between low lines _…_.

Overview

NotationConceptual ASTPaper Output
_ω;…:ᵟ𝑆×𝑁‽ᵟ_PreviousSeen { witnesses: [ω,…ᵟ], content: [Plain("𝑆×𝑁")], cert: γ }⸤𝑆×𝑁ω;…ol.ᵟ◇ᵟ⸥
  • ω;…:ᵟ = optional series of witnesses.
  • ω,…ᵟ = parsed optional series of witnesses.
  • ω;…ol.ᵟ = rendering of the optional series of witnesses followed by the abbreviation of the Latin olim.
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • PREVIOUS_SEEN_ALLOWED = any phenomena allowed within PreviousSeen (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
_abc_
abc
_A:abc?_
abcA ol.
_A;B:abc!_
abcA, B ol.

EpiDoc Outputs

NotationEpiDoc (XML)
_abc_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
</ab>
_A:abc?_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="low" source="#A">abc</supplied>
</ab>
_A;B:abc!_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="high" source="#A #B">abc</supplied>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
_abc_
PreviousSeen[medium]
  Plain("abc")
_A:abc?_
PreviousSeen[low, witnesses: A]
  Plain("abc")
_A;B:abc!_
PreviousSeen[high, witnesses: A; B]
  Plain("abc")

Gap of Known Extent Seen by Previous Editors

A gap of known extent seen by earlier editors but no longer visible on the support. The editor indicates a precise number of missing characters by repeating a gap sign inside square brackets.

Syntax

  • An optional sequence of witness identifiers separated by semicolons ; interrupted by a colon :, followed by the notation for a gap of known extent, all wrapped by low lines _…_.

Overview

NotationConceptual ASTPaper Output
_ω;…:ᵟ[⊙]‽ᵟ_PreviousSeen { witnesses: [ω,…ᵟ], content: [Gap{ ⊙ }], cert: γ }⸤[⊙]ω;…ol.ᵟ◇ᵟ⸥
  • ω;…:ᵟ = optional series of witnesses.
  • ω,…ᵟ = parsed optional series of witnesses.
  • ω;…ol.ᵟ = rendering of the optional series of witnesses followed by the abbreviation of the Latin olim.
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
_[.7.]?_
7
_A:[.4.]_
4A ol.
_A;B:[.2.]!_
2A, B ol.

EpiDoc Outputs

NotationEpiDoc (XML)
_[.7.]?_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="low">
        <gap reason="lost" quantity="7" unit="character" precision="medium"/>
    </supplied>
</ab>
_A:[.4.]_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="medium" source="#A">
        <gap reason="lost" quantity="4" unit="character" precision="medium"/>
    </supplied>
</ab>
_A;B:[.2.]!_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="high" source="#A #B">
        <gap reason="lost" quantity="2" unit="character" precision="medium"/>
    </supplied>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
_[.7.]?_
PreviousSeen[low]
  Gap(known=7, medium)
_A:[.4.]_
PreviousSeen[medium, witnesses: A]
  Gap(known=4, medium)
_A;B:[.2.]!_
PreviousSeen[high, witnesses: A; B]
  Gap(known=2, medium)

Gap of Ranged Extent Seen by Previous Editors

A gap whose extent is expressed as a plausible numeric range, seen by earlier editors but no longer visible on the support.

Syntax

An optional sequence of witness identifiers separated by semicolons ; interrupted by a colon :, followed by the notation for a gap of ranged extent, all wrapped by low lines _…_.

Overview

NotationConceptual ASTPaper Output
_ω;…:ᵟ[⊙]‽ᵟ_PreviousSeen { witnesses: [ω,…ᵟ], content: [Gap{ ⊙ }], cert: γ }⸤[⊙]ω;…ol.ᵟ◇ᵟ⸥
  • ω;…:ᵟ = optional series of witnesses.
  • ω,…ᵟ = parsed optional series of witnesses.
  • ω;…ol.ᵟ = rendering of the optional series of witnesses followed by the abbreviation of the Latin olim.
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
_[1-3]_
1–3
_A:[2-5]?_
2–5A ol.
_A;B:[1-4]!_
1–4A, B ol.

EpiDoc Outputs

NotationEpiDoc (XML)
_[1-3]_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="medium">
        <gap reason="lost" atLeast="1" atMost="3" unit="character" precision="medium"/>
    </supplied>
</ab>
_A:[2-5]?_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="low" source="#A">
        <gap reason="lost" atLeast="2" atMost="5" unit="character" precision="medium"/>
    </supplied>
</ab>
_A;B:[1-4]!_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="high" source="#A #B">
        <gap reason="lost" atLeast="1" atMost="4" unit="character" precision="medium"/>
    </supplied>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
_[1-3]_
PreviousSeen[medium]
  Gap(range=1–3, medium)
_A:[2-5]?_
PreviousSeen[low, witnesses: A]
  Gap(range=2–5, medium)
_A;B:[1-4]!_
PreviousSeen[high, witnesses: A; B]
  Gap(range=1–4, medium)

Gap of Unknown Extent Seen by Previous Editors

A gap of unknown extent seen by earlier editors but no longer visible on the support.

Syntax

An optional sequence of witness identifiers separated by semicolons ; interrupted by a colon :, followed by the notation for a gap of unknwon extent, all wrapped by low lines _…_.

Overview

NotationConceptual ASTPaper Output
_ω;…:ᵟ[⊙]‽ᵟ_PreviousSeen { witnesses: [ω,…ᵟ], content: [Gap{ ⊙ }], cert: γ }⸤[⊙]ω;…ol.ᵟ◇ᵟ⸥
  • ω;…:ᵟ = optional series of witnesses.
  • ω,…ᵟ = parsed optional series of witnesses.
  • ω;…ol.ᵟ = rendering of the optional series of witnesses followed by the abbreviation of the Latin olim.
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
_[]_
·
_A:[]?_
·A ol.
_A;B:[]!_
·A, B ol.

EpiDoc Outputs

NotationEpiDoc (XML)
_[]_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="medium">
        <gap reason="lost" extent="unknown" unit="character" precision="medium"/>
    </supplied>
</ab>
_A:[]?_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="low" source="#A">
        <gap reason="lost" extent="unknown" unit="character" precision="medium"/>
    </supplied>
</ab>
_A;B:[]!_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="high" source="#A #B">
        <gap reason="lost" extent="unknown" unit="character" precision="medium"/>
    </supplied>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
_[]_
PreviousSeen[medium]
  Gap(unknown, medium)
_A:[]?_
PreviousSeen[low, witnesses: A]
  Gap(unknown, medium)
_A;B:[]!_
PreviousSeen[high, witnesses: A; B]
  Gap(unknown, medium)

Erasure Seen by Earlier Editors

Signs or spaces deliberately erased in antiquity, seen by earlier editors but no longer visible on the support.

Syntax

An optional sequence of witness identifiers separated by semicolons ; interrupted by a colon :, followed by any notation of a phenomenon (IbiUnit) allowed within Erasure, thus enclosed between double square brackets [[…]], wrapped by low lines _…_.

Overview

NotationConceptual ASTPaper Output
_ω;…:ᵟ[[⊙]]‽ᵟ_PreviousSeen { witnesses: [ω,…ᵟ], content: [Erasure { ⊙ }], cert: γ }⸤⟦𝑆×𝑁⟧ω;…ol.ᵟ◇ᵟ⸥
  • ω;…:ᵟ = optional series of witnesses.
  • ω,…ᵟ = parsed optional series of witnesses.
  • ω;…ol.ᵟ = rendering of the optional series of witnesses followed by the abbreviation of the Latin olim.
  • ERASURE_ALLOWED = any phenomena allowed within Erasure (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
_[[abc]]_
abc
_A:[[abc]]?_
abcA ol.
_A;B:[[abc]]!_
abcA, B ol.

EpiDoc Outputs

NotationEpiDoc (XML)
_[[abc]]_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="medium">
        <del cert="medium">
        </supplied>
    </del>
</supplied>
</ab>
_A:[[abc]]?_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="low" source="#A">
        <del cert="medium">
        </supplied>
    </del>
</supplied>
</ab>
_A;B:[[abc]]!_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="high" source="#A #B">
        <del cert="medium">
        </supplied>
    </del>
</supplied>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
_[[abc]]_
PreviousSeen[medium]
  Erasure[medium]
    Plain("abc")
_A:[[abc]]?_
PreviousSeen[low, witnesses: A]
  Erasure[medium]
    Plain("abc")
_A;B:[[abc]]!_
PreviousSeen[high, witnesses: A; B]
  Erasure[medium]
    Plain("abc")

Ligature of Signs Seen by Earlier Editors

A ligature made of as-written signs seen by earlier editors but no longer visible on the support.

Syntax

An optional sequence of witness identifiers separated by semicolons ; interrupted by a colon :, followed by any notation of a phenomenon (IbiUnit) allowed within Ligature enclosed between equal signs =…= and wrapped by low lines _…_.

Overview

NotationConceptual ASTPaper Output
_ω;…:ᵟ=⊙=‽ᵟ_PreviousSeen { witnesses: [ω,…ᵟ], content: [Ligature { ⊙ }], cert: γ }⸤⧵⊙⧷ω;…ol.ᵟ◇ᵟ⸥
  • ω;…:ᵟ = optional series of witnesses.
  • ω,…ᵟ = parsed optional series of witnesses.
  • ω;…ol.ᵟ = rendering of the optional series of witnesses followed by the abbreviation of the Latin olim.
  • LIGATURE_ALLOWED = any phenomena allowed within a Ligature (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
_=abc=_
abc
_A:=abc=?_
abcA ol.
_A;B:=abc=!_
abcA, B ol.

EpiDoc Outputs

NotationEpiDoc (XML)
_=abc=_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="medium">
        <hi rend="ligature" cert="medium">abc</hi>
    </supplied>
</ab>
_A:=abc=?_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="low" source="#A">
        <hi rend="ligature" cert="medium">abc</hi>
    </supplied>
</ab>
_A;B:=abc=!_
<ab>
    <supplied reason="lost" evidence="previouseditor" cert="high" source="#A #B">
        <hi rend="ligature" cert="medium">abc</hi>
    </supplied>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
_=abc=_
PreviousSeen[medium]
  Ligature[medium]
    Plain("abc")
_A:=abc=?_
PreviousSeen[low, witnesses: A]
  Ligature[medium]
    Plain("abc")
_A;B:=abc=!_
PreviousSeen[high, witnesses: A; B]
  Ligature[medium]
    Plain("abc")

Ancient Omissions

Signs, white spaces, or line breaks added by the editor because the inscriber of the text either omitted them or mistakenly inscribed other characters in their place.

Delimiters

SideSignNameUnicode
Left<Less-Than SignU+003C
Right>Greater-Than SignU+003E

Internally Allowed Constructs

ConstructSpecific ReferenceGeneral Reference
Plain📖🔎 Plain
Whitespace📖🔎 Whitespace
Newline🔎 Newline
LineBreak📖🔎 LineBreak
WordBreak🔎 WordBreak
ApparatusMark🔎 ApparatusMark
PlausibilityAssessment🔎 PlausibilityAssessment
Strong🔎 Strong
Emphasis🔎 Emphasis
Comment🔎 Comment

Omitted Signs

As-written signs added by the editor which the inscriber of the text has either omitted or for which he has by error inscribed other signs.

Syntax

Any number of Unicode characters (followed by the optional certainty notation) enclosed between angle brackets <…>.

Overview

NotationConceptual ASTPaper Output
<𝑆×𝑁‽ᵟ>Omitted { content: [Plain("𝑆×𝑁")], cert: γ }〈𝑆×𝑁◇ᵟ〉
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • 𝑛 ∈ ℕ (natural numbers).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
<abc>
abc
<abc?>
abc
<abc!>
abc

EpiDoc Outputs

NotationEpiDoc (XML)
<abc>
<ab>
    <supplied reason="omitted" cert="medium">abc</supplied>
</ab>
<abc?>
<ab>
    <supplied reason="omitted" cert="low">abc</supplied>
</ab>
<abc!>
<ab>
    <supplied reason="omitted" cert="high">abc</supplied>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
<abc>
Omitted[medium]
  Plain("abc")
<abc?>
Omitted[low]
  Plain("abc")
<abc!>
Omitted[high]
  Plain("abc")

Omitted White Spaces

White spaces added by the editor which the inscriber of the text has either omitted or for which he has by error inscribed other signs. Omitted is in fact the only phenomenon that can contain isolated significant white spaces, which are ignored in other cases.

Syntax

Any white space character enclosed between angle brackets <…>.

Overview

NotationConceptual ASTPaper Output
<𝑊‽ᵟ>Omitted { content: [Whitespace], cert: γ }〈 ◇ᵟ〉
  • 𝑊 = any white space.
  • 𝑛 ∈ ℕ (natural numbers).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
< >
<ab c>
abc
< ab c ?>
abc
<a bc!>
abc

EpiDoc Outputs

NotationEpiDoc (XML)
< >
<ab>
    <supplied reason="omitted" cert="medium">
    </supplied>
</ab>
<ab c>
<ab>
    <supplied reason="omitted" cert="medium">abc</supplied>
</ab>
< ab c ?>
<ab>
    <supplied reason="omitted" cert="low">abc</supplied>
</ab>
<a bc!>
<ab>
    <supplied reason="omitted" cert="high">abc</supplied>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
< >
Omitted[medium]
<ab c>
Omitted[medium]
  Plain("ab")
  Plain("c")
< ab c ?>
Omitted[low]
  Plain("ab")
  Plain("c")
<a bc!>
Omitted[high]
  Plain("a")
  Plain("bc")

Omitted Line Breaks

A physical line break in the text, optionally with explicit line numbering, added by the editor which the inscriber of the text has either omitted or for which he has by error inscribed something else. Standard newline characters are not evaluated as valid line breaks to allow for laxity and tolerance towards editorial typos.

Syntax

  • A single number sign # optionally followed by a natural number for explicit line numbering, all enclosed within the dollar-sign wrapper $…$ and wrapped by angle brackets <…>.
  • A single slash / optionally followed by a natural number for explicit line numbering, all enclosed within the dollar-sign wrapper $…$ and wrapped by angle brackets <…>.

Overview

NotationConceptual ASTPaper Output
<#𝑛ᵟ‽ᵟ>Omitted { content: [LineBreak(νₐᵟ)], cert: γ }〈↵◇ᵟ〉
  • 𝑛ᵟ = an optional number 𝑛 ∈ ℕ (natural numbers).
  • = a new line
  • νₐᵟ = any natural number or none.
  • νₑᵟ = n EpiDoc attribute followed by a natural number or none.
  • 𝑛 ∈ ℕ (natural numbers).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
</>
</2?>
</4!>

EpiDoc Outputs

NotationEpiDoc (XML)
</>
<ab>
    <supplied reason="omitted" cert="medium">
    </supplied>
</ab>
</2?>
<ab>
    <supplied reason="omitted" cert="low">
    </supplied>
</ab>
</4!>
<ab>
    <supplied reason="omitted" cert="high">
    </supplied>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
</>
Omitted[medium]
  LineBreak
</2?>
Omitted[low]
  LineBreak(n=2)
</4!>
Omitted[high]
  LineBreak(n=4)

Surplus of Signs

Signs inscribed by error which the editor considers should not be part of the text and are therefore expunged.

Delimiters

SideSignNameUnicode
Left{Left Curly BracketU+007B
Right}Right Curly BracketU+007D

As-Written Superfluous Signs

Superfluous signs added in error by the inscriber of the text and excised by the editor.

Syntax

Any number of Unicode characters (followed by the optional certainty notation) enclosed between curly brackets {…}.

Overview

[{𝑆×𝑁‽ᵟ}], [rust [Surplus { content: [Plain("𝑆×𝑁")], cert: γ }], [{𝑆×𝑁◇ᵟ}], )

  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
{abc}
abc
{abc?}
abc
{abc!}
abc

EpiDoc Outputs

NotationEpiDoc (XML)
{abc}
<ab>
    <surplus cert="medium">abc</surplus>
</ab>
{abc?}
<ab>
    <surplus cert="low">abc</surplus>
</ab>
{abc!}
<ab>
    <surplus cert="high">abc</surplus>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
{abc}
Surplus[medium]
  Plain("abc")
{abc?}
Surplus[low]
  Plain("abc")
{abc!}
Surplus[high]
  Plain("abc")

Superfluous Gap of Known Extent

A superfluous gap of known extent added in error by the inscriber of the text and excised by the editor. The editor indicates a precise number of missing characters by repeating a gap sign inside square brackets.

Syntax

The notation for a gap of known extent placed among square brackets […] and enclosed between curly brackets {…}.

Overview

NotationConceptual ASTPaper Output
{[⊙]‽ᵟ}Surplus { content: [Gap { ⊙ }], cert: γ }{[⊙]◇ᵟ}
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
{[.5.]?}
5
{[.3.]}
3
{[.4.]!}
4

EpiDoc Outputs

NotationEpiDoc (XML)
{[.5.]?}
<ab>
    <surplus cert="low">
        <gap reason="lost" quantity="5" unit="character" precision="medium"/>
    </surplus>
</ab>
{[.3.]}
<ab>
    <surplus cert="medium">
        <gap reason="lost" quantity="3" unit="character" precision="medium"/>
    </surplus>
</ab>
{[.4.]!}
<ab>
    <surplus cert="high">
        <gap reason="lost" quantity="4" unit="character" precision="medium"/>
    </surplus>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
{[.5.]?}
Surplus[low]
  Gap(known=5, medium)
{[.3.]}
Surplus[medium]
  Gap(known=3, medium)
{[.4.]!}
Surplus[high]
  Gap(known=4, medium)

Superfluous Gap of Ranged Extent

A superfluous gap, whose extent is expressed as a plausible numeric range, added in error by the inscriber of the text and excised by the editor.

Syntax

The notation for a gap of ranged extent enclosed between curly brackets {…}.

Overview

NotationConceptual ASTPaper Output
{[⊙]‽ᵟ}Surplus { content: [Gap { ⊙ }], cert: γ }{[⊙]◇ᵟ}
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
{[2-4]}
2–4
{[1-5]?}
1–5
{[3-6]!}
3–6

EpiDoc Outputs

NotationEpiDoc (XML)
{[2-4]}
<ab>
    <surplus cert="medium">
        <gap reason="lost" atLeast="2" atMost="4" unit="character" precision="medium"/>
    </surplus>
</ab>
{[1-5]?}
<ab>
    <surplus cert="low">
        <gap reason="lost" atLeast="1" atMost="5" unit="character" precision="medium"/>
    </surplus>
</ab>
{[3-6]!}
<ab>
    <surplus cert="high">
        <gap reason="lost" atLeast="3" atMost="6" unit="character" precision="medium"/>
    </surplus>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
{[2-4]}
Surplus[medium]
  Gap(range=2–4, medium)
{[1-5]?}
Surplus[low]
  Gap(range=1–5, medium)
{[3-6]!}
Surplus[high]
  Gap(range=3–6, medium)

Superfluous Gap of Unknown Extent

A superfluous gap of unknown extent added in error by the inscriber of the text and excised by the editor.

Syntax

The notation for a gap of unknwon extent enclosed between curly brackets {…}.

Overview

NotationConceptual ASTPaper Output
{[⊙]‽ᵟ}Surplus { content: [Gap { ⊙ }], cert: γ }{[⊙]◇ᵟ}
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
{[]}
·
{[]?}
·
{[]!}
·

EpiDoc Outputs

NotationEpiDoc (XML)
{[]}
<ab>
    <surplus cert="medium">
        <gap reason="lost" extent="unknown" unit="character" precision="medium"/>
    </surplus>
</ab>
{[]?}
<ab>
    <surplus cert="low">
        <gap reason="lost" extent="unknown" unit="character" precision="medium"/>
    </surplus>
</ab>
{[]!}
<ab>
    <surplus cert="high">
        <gap reason="lost" extent="unknown" unit="character" precision="medium"/>
    </surplus>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
{[]}
Surplus[medium]
  Gap(unknown, medium)
{[]?}
Surplus[low]
  Gap(unknown, medium)
{[]!}
Surplus[high]
  Gap(unknown, medium)

Unclear Superfluous Signs

Unclear remaining traces of superflous signs added in error by the inscriber of the text and excised by the editor.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Unclear wrapped by asterisks *…* and enclosed between curly brackets {…}.

Overview

NotationConceptual ASTPaper Output
{*⊙*‽ᵟ}Surplus { content: [Unclear { ⊙ }], cert: γ }{⦇⊙⦈◇ᵟ}
  • UNCLEAR_ALLOWED = any phenomena allowed within Unclear (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
{*abc*}
abc
{*abc*?}
abc
{*abc*!}
abc

EpiDoc Outputs

NotationEpiDoc (XML)
{*abc*}
<ab>
    <surplus cert="medium">
        <unclear cert="medium">abc</unclear>
    </surplus>
</ab>
{*abc*?}
<ab>
    <surplus cert="low">
        <unclear cert="medium">abc</unclear>
    </surplus>
</ab>
{*abc*!}
<ab>
    <surplus cert="high">
        <unclear cert="medium">abc</unclear>
    </surplus>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
{*abc*}
Surplus[medium]
  Unclear[medium, legibility: normal]
    Plain("abc")
{*abc*?}
Surplus[low]
  Unclear[medium, legibility: normal]
    Plain("abc")
{*abc*!}
Surplus[high]
  Unclear[medium, legibility: normal]
    Plain("abc")

Signs Erased in Antiquity and Rasurae

Signs or portions of text intentionally removed from the support in antiquity by scraping or chiselling.

Delimiters

SideSignNameUnicode
Left[[Left Square Bracket, Left Square BracketU+005B U+005B
Right]]Right Square Bracket, Right Square BracketU+005D U+005D

[[abc]] ↓ Formatter optimisation for human legibility ↓ ⟦abc⟧

SideSignNameUnicode
LeftMathematical Left White Square BracketU+27E6
RightMathematical Right White Square BracketU+27E7

Internally Allowed Constructs

ConstructSpecific ReferenceGeneral Reference
Plain📖🔎 Plain
Whitespace🔎 Whitespace
Newline🔎 Newline
WordBreak🔎 WordBreak
Gap-Known📖🔎 Gap-Known
Gap-Range📖🔎 Gap-Range
Gap-Unknown📖🔎 Gap-Unknown
Unclear📖🔎 Unclear
Supplied📖🔎 Supplied
PreviousSeen📖🔎 PreviousSeen
ApparatusMark🔎 ApparatusMark
PlausibilityAssessment🔎 PlausibilityAssessment
Strong🔎 Strong
Emphasis🔎 Emphasis
Comment🔎 Comment

Erasure of As-Written Signs

Signs or spaces deliberately erased in antiquity, still legible.

Syntax

Any number of Unicode characters (followed by the optional certainty notation)

Overview

NotationConceptual ASTPaper Output
[[𝑆×𝑁‽ᵟ]]Erasure { content: [Supplied { content: [Plain("𝑆×𝑁")], cert: γ }], cert: High }⟦𝑆×𝑁◇ᵟ⟧
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • 𝑛 ∈ ℕ (natural numbers).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

See Signs Erased in Antiquity and Rasurae for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
[[abc]]
abc
[[abc?]]
abc
[[abc!]]
abc

EpiDoc Outputs

NotationEpiDoc (XML)
[[abc]]
<ab>
    <del cert="medium">
    </supplied>
</del>
</ab>
[[abc?]]
<ab>
    <del cert="low">
    </supplied>
</del>
</ab>
[[abc!]]
<ab>
    <del cert="high">
    </supplied>
</del>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[[abc]]
Erasure[medium]
  Plain("abc")
[[abc?]]
Erasure[low]
  Plain("abc")
[[abc!]]
Erasure[high]
  Plain("abc")

Rasura (or Gap in Erasure) of Known Extent

A gap of known extent corresponding to an erasure or contained within an ancient erasure.

Syntax

The notation for a gap of known extent enclosed between double square brackets [[…]].

Overview

NotationConceptual ASTPaper Output
[[[⊙]‽ᵟ]]Erasure { content: [Gap { ⊙ }], cert: γ }⟦[⊙]◇ᵟ⟧
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

See Signs Erased in Antiquity and Rasurae for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
[[[.5.]?]]
5
[[[.2.]]]
2
[[[.3.]!]]
3

EpiDoc Outputs

NotationEpiDoc (XML)
[[[.5.]?]]
<ab>
    <del cert="low">
    </supplied>
</del>
</ab>
[[[.2.]]]
<ab>
    <del cert="medium">
    </supplied>
</del>
</ab>
[[[.3.]!]]
<ab>
    <del cert="high">
    </supplied>
</del>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[[[.5.]?]]
Erasure[low]
  Gap(known=5, medium)
[[[.2.]]]
Erasure[medium]
  Gap(known=2, medium)
[[[.3.]!]]
Erasure[high]
  Gap(known=3, medium)

Rasura (or Gap in Erasure) of Ranged Extent

A gap whose extent is expressed as a plausible numeric range, corresponding to an erasure or contained within an ancient erasure.

Syntax

The notation for a gap of ranged extent enclosed between double square brackets [[…]].

Overview

NotationConceptual ASTPaper Output
[[[⊙]‽ᵟ]]Erasure { content: [Gap { ⊙ }], cert: γ }⟦[⊙]◇ᵟ⟧
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

See Signs Erased in Antiquity and Rasurae for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
[[[3-6]]]
3–6
[[[4-5]?]]
4–5
[[[2-4]!]]
2–4

EpiDoc Outputs

NotationEpiDoc (XML)
[[[3-6]]]
<ab>
    <del cert="medium">
    </supplied>
</del>
</ab>
[[[4-5]?]]
<ab>
    <del cert="low">
    </supplied>
</del>
</ab>
[[[2-4]!]]
<ab>
    <del cert="high">
    </supplied>
</del>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[[[3-6]]]
Erasure[medium]
  Gap(range=3–6, medium)
[[[4-5]?]]
Erasure[low]
  Gap(range=4–5, medium)
[[[2-4]!]]
Erasure[high]
  Gap(range=2–4, medium)

Rasura (or Gap in Erasure) of Unknown Extent

A gap of unknown extent corresponding to an erasure or contained within an ancient erasure.

Syntax

The notation for a gap of unknwon extent enclosed between double square brackets [[…]].

Overview

[[[[⊙‽ᵟ]]], [rust Erasure { content: [Gap { ⊙ }], cert: γ }], [⟦[⊙]◇ᵟ⟧], )

  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

See Signs Erased in Antiquity and Rasurae for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
[[[]]]
·
[[[]?]]
·
[[[]!]]
·

EpiDoc Outputs

NotationEpiDoc (XML)
[[[]]]
<ab>
    <del cert="medium">
    </supplied>
</del>
</ab>
[[[]?]]
<ab>
    <del cert="low">
    </supplied>
</del>
</ab>
[[[]!]]
<ab>
    <del cert="high">
    </supplied>
</del>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[[[]]]
Erasure[medium]
  Gap(unknown, medium)
[[[]?]]
Erasure[low]
  Gap(unknown, medium)
[[[]!]]
Erasure[high]
  Gap(unknown, medium)

Erasure of Unclear Signs

Signs or spaces deliberately erased in antiquity whose reading is unclear.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Unclear wrapped by asterisks *…* and enclosed between double square brackets [[…]].

Overview

NotationConceptual ASTPaper Output
[[*⊙*‽ᵟ]]Erasure { content: [Unclear { ⊙ }], cert: γ }⟦⦇⊙⦈◇ᵟ⟧
  • UNCLEAR_ALLOWED = any phenomena allowed within Unclear (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

See Signs Erased in Antiquity and Rasurae for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
[[*abc*]]
abc
[[*abc*?]]
abc
[[*abc*!]]
abc

EpiDoc Outputs

NotationEpiDoc (XML)
[[*abc*]]
<ab>
    <del cert="medium">
    </supplied>
</del>
</ab>
[[*abc*?]]
<ab>
    <del cert="low">
    </supplied>
</del>
</ab>
[[*abc*!]]
<ab>
    <del cert="high">
    </supplied>
</del>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[[*abc*]]
Erasure[medium]
  Unclear[medium, legibility: normal]
    Plain("abc")
[[*abc*?]]
Erasure[low]
  Unclear[medium, legibility: normal]
    Plain("abc")
[[*abc*!]]
Erasure[high]
  Unclear[medium, legibility: normal]
    Plain("abc")

Erasure of Supplied Signs

Signs or spaces deliberately erased in antiquity whose reading has been supplied by the editor.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Supplied wrapped by square brackets […] and enclosed between double square brackets [[…]].

Overview

NotationConceptual ASTPaper Output
[[[⊙]‽ᵟ]]Erasure { content: [Supplied { ⊙ }], cert: γ }⟦[⊙]◇ᵟ⟧
  • SUPPLIED_ALLOWED = any phenomena allowed within Supplied (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

See Signs Erased in Antiquity and Rasurae for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
[[[abc]]]
abc
[[[abc]?]]
abc
[[[abc]!]]
abc

EpiDoc Outputs

NotationEpiDoc (XML)
[[[abc]]]
<ab>
    <del cert="medium">
        <supplied reason="lost" cert="medium">abc</supplied>
    </del>
</ab>
[[[abc]?]]
<ab>
    <del cert="low">
        <supplied reason="lost" cert="medium">abc</supplied>
    </del>
</ab>
[[[abc]!]]
<ab>
    <del cert="high">
        <supplied reason="lost" cert="medium">abc</supplied>
    </del>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[[[abc]]]
Erasure[medium]
  Supplied[medium]
    Plain("abc")
[[[abc]?]]
Erasure[low]
  Supplied[medium]
    Plain("abc")
[[[abc]!]]
Erasure[high]
  Supplied[medium]
    Plain("abc")

Erasure with Signs Seen by Earlier Editors

Signs or spaces deliberately erased in antiquity seen by earlier editors but no longer visible on the support.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within PreviousSeen enclosed between double square brackets [[…]].

Overview

NotationConceptual ASTPaper Output
[[_⊙_‽ᵟ]]Erasure { content: [PreviousSeen { ⊙ }], cert: γ }⟦⸤⊙⸥◇ᵟ⟧
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • PREVIOUS_SEEN_ALLOWED = any phenomena allowed within PreviousSeen (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.

See Signs Erased in Antiquity and Rasurae for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
[[_abc_]]
abc
[[_abc_?]]
abc
[[_abc_!]]
abc

EpiDoc Outputs

NotationEpiDoc (XML)
[[_abc_]]
<ab>
    <del cert="medium">
    </supplied>
</del>
</ab>
[[_abc_?]]
<ab>
    <del cert="low">
    </supplied>
</del>
</ab>
[[_abc_!]]
<ab>
    <del cert="high">
    </supplied>
</del>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[[_abc_]]
Erasure[medium]
  PreviousSeen[medium]
    Plain("abc")
[[_abc_?]]
Erasure[low]
  PreviousSeen[medium]
    Plain("abc")
[[_abc_!]]
Erasure[high]
  PreviousSeen[medium]
    Plain("abc")

Later Ancient Additions of Signs

Signs, words, or portions of text added to the support at a later time than the original drafting, often by a different hand.

Delimiters

SideSignNameUnicode
Left+Plus SignU+002B
Right+Plus SignU+002B

+abc+ ↓ Formatter optimisation for human legibility ↓ +abc‡

SideSignNameUnicode
Left+Plus SignU+002B
RightDouble DaggerU+2021

Internally Allowed Constructs

ConstructSpecific ReferenceGeneral Reference
Plain📖🔎 Plain
Whitespace🔎 Whitespace
Newline🔎 Newline
WordBreak🔎 WordBreak
Gap-Known📖🔎 Gap-Known
Gap-Range📖🔎 Gap-Range
Gap-Unknown📖🔎 Gap-Unknown
Unclear📖🔎 Unclear
Supplied📖🔎 Supplied
PreviousSeen📖🔎 PreviousSeen
Surplus🔎 Surplus
ApparatusMark🔎 ApparatusMark
PlausibilityAssessment🔎 PlausibilityAssessment
Strong🔎 Strong
Emphasis🔎 Emphasis
Comment🔎 Comment

Supported Metadata Keys

KeyMeaningFormattingMinification
hand, h, manus, manhandhandh
place, p, placementplaceplacep

Addition of As-Written Signs

An addition by a later ancient hand of as-written signs.

Syntax

Any sequence of Unicode characters representing Plain content enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+𝑆×𝑁‽ᵟ¤ᵟ+Addition { content: [Plain("𝑆×𝑁")], cert: γ, meta: ¤ }𝘏ᵟ``⸂𝑆×𝑁◇ᵟ⸃
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • 𝑛 ∈ ℕ (natural numbers).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Addition (cf. Later Ancient Additions of Signs).

See Later Ancient Additions of Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+abc+
abc
+abc?;h=c>d+
cdabc
+abc!;manus=c;place=supra+
caboveabc

EpiDoc Outputs

NotationEpiDoc (XML)
+abc+
<ab>
    <add cert="medium">abc</add>
</ab>
+abc?;h=c>d+
<ab>
    <add cert="low">abc<app type="alternative"><lem><handShift new="#c"/>abc</lem><rdg><handShift new="#d"/>abc</rdg></app></add>
</ab>
+abc!;manus=c;place=supra+
<ab>
    <add place="above" cert="medium">abc<app type="alternative"><rdg><handShift new="#c"/>abc</rdg></app></add>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+abc+
Addition[medium]
  Plain("abc")
+abc?;h=c>d+
Addition[low][meta]
  Plain("abc")
+abc!;manus=c;place=supra+
Addition[medium][meta]
  Plain("abc")

Addition Containing Gap of Known Extent

A gap of known extent (a specific number of missing or lost characters) contained inside an addition to the support by a later ancient hand.

Syntax

The notation for a gap of known extent wrapped within plus signs +…+.

Overview

NotationConceptual ASTPaper Output
+[⊙]‽ᵟ¤ᵟ+Addition { content: [Gap { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸂[⊙]◇ᵟ⸃
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Addition (cf. Later Ancient Additions of Signs).

See Later Ancient Additions of Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+[.7.]?;h=c>d+
cd7
+[.4.]+
4
+[.2.]!;manus=c;place=supra+
cabove2

EpiDoc Outputs

NotationEpiDoc (XML)
+[.7.]?;h=c>d+
<ab>
    <add cert="low">
        <gap reason="lost" quantity="7" unit="character" precision="medium"/><app type="alternative"><lem><handShift new="#c"/><gap reason="lost" quantity="7" unit="character" precision="medium"/></lem><rdg><handShift new="#d"/><gap reason="lost" quantity="7" unit="character" precision="medium"/></rdg></app>
    </add>
</ab>
+[.4.]+
<ab>
    <add cert="medium">
        <gap reason="lost" quantity="4" unit="character" precision="medium"/>
    </add>
</ab>
+[.2.]!;manus=c;place=supra+
<ab>
    <add place="above" cert="medium">
        <gap reason="lost" quantity="2" unit="character" precision="medium"/><app type="alternative"><rdg><handShift new="#c"/><gap reason="lost" quantity="2" unit="character" precision="medium"/></rdg></app>
    </add>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+[.7.]?;h=c>d+
Addition[low][meta]
  Gap(known=7, medium)
+[.4.]+
Addition[medium]
  Gap(known=4, medium)
+[.2.]!;manus=c;place=supra+
Addition[medium][meta]
  Gap(known=2, medium)

Addition Containing Gap of Ranged Extent

A gap added by a later ancient hand whose extent is expressed as a plausible numeric range contained inside an addition to the support by a later ancient hand.

Syntax

The notation for a gap of ranged extent wrapped within plus signs +…+. Optional metadata can be written before the final + delimiter. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+[⊙]‽ᵟ¤ᵟ+Addition { content: [Gap { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸂[⊙]◇ᵟ⸃
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Addition (cf. Later Ancient Additions of Signs).

See Later Ancient Additions of Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+[1-3]+
1–3
+[2-4]?;h=c>d+
cd2–4

EpiDoc Outputs

NotationEpiDoc (XML)
+[1-3]+
<ab>
    <add cert="medium">
        <gap reason="lost" atLeast="1" atMost="3" unit="character" precision="medium"/>
    </add>
</ab>
+[2-4]?;h=c>d+
<ab>
    <add cert="low">
        <gap reason="lost" atLeast="2" atMost="4" unit="character" precision="medium"/><app type="alternative"><lem><handShift new="#c"/><gap reason="lost" atLeast="2" atMost="4" unit="character" precision="medium"/></lem><rdg><handShift new="#d"/><gap reason="lost" atLeast="2" atMost="4" unit="character" precision="medium"/></rdg></app>
    </add>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+[1-3]+
Addition[medium]
  Gap(range=1–3, medium)
+[2-4]?;h=c>d+
Addition[low][meta]
  Gap(range=2–4, medium)

Addition Containing Gap of Unknown Extent

A gap of unknown extent (lost or illegible signs where the original number of characters cannot be estimated) contained inside an addition to the support by a later ancient hand.

Syntax

Zero or more white spaces wrapped by square brackets […], all enclosed within plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+[⊙]‽ᵟ¤ᵟ+Addition { content: [Gap { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸂[⊙]◇ᵟ⸃
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Addition (cf. Later Ancient Additions of Signs).

See Later Ancient Additions of Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+[]+
·
+[]?;h=c>d+
cd·
+[]!;manus=c;place=supra+
cabove·

EpiDoc Outputs

NotationEpiDoc (XML)
+[]+
<ab>
    <add cert="medium">
        <gap reason="lost" extent="unknown" unit="character" precision="medium"/>
    </add>
</ab>
+[]?;h=c>d+
<ab>
    <add cert="low">
        <gap reason="lost" extent="unknown" unit="character" precision="medium"/><app type="alternative"><lem><handShift new="#c"/><gap reason="lost" extent="unknown" unit="character" precision="medium"/></lem><rdg><handShift new="#d"/><gap reason="lost" extent="unknown" unit="character" precision="medium"/></rdg></app>
    </add>
</ab>
+[]!;manus=c;place=supra+
<ab>
    <add place="above" cert="medium">
        <gap reason="lost" extent="unknown" unit="character" precision="medium"/><app type="alternative"><rdg><handShift new="#c"/><gap reason="lost" extent="unknown" unit="character" precision="medium"/></rdg></app>
    </add>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+[]+
Addition[medium]
  Gap(unknown, medium)
+[]?;h=c>d+
Addition[low][meta]
  Gap(unknown, medium)
+[]!;manus=c;place=supra+
Addition[medium][meta]
  Gap(unknown, medium)

Addition of Unclear Signs

An addition by a later ancient hand of unclear signs.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Unclear wrapped by asterisks *…* representing the addition, enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+*⊙*‽ᵟ¤ᵟ+Addition { content: [Unclear { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸂⦇⊙⦈◇ᵟ⸃
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • UNCLEAR_ALLOWED = any phenomena allowed within Unclear (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Addition (cf. Later Ancient Additions of Signs).

See Later Ancient Additions of Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+*abc*+
abc
+*abc*?;h=c>d+
cdabc
+*abc*!;manus=c;place=supra+
caboveabc

EpiDoc Outputs

NotationEpiDoc (XML)
+*abc*+
<ab>
    <add cert="medium">
        <unclear cert="medium">abc</unclear>
    </add>
</ab>
+*abc*?;h=c>d+
<ab>
    <add cert="low">
        <unclear cert="medium">abc</unclear><app type="alternative"><lem><handShift new="#c"/><unclear cert="medium">abc</unclear></lem><rdg><handShift new="#d"/><unclear cert="medium">abc</unclear></rdg></app>
    </add>
</ab>
+*abc*!;manus=c;place=supra+
<ab>
    <add place="above" cert="medium">
        <unclear cert="medium">abc</unclear><app type="alternative"><rdg><handShift new="#c"/><unclear cert="medium">abc</unclear></rdg></app>
    </add>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+*abc*+
Addition[medium]
  Unclear[medium, legibility: normal]
    Plain("abc")
+*abc*?;h=c>d+
Addition[low][meta]
  Unclear[medium, legibility: normal]
    Plain("abc")
+*abc*!;manus=c;place=supra+
Addition[medium][meta]
  Unclear[medium, legibility: normal]
    Plain("abc")

Addition of Supplied Signs

Signs restored by the editor as once having been inscribed by a later ancient hand, but which are now lost.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Supplied as the addition content enclosed in square brackets […] to indicate restoration, all wrapped within plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+[⊙]‽ᵟ¤ᵟ+Addition { content: [Supplied { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸂[⊙]◇ᵟ⸃
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • SUPPLIED_ALLOWED = any phenomena allowed within Supplied (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Addition (cf. Later Ancient Additions of Signs).

See Later Ancient Additions of Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+[abc]+
abc
+[abc]?;h=c>d+
cdabc
+[abc]!;manus=c;place=supra+
caboveabc

EpiDoc Outputs

NotationEpiDoc (XML)
+[abc]+
<ab>
    <add cert="medium">
        <supplied reason="lost" cert="medium">abc</supplied>
    </add>
</ab>
+[abc]?;h=c>d+
<ab>
    <add cert="low">
        <supplied reason="lost" cert="medium">abc</supplied><app type="alternative"><lem><handShift new="#c"/><supplied reason="lost" cert="medium">abc</supplied></lem><rdg><handShift new="#d"/><supplied reason="lost" cert="medium">abc</supplied></rdg></app>
    </add>
</ab>
+[abc]!;manus=c;place=supra+
<ab>
    <add place="above" cert="medium">
        <supplied reason="lost" cert="medium">abc</supplied><app type="alternative"><rdg><handShift new="#c"/><supplied reason="lost" cert="medium">abc</supplied></rdg></app>
    </add>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+[abc]+
Addition[medium]
  Supplied[medium]
    Plain("abc")
+[abc]?;h=c>d+
Addition[low][meta]
  Supplied[medium]
    Plain("abc")
+[abc]!;manus=c;place=supra+
Addition[medium][meta]
  Supplied[medium]
    Plain("abc")

Addition of Signs Seen by Earlier Editors

Signs added by a later ancient hand that were seen and recorded by earlier editors, but are no longer visible on the support.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within PreviousSeen enclosed between low lines _…_ to indicate previous observation, all wrapped within plus signs +…+. Metadati opzionali sono scrivibili prima dell’ultimo delimitatore +.

Overview

NotationConceptual ASTPaper Output
+_⊙_‽ᵟ¤ᵟ+Addition { content: [PreviousSeen { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸂⸤⊙⸥◇ᵟ⸃
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • PREVIOUS_SEEN_ALLOWED = any phenomena allowed within PreviousSeen (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Addition (cf. Later Ancient Additions of Signs).

See Later Ancient Additions of Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+_abc_+
abc
+_abc_?;h=c>d+
cdabc
+_abc_!;manus=c;place=supra+
caboveabc

EpiDoc Outputs

NotationEpiDoc (XML)
+_abc_+
<ab>
    <add cert="medium">
        <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
    </add>
</ab>
+_abc_?;h=c>d+
<ab>
    <add cert="low">
        <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied><app type="alternative"><lem><handShift new="#c"/><supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied></lem><rdg><handShift new="#d"/><supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied></rdg></app>
    </add>
</ab>
+_abc_!;manus=c;place=supra+
<ab>
    <add place="above" cert="medium">
        <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied><app type="alternative"><rdg><handShift new="#c"/><supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied></rdg></app>
    </add>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+_abc_+
Addition[medium]
  PreviousSeen[medium]
    Plain("abc")
+_abc_?;h=c>d+
Addition[low][meta]
  PreviousSeen[medium]
    Plain("abc")
+_abc_!;manus=c;place=supra+
Addition[medium][meta]
  PreviousSeen[medium]
    Plain("abc")

Superfluous Addition

Signs added by a later ancient hand that are considered superfluous by the editor and thus excised.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Surplus enclosed within curly brackets {…} representing the superfluous text, all wrapped within plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+{⊙}‽ᵟ¤ᵟ+Addition { content: [Surplus { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸂{⊙}◇ᵟ⸃
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • SURPLUS_ALLOWED = any phenomena allowed within Surplus (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Addition (cf. Later Ancient Additions of Signs).

See Later Ancient Additions of Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+{abc}+
abc
+{abc}?;h=c>d+
cdabc
+{abc}!;manus=c;place=supra+
caboveabc

EpiDoc Outputs

NotationEpiDoc (XML)
+{abc}+
<ab>
    <add cert="medium">
        <surplus cert="medium">abc</surplus>
    </add>
</ab>
+{abc}?;h=c>d+
<ab>
    <add cert="low">
        <surplus cert="medium">abc</surplus><app type="alternative"><lem><handShift new="#c"/><surplus cert="medium">abc</surplus></lem><rdg><handShift new="#d"/><surplus cert="medium">abc</surplus></rdg></app>
    </add>
</ab>
+{abc}!;manus=c;place=supra+
<ab>
    <add place="above" cert="medium">
        <surplus cert="medium">abc</surplus><app type="alternative"><rdg><handShift new="#c"/><surplus cert="medium">abc</surplus></rdg></app>
    </add>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+{abc}+
Addition[medium]
  Surplus[medium]
    Plain("abc")
+{abc}?;h=c>d+
Addition[low][meta]
  Surplus[medium]
    Plain("abc")
+{abc}!;manus=c;place=supra+
Addition[medium][meta]
  Surplus[medium]
    Plain("abc")

Erased Addition

Signs added by a later ancient hand that were subsequently deliberately erased in antiquity.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Erasure, thus enclosed within double square brackets [[…]], all wrapped within plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+[[⊙]]‽ᵟ¤ᵟ+Addition { content: [Erasure { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸂⟦⊙⟧◇ᵟ⸃
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • ERASURE_ALLOWED = any phenomena allowed within Erasure (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Addition (cf. Later Ancient Additions of Signs).

See Later Ancient Additions of Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+[[abc]]+
abc
+[[abc]]?;h=c>d+
cdabc
+[[abc]]!;manus=c;place=supra+
caboveabc

EpiDoc Outputs

NotationEpiDoc (XML)
+[[abc]]+
<ab>
    <add cert="medium">
        <del cert="medium">
        </supplied>
    </del>
</add>
</ab>
+[[abc]]?;h=c>d+
<ab>
    <add cert="low">
        <del cert="medium">
        </supplied>
    </del><app type="alternative"><lem><handShift new="#c"/><del cert="medium"></supplied></del></lem><rdg><handShift new="#d"/><del cert="medium"></supplied></del></rdg></app>
</add>
</ab>
+[[abc]]!;manus=c;place=supra+
<ab>
    <add place="above" cert="medium">
        <del cert="medium">
        </supplied>
    </del><app type="alternative"><rdg><handShift new="#c"/><del cert="medium"></supplied></del></rdg></app>
</add>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+[[abc]]+
Addition[medium]
  Erasure[medium]
    Plain("abc")
+[[abc]]?;h=c>d+
Addition[low][meta]
  Erasure[medium]
    Plain("abc")
+[[abc]]!;manus=c;place=supra+
Addition[medium][meta]
  Erasure[medium]
    Plain("abc")

Addition of Ligated Signs

An addition by a later ancient hand of ligated signs.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Ligature wrapped by equal signs =…= representing the addition, enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+=⊙=‽ᵟ¤ᵟ+Addition { content: [Ligature { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸂⧵⊙⧷◇ᵟ⸃
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • LIGATURE_ALLOWED = any phenomena allowed within a Ligature (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Addition (cf. Later Ancient Additions of Signs).

See Later Ancient Additions of Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+=abc=+
abc
+=abc=?;h=c>d+
cdabc
+=abc=!;manus=c;place=supra+
caboveabc

EpiDoc Outputs

NotationEpiDoc (XML)
+=abc=+
<ab>
    <add cert="medium">
        <hi rend="ligature" cert="medium">abc</hi>
    </add>
</ab>
+=abc=?;h=c>d+
<ab>
    <add cert="low">
        <hi rend="ligature" cert="medium">abc</hi><app type="alternative"><lem><handShift new="#c"/><hi rend="ligature" cert="medium">abc</hi></lem><rdg><handShift new="#d"/><hi rend="ligature" cert="medium">abc</hi></rdg></app>
    </add>
</ab>
+=abc=!;manus=c;place=supra+
<ab>
    <add place="above" cert="medium">
        <hi rend="ligature" cert="medium">abc</hi><app type="alternative"><rdg><handShift new="#c"/><hi rend="ligature" cert="medium">abc</hi></rdg></app>
    </add>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+=abc=+
Addition[medium]
  Ligature[medium]
    Plain("abc")
+=abc=?;h=c>d+
Addition[low][meta]
  Ligature[medium]
    Plain("abc")
+=abc=!;manus=c;place=supra+
Addition[medium][meta]
  Ligature[medium]
    Plain("abc")

Ancient Corrections

Corrective interventions on the support consisting in the erasure of pre-existing signs and their replacement with new ones, carried out at a later time than the original drafting, often by a different hand.

Delimiters

SideSignNameUnicode
Left+Plus SignU+002B
Right+Plus SignU+002B

+abc+ ↓ Formatter optimisation for human legibility ↓ +abc‡

SideSignNameUnicode
Left+Plus SignU+002B
RightDouble DaggerU+2021

Supported Metadata Keys

KeyMeaningFormattingMinification
hand, h, manus, manhandhandh
place, p, placementplaceplacep

Deleted Text in Correction

Phenomena related to the deleted text of the correction.

Internally Allowed Constructs

ConstructSpecific ReferenceGeneral Reference
Plain📖🔎 Plain
Whitespace🔎 Whitespace
Newline🔎 Newline
WordBreak🔎 WordBreak
Gap-Known📖🔎 Gap-Known
Gap-Range📖🔎 Gap-Range
Gap-Unknown📖🔎 Gap-Unknown
Unclear📖🔎 Unclear
Supplied📖🔎 Supplied
PreviousSeen📖🔎 PreviousSeen
Erasure📖🔎 Erasure
Ligature📖🔎 Ligature
ApparatusMark🔎 ApparatusMark
PlausibilityAssessment🔎 PlausibilityAssessment
Strong🔎 Strong
Emphasis🔎 Emphasis
Comment🔎 Comment

As-Written Signs Deleted in Correction

As-written signs deleted in an ancient correction.

Syntax

Any sequence of Unicode characters representing Plain content followed by an equal sign and a greater-than sign forming a => arrow, then by the added text notation, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+𝑆×𝑁=>…‽ᵟ¤ᵟ+Correction { deleted: [Plain("𝑆×𝑁")], added:…, cert: γ, meta: ¤ }𝘏ᵟ``⸄𝑆×𝑁 ↦ …◇ᵟ⸅
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • 𝑛 ∈ ℕ (natural numbers).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+abc=>xyz+
abcxyz
+abc=>xyz?;h=c>d+
cdabcxyz
+abc=>xyz!;manus=c;place=supra+
caboveabcxyz

EpiDoc Outputs

NotationEpiDoc (XML)
+abc=>xyz+
<ab>
    <subst>
        <del cert="medium">abc</del>
        <add cert="medium">xyz</add>
    </subst>
</ab>
+abc=>xyz?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>abc</del>
        <add cert="low">xyz<app type="alternative"><lem><handShift new="#c"/>xyz</lem><rdg><handShift new="#d"/>xyz</rdg></app></add>
    </subst>
</ab>
+abc=>xyz!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>abc</del>
        <add place="above" cert="medium">xyz<app type="alternative"><rdg><handShift new="#c"/>xyz</rdg></app></add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+abc=>xyz+
Correction[medium]
  deleted:
    Plain("abc")
  added:
    Plain("xyz")
+abc=>xyz?;h=c>d+
Correction[low][meta]
  deleted:
    Plain("abc")
  added:
    Plain("xyz")
+abc=>xyz!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Plain("abc")
  added:
    Plain("xyz")

Deleted Text (in Correction) with Gap of Known Extent

A gap of known extent (a specific number of missing or lost characters) contained in the deleted text of an ancient correction.

Syntax

The notation for a gap of known extent followed by an equal sign and a greater-than sign forming a => arrow, then by the added text notation, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+[⊙]=>…‽ᵟ¤ᵟ+Correction { deleted: [Gap { ⊙ }], added:…, cert: γ, meta: ¤ }𝘏ᵟ``⸄[⊙] ↦ …◇ᵟ⸅
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+[.7.]=>xyz?;h=c>d+
cd7xyz
+[.5.]=>xyz+
5xyz
+[.2.]=>xyz!;manus=c;place=supra+
cabove2xyz

EpiDoc Outputs

NotationEpiDoc (XML)
+[.7.]=>xyz?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>
            <gap reason="lost" quantity="7" unit="character" precision="medium"/>
        </del>
        <add cert="low">xyz<app type="alternative"><lem><handShift new="#c"/>xyz</lem><rdg><handShift new="#d"/>xyz</rdg></app></add>
    </subst>
</ab>
+[.5.]=>xyz+
<ab>
    <subst>
        <del cert="medium">
            <gap reason="lost" quantity="5" unit="character" precision="medium"/>
        </del>
        <add cert="medium">xyz</add>
    </subst>
</ab>
+[.2.]=>xyz!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>
            <gap reason="lost" quantity="2" unit="character" precision="medium"/>
        </del>
        <add place="above" cert="medium">xyz<app type="alternative"><rdg><handShift new="#c"/>xyz</rdg></app></add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+[.7.]=>xyz?;h=c>d+
Correction[low][meta]
  deleted:
    Gap(known=7, medium)
  added:
    Plain("xyz")
+[.5.]=>xyz+
Correction[medium]
  deleted:
    Gap(known=5, medium)
  added:
    Plain("xyz")
+[.2.]=>xyz!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Gap(known=2, medium)
  added:
    Plain("xyz")

Deleted Text (in Correction) with Gap of Ranged Extent

A gap added by a later ancient hand whose extent is expressed as a plausible numeric range contained in the deleted text of an ancient correction.

Syntax

The notation for a gap of ranged extent followed by an equal sign and a greater-than sign forming a => arrow, then by the added text notation, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+[⊙]=>…‽ᵟ¤ᵟ+Correction { deleted: [Gap { ⊙ }], added:…, cert: γ, meta: ¤ }𝘏ᵟ``⸄[⊙] ↦ …◇ᵟ⸅
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+[1-3]=>xyz+
1–3xyz
+[2-4]=>xyz?;h=c>d+
cd2–4xyz

EpiDoc Outputs

NotationEpiDoc (XML)
+[1-3]=>xyz+
<ab>
    <subst>
        <del cert="medium">
            <gap reason="lost" atLeast="1" atMost="3" unit="character" precision="medium"/>
        </del>
        <add cert="medium">xyz</add>
    </subst>
</ab>
+[2-4]=>xyz?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>
            <gap reason="lost" atLeast="2" atMost="4" unit="character" precision="medium"/>
        </del>
        <add cert="low">xyz<app type="alternative"><lem><handShift new="#c"/>xyz</lem><rdg><handShift new="#d"/>xyz</rdg></app></add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+[1-3]=>xyz+
Correction[medium]
  deleted:
    Gap(range=1–3, medium)
  added:
    Plain("xyz")
+[2-4]=>xyz?;h=c>d+
Correction[low][meta]
  deleted:
    Gap(range=2–4, medium)
  added:
    Plain("xyz")

Deleted Text (in Correction) with Gap of Unknown Extent

A gap of unknown extent (lost or illegible signs where the original number of characters cannot be estimated) contained in the deleted text of an ancient correction.

Syntax

The notation for a gap of unknwon extent, followed by an equal sign and a greater-than sign forming a => arrow, then by the added text notation, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+[⊙]=>…‽ᵟ¤ᵟ+Correction { deleted: [Gap { ⊙ }], added:…, cert: γ, meta: ¤ }𝘏ᵟ``⸄[⊙] ↦ …◇ᵟ⸅
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+[]=>xyz+
·xyz
+[]=>xyz?;h=c>d+
cd·xyz
+[]=>xyz!;manus=c;place=supra+
cabove·xyz

EpiDoc Outputs

NotationEpiDoc (XML)
+[]=>xyz+
<ab>
    <subst>
        <del cert="medium">
            <gap reason="lost" extent="unknown" unit="character" precision="medium"/>
        </del>
        <add cert="medium">xyz</add>
    </subst>
</ab>
+[]=>xyz?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>
            <gap reason="lost" extent="unknown" unit="character" precision="medium"/>
        </del>
        <add cert="low">xyz<app type="alternative"><lem><handShift new="#c"/>xyz</lem><rdg><handShift new="#d"/>xyz</rdg></app></add>
    </subst>
</ab>
+[]=>xyz!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>
            <gap reason="lost" extent="unknown" unit="character" precision="medium"/>
        </del>
        <add place="above" cert="medium">xyz<app type="alternative"><rdg><handShift new="#c"/>xyz</rdg></app></add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+[]=>xyz+
Correction[medium]
  deleted:
    Gap(unknown, medium)
  added:
    Plain("xyz")
+[]=>xyz?;h=c>d+
Correction[low][meta]
  deleted:
    Gap(unknown, medium)
  added:
    Plain("xyz")
+[]=>xyz!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Gap(unknown, medium)
  added:
    Plain("xyz")

Unclear Signs Deleted in Correction

Unclear signs deleted in an ancient correction.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Unclear, thus wrapped by asterisks *…* representing the addition, followed by an equal sign and a greater-than sign forming a => arrow, then by the added text notation, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+*⊙*=>…‽ᵟ¤ᵟ+Correction { deleted: [Unclear { ⊙ }], added:…, cert: γ, meta: ¤ }𝘏ᵟ``⸄⦇⊙⦈ ↦ …◇ᵟ⸅
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • UNCLEAR_ALLOWED = any phenomena allowed within Unclear (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+*abc*=>xyz+
abcxyz
+*abc*=>xyz?;h=c>d+
cdabcxyz
+*abc*=>xyz!;manus=c;place=supra+
caboveabcxyz

EpiDoc Outputs

NotationEpiDoc (XML)
+*abc*=>xyz+
<ab>
    <subst>
        <del cert="medium">
            <unclear cert="medium">abc</unclear>
        </del>
        <add cert="medium">xyz</add>
    </subst>
</ab>
+*abc*=>xyz?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>
            <unclear cert="medium">abc</unclear>
        </del>
        <add cert="low">xyz<app type="alternative"><lem><handShift new="#c"/>xyz</lem><rdg><handShift new="#d"/>xyz</rdg></app></add>
    </subst>
</ab>
+*abc*=>xyz!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>
            <unclear cert="medium">abc</unclear>
        </del>
        <add place="above" cert="medium">xyz<app type="alternative"><rdg><handShift new="#c"/>xyz</rdg></app></add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+*abc*=>xyz+
Correction[medium]
  deleted:
    Unclear[medium, legibility: normal]
      Plain("abc")
  added:
    Plain("xyz")
+*abc*=>xyz?;h=c>d+
Correction[low][meta]
  deleted:
    Unclear[medium, legibility: normal]
      Plain("abc")
  added:
    Plain("xyz")
+*abc*=>xyz!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Unclear[medium, legibility: normal]
      Plain("abc")
  added:
    Plain("xyz")

Supplied Signs Deleted in Correction

Signs restored by the editor as once having been deleted in an ancient correction.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Supplied, thus with the addition content enclosed in square brackets […] to indicate restoration, followed by an equal sign and a greater-than sign forming a => arrow, then by the added text notation, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+[⊙]=>…‽ᵟ¤ᵟ+Correction { deleted: [Supplied { ⊙ }], added:…, cert: γ, meta: ¤ }𝘏ᵟ``⸄[⊙] ↦ …◇ᵟ⸅
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • SUPPLIED_ALLOWED = any phenomena allowed within Supplied (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+[abc]=>xyz+
abcxyz
+[abc]=>xyz?;h=c>d+
cdabcxyz
+[abc]=>xyz!;manus=c;place=supra+
caboveabcxyz

EpiDoc Outputs

NotationEpiDoc (XML)
+[abc]=>xyz+
<ab>
    <subst>
        <del cert="medium">
            <supplied reason="lost" cert="medium">abc</supplied>
        </del>
        <add cert="medium">xyz</add>
    </subst>
</ab>
+[abc]=>xyz?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>
            <supplied reason="lost" cert="medium">abc</supplied>
        </del>
        <add cert="low">xyz<app type="alternative"><lem><handShift new="#c"/>xyz</lem><rdg><handShift new="#d"/>xyz</rdg></app></add>
    </subst>
</ab>
+[abc]=>xyz!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>
            <supplied reason="lost" cert="medium">abc</supplied>
        </del>
        <add place="above" cert="medium">xyz<app type="alternative"><rdg><handShift new="#c"/>xyz</rdg></app></add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+[abc]=>xyz+
Correction[medium]
  deleted:
    Supplied[medium]
      Plain("abc")
  added:
    Plain("xyz")
+[abc]=>xyz?;h=c>d+
Correction[low][meta]
  deleted:
    Supplied[medium]
      Plain("abc")
  added:
    Plain("xyz")
+[abc]=>xyz!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Supplied[medium]
      Plain("abc")
  added:
    Plain("xyz")

Signs Deleted in Correction Seen by Earlier Editors

Signs deleted in an ancient correction that were seen and recorded by earlier editors, but are no longer visible on the support.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within PreviousSeen, thus enclosed between low lines _…_ to indicate previous observation, followed by an equal sign and a greater-than sign forming a => arrow, then by the added text notation, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Overview

NotationConceptual ASTPaper Output
+_⊙_=>…‽ᵟ¤ᵟ+Correction { deleted: [PreviousSeen { ⊙ }], added:…, cert: γ, meta: ¤ }𝘏ᵟ``⸄⸤⊙⸥ ↦ …◇ᵟ⸅
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • PREVIOUS_SEEN_ALLOWED = any phenomena allowed within PreviousSeen (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

Examples

NotationPaper Output
+_abc_=>xyz+
abcxyz
+_abc_=>xyz?;h=c>d+
cdabcxyz
+_abc_=>xyz!;manus=c;place=supra+
caboveabcxyz

EpiDoc Outputs

NotationEpiDoc (XML)
+_abc_=>xyz+
<ab>
    <subst>
        <del cert="medium">
            <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
        </del>
        <add cert="medium">xyz</add>
    </subst>
</ab>
+_abc_=>xyz?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>
            <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
        </del>
        <add cert="low">xyz<app type="alternative"><lem><handShift new="#c"/>xyz</lem><rdg><handShift new="#d"/>xyz</rdg></app></add>
    </subst>
</ab>
+_abc_=>xyz!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>
            <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
        </del>
        <add place="above" cert="medium">xyz<app type="alternative"><rdg><handShift new="#c"/>xyz</rdg></app></add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+_abc_=>xyz+
Correction[medium]
  deleted:
    PreviousSeen[medium]
      Plain("abc")
  added:
    Plain("xyz")
+_abc_=>xyz?;h=c>d+
Correction[low][meta]
  deleted:
    PreviousSeen[medium]
      Plain("abc")
  added:
    Plain("xyz")
+_abc_=>xyz!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    PreviousSeen[medium]
      Plain("abc")
  added:
    Plain("xyz")

Erasure of Deleted Text in Correction

Signs deleted in an ancient correction that were subsequently deliberately erased in antiquity.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Erasure, thus enclosed within double square brackets [[…]], followed by an equal sign and a greater-than sign forming a => arrow, then by the added text notation, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+[[⊙=>…]]‽ᵟ¤ᵟ+Correction { deleted: [Erasure { ⊙ }], added:…, cert: γ, meta: ¤ }𝘏ᵟ``⸄⟦⊙⟧ ↦ …◇ᵟ⸅
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • ERASURE_ALLOWED = any phenomena allowed within Erasure (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+[[abc]]=>xyz+
abcxyz
+[[abc]]=>xyz?;h=c>d+
cdabcxyz
+[[abc]]=>xyz!;manus=c;place=supra+
caboveabcxyz

EpiDoc Outputs

NotationEpiDoc (XML)
+[[abc]]=>xyz+
<ab>
    <subst>
        <del cert="medium">
            <del cert="medium">
            </supplied>
        </del>
    </del>
    <add cert="medium">xyz</add>
</subst>
</ab>
+[[abc]]=>xyz?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>
            <del cert="medium">
            </supplied>
        </del>
    </del>
    <add cert="low">xyz<app type="alternative"><lem><handShift new="#c"/>xyz</lem><rdg><handShift new="#d"/>xyz</rdg></app></add>
</subst>
</ab>
+[[abc]]=>xyz!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>
            <del cert="medium">
            </supplied>
        </del>
    </del>
    <add place="above" cert="medium">xyz<app type="alternative"><rdg><handShift new="#c"/>xyz</rdg></app></add>
</subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+[[abc]]=>xyz+
Correction[medium]
  deleted:
    Erasure[medium]
      Plain("abc")
  added:
    Plain("xyz")
+[[abc]]=>xyz?;h=c>d+
Correction[low][meta]
  deleted:
    Erasure[medium]
      Plain("abc")
  added:
    Plain("xyz")
+[[abc]]=>xyz!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Erasure[medium]
      Plain("abc")
  added:
    Plain("xyz")

Ligated Signs Deleted in Correction

Ligated signs deleted in an ancient correction.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Ligature, thus wrapped by equal signs =…= representing the addition, followed by an equal sign and a greater-than sign forming a => arrow, then by the added text notation, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+=⊙==>…‽ᵟ¤ᵟ+Correction { deleted: [Ligature { ⊙ }], added:…, cert: γ, meta: ¤ }`𝘏ᵟ```⸄⧵⊙⧷ ↦ …◇ᵟ⸅``
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • LIGATURE_ALLOWED = any phenomena allowed within a Ligature (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+=abc==>xyz+
abcxyz
+=abc==>xyz?;h=c>d+
cdabcxyz
+=abc==>xyz!;manus=c;place=supra+
caboveabcxyz

EpiDoc Outputs

NotationEpiDoc (XML)
+=abc==>xyz+
<ab>
    <subst>
        <del cert="medium">
            <hi rend="ligature" cert="medium">abc</hi>
        </del>
        <add cert="medium">xyz</add>
    </subst>
</ab>
+=abc==>xyz?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>
            <hi rend="ligature" cert="medium">abc</hi>
        </del>
        <add cert="low">xyz<app type="alternative"><lem><handShift new="#c"/>xyz</lem><rdg><handShift new="#d"/>xyz</rdg></app></add>
    </subst>
</ab>
+=abc==>xyz!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>
            <hi rend="ligature" cert="medium">abc</hi>
        </del>
        <add place="above" cert="medium">xyz<app type="alternative"><rdg><handShift new="#c"/>xyz</rdg></app></add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+=abc==>xyz+
Correction[medium]
  deleted:
    Ligature[medium]
      Plain("abc")
  added:
    Plain("xyz")
+=abc==>xyz?;h=c>d+
Correction[low][meta]
  deleted:
    Ligature[medium]
      Plain("abc")
  added:
    Plain("xyz")
+=abc==>xyz!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Ligature[medium]
      Plain("abc")
  added:
    Plain("xyz")

Added Text in Correction

Phenomena related to the added text of the correction.

Internally Allowed Constructs

ConstructSpecific ReferenceGeneral Reference
Plain📖🔎 Plain
Whitespace🔎 Whitespace
Newline🔎 Newline
WordBreak🔎 WordBreak
Gap-Known📖🔎 Gap-Known
Gap-Range📖🔎 Gap-Range
Gap-Unknown📖🔎 Gap-Unknown
Unclear📖🔎 Unclear
Supplied📖🔎 Supplied
PreviousSeen📖🔎 PreviousSeen
Surplus🔎 Surplus
Erasure📖🔎 Erasure
Ligature📖🔎 Ligature
ApparatusMark🔎 ApparatusMark
PlausibilityAssessment🔎 PlausibilityAssessment
Strong🔎 Strong
Emphasis🔎 Emphasis
Comment🔎 Comment

As-Written Signs Added in Correction

As-written signs added in an ancient correction.

Syntax

The notation representing the deleted text followed by an equal sign and a greater-than sign forming a => arrow, then by any sequence of Unicode characters representing Plain content, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+…=>𝑆×𝑁‽ᵟ¤ᵟ+Correction { deleted:…, added: [Plain("𝑆×𝑁")], cert: γ, meta: ¤ }𝘏ᵟ``⸄… ↦ 𝑆×𝑁◇ᵟ⸅
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • 𝑛 ∈ ℕ (natural numbers).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+xyz=>abc+
xyzabc
+xyz=>abc?;h=c>d+
cdxyzabc
+xyz=>abc!;manus=c;place=supra+
cabovexyzabc

EpiDoc Outputs

NotationEpiDoc (XML)
+xyz=>abc+
<ab>
    <subst>
        <del cert="medium">xyz</del>
        <add cert="medium">abc</add>
    </subst>
</ab>
+xyz=>abc?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>xyz</del>
        <add cert="low">abc<app type="alternative"><lem><handShift new="#c"/>abc</lem><rdg><handShift new="#d"/>abc</rdg></app></add>
    </subst>
</ab>
+xyz=>abc!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>xyz</del>
        <add place="above" cert="medium">abc<app type="alternative"><rdg><handShift new="#c"/>abc</rdg></app></add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+xyz=>abc+
Correction[medium]
  deleted:
    Plain("xyz")
  added:
    Plain("abc")
+xyz=>abc?;h=c>d+
Correction[low][meta]
  deleted:
    Plain("xyz")
  added:
    Plain("abc")
+xyz=>abc!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Plain("xyz")
  added:
    Plain("abc")

Added Text (in Correction) with Gap of Known Extent

A gap of known extent (a specific number of missing or lost characters) contained in the added text of an ancient correction.

Syntax

The notation representing the deleted text followed by an equal sign and a greater-than sign forming a => arrow, then by the notation for a gap of known extent, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+…=>[⊙]‽ᵟ¤ᵟ+Correction { deleted:…, added: [Gap { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸄… ↦ [⊙]◇ᵟ⸅
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+xyz=>[.7.]?;h=c>d+
cdxyz7
+xyz=>[.4.]+
xyz4
+xyz=>[.2.]!;manus=c;place=supra+
cabovexyz2

EpiDoc Outputs

NotationEpiDoc (XML)
+xyz=>[.7.]?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>xyz</del>
        <add cert="low">
            <gap reason="lost" quantity="7" unit="character" precision="medium"/><app type="alternative"><lem><handShift new="#c"/><gap reason="lost" quantity="7" unit="character" precision="medium"/></lem><rdg><handShift new="#d"/><gap reason="lost" quantity="7" unit="character" precision="medium"/></rdg></app>
        </add>
    </subst>
</ab>
+xyz=>[.4.]+
<ab>
    <subst>
        <del cert="medium">xyz</del>
        <add cert="medium">
            <gap reason="lost" quantity="4" unit="character" precision="medium"/>
        </add>
    </subst>
</ab>
+xyz=>[.2.]!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>xyz</del>
        <add place="above" cert="medium">
            <gap reason="lost" quantity="2" unit="character" precision="medium"/><app type="alternative"><rdg><handShift new="#c"/><gap reason="lost" quantity="2" unit="character" precision="medium"/></rdg></app>
        </add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+xyz=>[.7.]?;h=c>d+
Correction[low][meta]
  deleted:
    Plain("xyz")
  added:
    Gap(known=7, medium)
+xyz=>[.4.]+
Correction[medium]
  deleted:
    Plain("xyz")
  added:
    Gap(known=4, medium)
+xyz=>[.2.]!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Plain("xyz")
  added:
    Gap(known=2, medium)

Added Text (in Correction) with Gap of Ranged Extent

A gap added by a later ancient hand whose extent is expressed as a plausible numeric range contained in the added text of an ancient correction.

Syntax

The notation representing the deleted text followed by an equal sign and a greater-than sign forming a => arrow, then by the notation for a gap of ranged extent, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+…=>[⊙]‽ᵟ¤ᵟ+Correction { deleted:…, added: [Gap { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸄… ↦ [⊙]◇ᵟ⸅
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+xyz=>[1-3]+
xyz1–3
+xyz=>[2-4]?;h=c>d+
cdxyz2–4

EpiDoc Outputs

NotationEpiDoc (XML)
+xyz=>[1-3]+
<ab>
    <subst>
        <del cert="medium">xyz</del>
        <add cert="medium">
            <gap reason="lost" atLeast="1" atMost="3" unit="character" precision="medium"/>
        </add>
    </subst>
</ab>
+xyz=>[2-4]?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>xyz</del>
        <add cert="low">
            <gap reason="lost" atLeast="2" atMost="4" unit="character" precision="medium"/><app type="alternative"><lem><handShift new="#c"/><gap reason="lost" atLeast="2" atMost="4" unit="character" precision="medium"/></lem><rdg><handShift new="#d"/><gap reason="lost" atLeast="2" atMost="4" unit="character" precision="medium"/></rdg></app>
        </add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+xyz=>[1-3]+
Correction[medium]
  deleted:
    Plain("xyz")
  added:
    Gap(range=1–3, medium)
+xyz=>[2-4]?;h=c>d+
Correction[low][meta]
  deleted:
    Plain("xyz")
  added:
    Gap(range=2–4, medium)

Added Text (in Correction) with Gap of Unknown Extent

A gap of unknown extent (lost or illegible signs where the original number of characters cannot be estimated) contained in the added text of an ancient correction.

Syntax

The notation representing the deleted text followed by an equal sign and a greater-than sign forming a => arrow, then by the notation for a gap of unknwon extent, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+…=>[⊙]‽ᵟ¤ᵟ+Correction { deleted:…, added: [Gap { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸄… ↦ [⊙]◇ᵟ⸅
  • PREVIOUS_SEEN_ALLOWED = the relevant gap notation.
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+xyz=>[]+
xyz·
+xyz=>[]?;h=c>d+
cdxyz·
+xyz=>[];manus=c;place=supra+
cabovexyz·

EpiDoc Outputs

NotationEpiDoc (XML)
+xyz=>[]+
<ab>
    <subst>
        <del cert="medium">xyz</del>
        <add cert="medium">
            <gap reason="lost" extent="unknown" unit="character" precision="medium"/>
        </add>
    </subst>
</ab>
+xyz=>[]?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>xyz</del>
        <add cert="low">
            <gap reason="lost" extent="unknown" unit="character" precision="medium"/><app type="alternative"><lem><handShift new="#c"/><gap reason="lost" extent="unknown" unit="character" precision="medium"/></lem><rdg><handShift new="#d"/><gap reason="lost" extent="unknown" unit="character" precision="medium"/></rdg></app>
        </add>
    </subst>
</ab>
+xyz=>[];manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>xyz</del>
        <add place="above" cert="medium">
            <gap reason="lost" extent="unknown" unit="character" precision="medium"/><app type="alternative"><rdg><handShift new="#c"/><gap reason="lost" extent="unknown" unit="character" precision="medium"/></rdg></app>
        </add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+xyz=>[]+
Correction[medium]
  deleted:
    Plain("xyz")
  added:
    Gap(unknown, medium)
+xyz=>[]?;h=c>d+
Correction[low][meta]
  deleted:
    Plain("xyz")
  added:
    Gap(unknown, medium)
+xyz=>[];manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Plain("xyz")
  added:
    Gap(unknown, medium)

Unclear Signs Added in Correction

Unclear signs added in an ancient correction.

Syntax

The notation representing the deleted text followed by an equal sign and a greater-than sign forming a => arrow, then by any notation of a phenomenon (IbiUnit) allowed within Unclear, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+…=>*⊙*‽ᵟ¤ᵟ+Correction { deleted:…, added: [Unclear { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸄… ↦ ⦇⊙⦈◇ᵟ⸅
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • UNCLEAR_ALLOWED = any phenomena allowed within Unclear (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+xyz=>*abc*+
xyzabc
+xyz=>*abc*?;h=c>d+
cdxyzabc
+xyz=>*abc*!;manus=c;place=supra+
cabovexyzabc

EpiDoc Outputs

NotationEpiDoc (XML)
+xyz=>*abc*+
<ab>
    <subst>
        <del cert="medium">xyz</del>
        <add cert="medium">
            <unclear cert="medium">abc</unclear>
        </add>
    </subst>
</ab>
+xyz=>*abc*?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>xyz</del>
        <add cert="low">
            <unclear cert="medium">abc</unclear><app type="alternative"><lem><handShift new="#c"/><unclear cert="medium">abc</unclear></lem><rdg><handShift new="#d"/><unclear cert="medium">abc</unclear></rdg></app>
        </add>
    </subst>
</ab>
+xyz=>*abc*!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>xyz</del>
        <add place="above" cert="medium">
            <unclear cert="medium">abc</unclear><app type="alternative"><rdg><handShift new="#c"/><unclear cert="medium">abc</unclear></rdg></app>
        </add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+xyz=>*abc*+
Correction[medium]
  deleted:
    Plain("xyz")
  added:
    Unclear[medium, legibility: normal]
      Plain("abc")
+xyz=>*abc*?;h=c>d+
Correction[low][meta]
  deleted:
    Plain("xyz")
  added:
    Unclear[medium, legibility: normal]
      Plain("abc")
+xyz=>*abc*!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Plain("xyz")
  added:
    Unclear[medium, legibility: normal]
      Plain("abc")

Supplied Signs Added in Correction

Signs restored by the editor as once having been added in an ancient correction.

Syntax

The notation representing the deleted text followed by an equal sign and a greater-than sign forming a => arrow, then by any notation of a phenomenon (IbiUnit) allowed within Supplied, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+…=>[⊙]‽ᵟ¤ᵟ+Correction { deleted:…, added: [Supplied { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸄… ↦ [⊙]◇ᵟ⸅
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • SUPPLIED_ALLOWED = any phenomena allowed within Supplied (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+xyz=>[abc]+
xyzabc
+xyz=>[abc]?;h=c>d+
cdxyzabc
+xyz=>[abc]!;manus=c;place=supra+
cabovexyzabc

EpiDoc Outputs

NotationEpiDoc (XML)
+xyz=>[abc]+
<ab>
    <subst>
        <del cert="medium">xyz</del>
        <add cert="medium">
            <supplied reason="lost" cert="medium">abc</supplied>
        </add>
    </subst>
</ab>
+xyz=>[abc]?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>xyz</del>
        <add cert="low">
            <supplied reason="lost" cert="medium">abc</supplied><app type="alternative"><lem><handShift new="#c"/><supplied reason="lost" cert="medium">abc</supplied></lem><rdg><handShift new="#d"/><supplied reason="lost" cert="medium">abc</supplied></rdg></app>
        </add>
    </subst>
</ab>
+xyz=>[abc]!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>xyz</del>
        <add place="above" cert="medium">
            <supplied reason="lost" cert="medium">abc</supplied><app type="alternative"><rdg><handShift new="#c"/><supplied reason="lost" cert="medium">abc</supplied></rdg></app>
        </add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+xyz=>[abc]+
Correction[medium]
  deleted:
    Plain("xyz")
  added:
    Supplied[medium]
      Plain("abc")
+xyz=>[abc]?;h=c>d+
Correction[low][meta]
  deleted:
    Plain("xyz")
  added:
    Supplied[medium]
      Plain("abc")
+xyz=>[abc]!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Plain("xyz")
  added:
    Supplied[medium]
      Plain("abc")

Signs Added in Correction Seen by Earlier Editors

Signs added in an ancient correction that were seen and recorded by earlier editors, but are no longer visible on the support.

Syntax

The notation representing the deleted text followed by an equal sign and a greater-than sign forming a => arrow, then by any notation of a phenomenon (IbiUnit) allowed within PreviousSeen, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+…=>_⊙_‽ᵟ¤ᵟ+Correction { deleted:…, added: [PreviousSeen { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸄… ↦ ⸤⊙⸥◇ᵟ⸅
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • PREVIOUS_SEEN_ALLOWED = any phenomena allowed within PreviousSeen (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+xyz=>_abc_+
xyzabc
+xyz=>_abc_?;h=c>d+
cdxyzabc
+xyz=>_abc_!;manus=c;place=supra+
cabovexyzabc

EpiDoc Outputs

NotationEpiDoc (XML)
+xyz=>_abc_+
<ab>
    <subst>
        <del cert="medium">xyz</del>
        <add cert="medium">
            <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
        </add>
    </subst>
</ab>
+xyz=>_abc_?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>xyz</del>
        <add cert="low">
            <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied><app type="alternative"><lem><handShift new="#c"/><supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied></lem><rdg><handShift new="#d"/><supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied></rdg></app>
        </add>
    </subst>
</ab>
+xyz=>_abc_!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>xyz</del>
        <add place="above" cert="medium">
            <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied><app type="alternative"><rdg><handShift new="#c"/><supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied></rdg></app>
        </add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+xyz=>_abc_+
Correction[medium]
  deleted:
    Plain("xyz")
  added:
    PreviousSeen[medium]
      Plain("abc")
+xyz=>_abc_?;h=c>d+
Correction[low][meta]
  deleted:
    Plain("xyz")
  added:
    PreviousSeen[medium]
      Plain("abc")
+xyz=>_abc_!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Plain("xyz")
  added:
    PreviousSeen[medium]
      Plain("abc")

Erasure of Added Text in Correction

Signs added in an ancient correction that were subsequently deliberately erased in antiquity.

Syntax

The notation representing the deleted text followed by an equal sign and a greater-than sign forming a => arrow, then by any notation of a phenomenon (IbiUnit) allowed within Erasure, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+…=>[[⊙]]‽ᵟ¤ᵟ+Correction { deleted:…, added: [Erasure { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸄… ↦ ⟦⊙⟧◇ᵟ⸅
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • ERASURE_ALLOWED = any phenomena allowed within Erasure (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+xyz=>[[abc]]+
xyzabc
+xyz=>[[abc]]?;h=c>d+
cdxyzabc
+xyz=>[[abc]]!;manus=c;place=supra+
cabovexyzabc

EpiDoc Outputs

NotationEpiDoc (XML)
+xyz=>[[abc]]+
<ab>
    <subst>
        <del cert="medium">xyz</del>
        <add cert="medium">
            <del cert="medium">
            </supplied>
        </del>
    </add>
</subst>
</ab>
+xyz=>[[abc]]?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>xyz</del>
        <add cert="low">
            <del cert="medium">
            </supplied>
        </del><app type="alternative"><lem><handShift new="#c"/><del cert="medium"></supplied></del></lem><rdg><handShift new="#d"/><del cert="medium"></supplied></del></rdg></app>
    </add>
</subst>
</ab>
+xyz=>[[abc]]!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>xyz</del>
        <add place="above" cert="medium">
            <del cert="medium">
            </supplied>
        </del><app type="alternative"><rdg><handShift new="#c"/><del cert="medium"></supplied></del></rdg></app>
    </add>
</subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+xyz=>[[abc]]+
Correction[medium]
  deleted:
    Plain("xyz")
  added:
    Erasure[medium]
      Plain("abc")
+xyz=>[[abc]]?;h=c>d+
Correction[low][meta]
  deleted:
    Plain("xyz")
  added:
    Erasure[medium]
      Plain("abc")
+xyz=>[[abc]]!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Plain("xyz")
  added:
    Erasure[medium]
      Plain("abc")

Ligated Signs Added in Correction

Ligated signs added in an ancient correction.

Syntax

The notation representing the deleted text followed by an equal sign and a greater-than sign forming a => arrow, then by any notation of a phenomenon (IbiUnit) allowed within Ligature, all enclosed between plus signs +…+. Optional metadata can be written before the final + delimiter.

Overview

NotationConceptual ASTPaper Output
+…=>=⊙=‽ᵟ¤ᵟ+Correction { deleted:…, added: [Ligature { ⊙ }], cert: γ, meta: ¤ }𝘏ᵟ``⸄… ↦ ⧵⊙⧷◇ᵟ⸅
  • 𝘏 = identifier sign of the hand (if specified in the optional annotations/metadata ¤ᵟ).
  • LIGATURE_ALLOWED = any phenomena allowed within a Ligature (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • ¤ᵟ = optional annotations (metadata) supported by Correction (cf. Ancient Corrections).

See Ancient Corrections for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
+xyz=>=abc=+
xyzabc
+xyz=>=abc=?;h=c>d+
cdxyzabc
+xyz=>=abc=!;manus=c;place=supra+
cabovexyzabc

EpiDoc Outputs

NotationEpiDoc (XML)
+xyz=>=abc=+
<ab>
    <subst>
        <del cert="medium">xyz</del>
        <add cert="medium">
            <hi rend="ligature" cert="medium">abc</hi>
        </add>
    </subst>
</ab>
+xyz=>=abc=?;h=c>d+
<ab>
    <subst>
        <del cert="low"><app type="alternative"><lem><handShift new="#c"/></lem><rdg><handShift new="#d"/></rdg></app>xyz</del>
        <add cert="low">
            <hi rend="ligature" cert="medium">abc</hi><app type="alternative"><lem><handShift new="#c"/><hi rend="ligature" cert="medium">abc</hi></lem><rdg><handShift new="#d"/><hi rend="ligature" cert="medium">abc</hi></rdg></app>
        </add>
    </subst>
</ab>
+xyz=>=abc=!;manus=c;place=supra+
<ab>
    <subst>
        <del cert="medium"><app type="alternative"><rdg><handShift new="#c"/></rdg></app>xyz</del>
        <add place="above" cert="medium">
            <hi rend="ligature" cert="medium">abc</hi><app type="alternative"><rdg><handShift new="#c"/><hi rend="ligature" cert="medium">abc</hi></rdg></app>
        </add>
    </subst>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
+xyz=>=abc=+
Correction[medium]
  deleted:
    Plain("xyz")
  added:
    Ligature[medium]
      Plain("abc")
+xyz=>=abc=?;h=c>d+
Correction[low][meta]
  deleted:
    Plain("xyz")
  added:
    Ligature[medium]
      Plain("abc")
+xyz=>=abc=!;manus=c;place=supra+
Correction[medium][meta]
  deleted:
    Plain("xyz")
  added:
    Ligature[medium]
      Plain("abc")

Ligated Signs

Two or more letters whose strokes have been merged or joined by the inscriber into a single graphic sign, usually sharing a common stem.

Delimiters

SideSignNameUnicode
Left=Equals SignU+003D
Right=Equals SignU+003D

=abc= ↓ Formatter optimisation for human legibility ↓ =abc≠

SideSignNameUnicode
Left=Equals SignU+003D
RightNot Equal ToU+2260

Internally Allowed Constructs

ConstructSpecific ReferenceGeneral Reference
Plain📖🔎 Plain
Whitespace🔎 Whitespace
Newline🔎 Newline
WordBreak🔎 WordBreak
Unclear📖🔎 Unclear
Supplied📖🔎 Supplied
PreviousSeen📖🔎 PreviousSeen
ApparatusMark🔎 ApparatusMark
PlausibilityAssessment🔎 PlausibilityAssessment
Strong🔎 Strong
Emphasis🔎 Emphasis
Comment🔎 Comment

Ligature of As-Written Signs

A ligature made of as-written signs.

Syntax

Any number of Unicode characters (followed by the optional certainty notation) enclosed between equal signs =…=.

Overview

NotationConceptual ASTPaper Output
=𝑆×𝑁=Ligature { content: [Plain("𝑆×𝑁")], cert: γ }⧵𝑆×𝑁⧷
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

See Ligated Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
=abc=
abc
=abc?=
abc
=abc!=
abc

EpiDoc Outputs

NotationEpiDoc (XML)
=abc=
<ab>
    <hi rend="ligature" cert="medium">abc</hi>
</ab>
=abc?=
<ab>
    <hi rend="ligature" cert="low">abc</hi>
</ab>
=abc!=
<ab>
    <hi rend="ligature" cert="high">abc</hi>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
=abc=
Ligature[medium]
  Plain("abc")
=abc?=
Ligature[low]
  Plain("abc")
=abc!=
Ligature[high]
  Plain("abc")

Ligature of Unclear Signs

A ligature of signs whose remaining traces on the support are readable enough to be restored. Alternative readings may be possible.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Unclear wrapped by asterisks *…* and enclosed between equal signs =…=.

Overview

NotationConceptual ASTPaper Output
=*⊙*=Ligature { content: [Unclear { ⊙ }], cert: γ }⦇⧵⊙⧷⦈
  • UNCLEAR_ALLOWED = any phenomena allowed within Unclear (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

See Ligated Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
=*abc*=
abc
=*abc*?=
abc
=*abc*!=
abc

EpiDoc Outputs

NotationEpiDoc (XML)
=*abc*=
<ab>
    <hi rend="ligature" cert="medium">
        <unclear cert="medium">abc</unclear>
    </hi>
</ab>
=*abc*?=
<ab>
    <hi rend="ligature" cert="low">
        <unclear cert="medium">abc</unclear>
    </hi>
</ab>
=*abc*!=
<ab>
    <hi rend="ligature" cert="high">
        <unclear cert="medium">abc</unclear>
    </hi>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
=*abc*=
Ligature[medium]
  Unclear[medium, legibility: normal]
    Plain("abc")
=*abc*?=
Ligature[low]
  Unclear[medium, legibility: normal]
    Plain("abc")
=*abc*!=
Ligature[high]
  Unclear[medium, legibility: normal]
    Plain("abc")

Ligature of Supplied Signs

A ligature of signs restored by the editor as once having been inscribed but now lost. Of very rare use.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Supplied wrapped by square brackets […] and enclosed between equal signs =…=.

Overview

NotationConceptual ASTPaper Output
=[⊙]=Ligature { content: [Supplied { ⊙ }], cert: γ }[⧵⊙⧷]
  • SUPPLIED_ALLOWED = any phenomena allowed within Supplied (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

See Ligated Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
=[abc]=
abc
=[abc]?=
abc
=[abc]!=
abc

EpiDoc Outputs

NotationEpiDoc (XML)
=[abc]=
<ab>
    <hi rend="ligature" cert="medium">
        <supplied reason="lost" cert="medium">abc</supplied>
    </hi>
</ab>
=[abc]?=
<ab>
    <hi rend="ligature" cert="low">
        <supplied reason="lost" cert="medium">abc</supplied>
    </hi>
</ab>
=[abc]!=
<ab>
    <hi rend="ligature" cert="high">
        <supplied reason="lost" cert="medium">abc</supplied>
    </hi>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
=[abc]=
Ligature[medium]
  Supplied[medium]
    Plain("abc")
=[abc]?=
Ligature[low]
  Supplied[medium]
    Plain("abc")
=[abc]!=
Ligature[high]
  Supplied[medium]
    Plain("abc")

Ligature of Signs Seen by Earlier Editors

A ligature whose signs were seen by earlier editors but no longer visible on the support.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within PreviousSeen wrapped by between low lines _…_ and enclosed between equal signs =…=.

Overview

NotationConceptual ASTPaper Output
=_⊙_=Ligature { content: [PreviousSeen { ⊙ }], cert: γ }⸤⧵⊙⧷⸥
  • PREVIOUS_SEEN_ALLOWED = any phenomena allowed within PreviousSeen (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

See Ligated Signs for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
=_abc_=
abc
=_abc_?=
abc
=_abc_!=
abc

EpiDoc Outputs

NotationEpiDoc (XML)
=_abc_=
<ab>
    <hi rend="ligature" cert="medium">
        <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
    </hi>
</ab>
=_abc_?=
<ab>
    <hi rend="ligature" cert="low">
        <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
    </hi>
</ab>
=_abc_!=
<ab>
    <hi rend="ligature" cert="high">
        <supplied reason="lost" evidence="previouseditor" cert="medium">abc</supplied>
    </hi>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
=_abc_=
Ligature[medium]
  PreviousSeen[medium]
    Plain("abc")
=_abc_?=
Ligature[low]
  PreviousSeen[medium]
    Plain("abc")
=_abc_!=
Ligature[high]
  PreviousSeen[medium]
    Plain("abc")

Abbreviations and Their Expansions

Phenomena relating to words or formulas abbreviated by the inscriber, including abbreviation marks, omitted letters, and the critical expansion (or resolution) provided by the editor.

Symbolic signs (logograms, heterograms, sigla) that in earlier editorial traditions were sometimes treated as abbreviations are discussed separately in @logograms-and-heterograms, as they represent a semiotic phenomenon categorically distinct from phonographic abbreviation.

Abbreviated Text

Phenomena relating to the portion of an abbreviation physically present on the support, including abbreviation marks and the surviving letters of the abbreviated word.

Internally Allowed Constructs

ConstructSpecific ReferenceGeneral Reference
Plain📖🔎 Plain
Whitespace🔎 Whitespace
Newline🔎 Newline
WordBreak🔎 WordBreak
Unclear📖🔎 Unclear
Supplied📖🔎 Supplied
PreviousSeen📖🔎 PreviousSeen
Surplus📖🔎 Surplus
Erasure📖🔎 Erasure
ApparatusMark🔎 ApparatusMark
PlausibilityAssessment🔎 PlausibilityAssessment
Strong🔎 Strong
Emphasis🔎 Emphasis

Legible Abbreviated Text

Abbreviated text that is clearly legible and does not require any editorial intervention.

Syntax

Any number of Unicode characters preceding a left round bracket (, marker of the abbreviation’s expansion.

Overview

NotationConceptual ASTPaper Output
𝑆×𝑁(…)Written([Plain("𝑆×𝑁")])𝑆×𝑁
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).

Examples

NotationPaper Output
Aug(ustus)
Augustus

EpiDoc Outputs

NotationEpiDoc (XML)
Aug(ustus)
<ab>
    <expan>
        <abbr>Aug</abbr>
        <ex>ustus</ex>
    </expan>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
Aug(ustus)
Abbreviation[complete]
  Written
    Plain("Aug")
  Expanded(certain)
    Plain("ustus")

Unclear Abbreviated Text

Abbreviated text whose remaining traces on the support are readable enough to be restored. Alternative readings may be possible.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Unclear, thus enclosed between asterisks *…* preceding a left round bracket (, marker of the abbreviation’s expansion.

Overview

NotationConceptual ASTPaper Output
*⊙‽ᵟ*(…)Written([Unclear { ⊙, γ }])⦇⊙◇ᵟ⦈
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • UNCLEAR_ALLOWED = any phenomena allowed within Unclear (notation, AST or rendering depending on its placement).

Examples

NotationPaper Output
*Aug*(ustus)
Augustus
*Aug?*(ustus)
Augustus
*Aug!*(ustus)
Augustus

EpiDoc Outputs

NotationEpiDoc (XML)
*Aug*(ustus)
<ab>
    <expan>
        <abbr>
            <unclear cert="medium">Aug</unclear>
        </abbr>
        <ex>ustus</ex>
    </expan>
</ab>
*Aug?*(ustus)
<ab>
    <expan>
        <abbr>
            <unclear cert="low">Aug</unclear>
        </abbr>
        <ex>ustus</ex>
    </expan>
</ab>
*Aug!*(ustus)
<ab>
    <expan>
        <abbr>
            <unclear cert="high">Aug</unclear>
        </abbr>
        <ex>ustus</ex>
    </expan>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
*Aug*(ustus)
Abbreviation[complete]
  Written
    Unclear[medium, legibility: normal]
      Plain("Aug")
  Expanded(certain)
    Plain("ustus")
*Aug?*(ustus)
Abbreviation[complete]
  Written
    Unclear[low, legibility: normal]
      Plain("Aug")
  Expanded(certain)
    Plain("ustus")
*Aug!*(ustus)
Abbreviation[complete]
  Written
    Unclear[high, legibility: normal]
      Plain("Aug")
  Expanded(certain)
    Plain("ustus")

Supplied Abbreviated Text

Abbreviated text restored by the editor as once having been inscribed but now lost.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Supplied, thus enclosed between square brackets […] preceding a left round bracket (, marker of the abbreviation’s expansion.

Overview

NotationConceptual ASTPaper Output
[⊙‽ᵟ](…)Written([Supplied { ⊙, γ }])[⊙◇ᵟ]
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • SUPPLIED_ALLOWED = any phenomena allowed within Supplied (notation, AST or rendering depending on its placement).

Examples

NotationPaper Output
[Aug](ustus)
Augustus
[Aug?](ustus)
Augustus
[Aug!](ustus)
Augustus

EpiDoc Outputs

NotationEpiDoc (XML)
[Aug](ustus)
<ab>
    <supplied reason="lost" cert="medium">Aug</supplied>
    <expan>
        <ex>ustus</ex>
    </expan>
</ab>
[Aug?](ustus)
<ab>
    <supplied reason="lost" cert="low">Aug</supplied>
    <expan>
        <ex>ustus</ex>
    </expan>
</ab>
[Aug!](ustus)
<ab>
    <supplied reason="lost" cert="high">Aug</supplied>
    <expan>
        <ex>ustus</ex>
    </expan>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[Aug](ustus)
Supplied[medium]
  Plain("Aug")
Abbreviation[complete]
  Expanded(certain)
    Plain("ustus")
[Aug?](ustus)
Supplied[low]
  Plain("Aug")
Abbreviation[complete]
  Expanded(certain)
    Plain("ustus")
[Aug!](ustus)
Supplied[high]
  Plain("Aug")
Abbreviation[complete]
  Expanded(certain)
    Plain("ustus")

Abbreviated Text Seen by Earlier Editors

Abbreviated text seen by earlier editors but no longer visible on the support.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within PreviousSeen, thus enclosed between low lines _…_ preceding a left round bracket (, marker of the abbreviation’s expansion.

Overview

[_⊙‽ᵟ_(…)], [rust Written([PreviousSeen { ⊙, γ }])], ⸤⊙⸥◇ᵟ, )

  • PREVIOUS_SEEN_ALLOWED = any phenomena allowed within PreviousSeen (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
_Aug_(ustus)
Augustus
_Aug?_(ustus)
Augustus
_Aug!_(ustus)
Augustus

EpiDoc Outputs

NotationEpiDoc (XML)
_Aug_(ustus)
<ab>
    <expan>
        <abbr>
            <supplied reason="lost" evidence="previouseditor" cert="medium">Aug</supplied>
        </abbr>
        <ex>ustus</ex>
    </expan>
</ab>
_Aug?_(ustus)
<ab>
    <expan>
        <abbr>
            <supplied reason="lost" evidence="previouseditor" cert="low">Aug</supplied>
        </abbr>
        <ex>ustus</ex>
    </expan>
</ab>
_Aug!_(ustus)
<ab>
    <expan>
        <abbr>
            <supplied reason="lost" evidence="previouseditor" cert="high">Aug</supplied>
        </abbr>
        <ex>ustus</ex>
    </expan>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
_Aug_(ustus)
Abbreviation[complete]
  Written
    PreviousSeen[medium]
      Plain("Aug")
  Expanded(certain)
    Plain("ustus")
_Aug?_(ustus)
Abbreviation[complete]
  Written
    PreviousSeen[low]
      Plain("Aug")
  Expanded(certain)
    Plain("ustus")
_Aug!_(ustus)
Abbreviation[complete]
  Written
    PreviousSeen[high]
      Plain("Aug")
  Expanded(certain)
    Plain("ustus")

Superfluous Abbreviated Text

Superfluous abbreviated text added in error by the inscriber of the text and excised by the editor.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Surplus, thus enclosed between curly brackets {…} preceding a left round bracket (, marker of the abbreviation’s expansion.

Overview

NotationConceptual ASTPaper Output
{⊙‽ᵟ}(…)Written([Surplus { ⊙, γ }]){⊙◇ᵟ}
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).
  • SURPLUS_ALLOWED = any phenomena allowed within Surplus (notation, AST or rendering depending on its placement).

Examples

NotationPaper Output
{Aug}(ustus)
Augustus
{Aug?}(ustus)
Augustus
{Aug!}(ustus)
Augustus

EpiDoc Outputs

NotationEpiDoc (XML)
{Aug}(ustus)
<ab>
    <expan>
        <abbr>
            <surplus cert="medium">Aug</surplus>
        </abbr>
        <ex>ustus</ex>
    </expan>
</ab>
{Aug?}(ustus)
<ab>
    <expan>
        <abbr>
            <surplus cert="low">Aug</surplus>
        </abbr>
        <ex>ustus</ex>
    </expan>
</ab>
{Aug!}(ustus)
<ab>
    <expan>
        <abbr>
            <surplus cert="high">Aug</surplus>
        </abbr>
        <ex>ustus</ex>
    </expan>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
{Aug}(ustus)
Abbreviation[complete]
  Written
    Surplus[medium]
      Plain("Aug")
  Expanded(certain)
    Plain("ustus")
{Aug?}(ustus)
Abbreviation[complete]
  Written
    Surplus[low]
      Plain("Aug")
  Expanded(certain)
    Plain("ustus")
{Aug!}(ustus)
Abbreviation[complete]
  Written
    Surplus[high]
      Plain("Aug")
  Expanded(certain)
    Plain("ustus")

Erased Abbreviated Text

Abbreviated text deliberately erased in antiquity, still legible.

Syntax

Any notation of a phenomenon (IbiUnit) allowed within Erasure, thus enclosed between double square brackets [[…]] preceding a left round bracket (, marker of the abbreviation’s expansion.

Overview

NotationConceptual ASTPaper Output
[[⊙‽ᵟ]](…)Written([Erasure { ⊙, γ }])⟦⊙◇ᵟ⟧
  • ERASURE_ALLOWED = any phenomena allowed within Erasure (notation, AST or rendering depending on its placement).
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • γ ∈ {Low, High, Medium} = certainty level corresponding to the marker used in the notation.
  • ◇ᵟ ∈ {, , ε} = rendering of the uncertainty/certainty marker in the notation or empty string (ε).

Examples

NotationPaper Output
[[Aug]](ustus)
Augustus
[[Aug?]](ustus)
Augustus
[[Aug!]](ustus)
Augustus

EpiDoc Outputs

NotationEpiDoc (XML)
[[Aug]](ustus)
<ab>
    <del cert="medium">
    </supplied>
</del>
<expan>
    <ex>ustus</ex>
</expan>
</ab>
[[Aug?]](ustus)
<ab>
    <del cert="low">
    </supplied>
</del>
<expan>
    <ex>ustus</ex>
</expan>
</ab>
[[Aug!]](ustus)
<ab>
    <del cert="high">
    </supplied>
</del>
<expan>
    <ex>ustus</ex>
</expan>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
[[Aug]](ustus)
Erasure[medium]
  Plain("Aug")
Abbreviation[complete]
  Expanded(certain)
    Plain("ustus")
[[Aug?]](ustus)
Erasure[low]
  Plain("Aug")
Abbreviation[complete]
  Expanded(certain)
    Plain("ustus")
[[Aug!]](ustus)
Erasure[high]
  Plain("Aug")
Abbreviation[complete]
  Expanded(certain)
    Plain("ustus")

Expansion and Its Certainty Degree

The expansion of an abbreviation, analysed here in terms of the degree of philological certainty attributed to it by the editor.

Certain Expansion

Expansion of an abbreviation given by the editor as certain.

Syntax

Any number of Unicode characters wrapped by round brackets (…) and preceded by abbreviated text.

Overview

NotationConceptual ASTPaper Output
…(⊙)Certain([ ⊙ ])(⊙)
  • EXPANS_CONTENT_ALLOWED = any phenomena allowed within Abbrev (notation, AST or rendering depending on its placement).

Examples

NotationPaper Output
Mar(ius)
Marius

EpiDoc Outputs

NotationEpiDoc (XML)
Mar(ius)
<ab>
    <expan>
        <abbr>Mar</abbr>
        <ex>ius</ex>
    </expan>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
Mar(ius)
Abbreviation[complete]
  Written
    Plain("Mar")
  Expanded(certain)
    Plain("ius")

Uncertain Expansion

Expansion of an abbreviation given by the editor as uncertain.

Syntax

Any number of Unicode characters followed by a question mark ? and wrapped by round brackets (…), preceded by abbreviated text.

Overview

NotationConceptual ASTPaper Output
…(⊙?)Uncertain([ ⊙ ])(⊙⯑)
  • EXPANS_CONTENT_ALLOWED = any phenomena allowed within Abbrev (notation, AST or rendering depending on its placement).

Examples

NotationPaper Output
Mar(ius?)
Marius

EpiDoc Outputs

NotationEpiDoc (XML)
Mar(ius?)
<ab>
    <expan>
        <abbr>Mar</abbr>
        <ex>ius</ex>
    </expan>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
Mar(ius?)
Abbreviation[complete]
  Written
    Plain("Mar")
  Expanded(uncertain)
    Plain("ius")

Unexpanded Abbreviation

An explicit indication of the editor’s choice not to resolve an abbreviation, leaving the parentheses empty or containing only spaces to signal the phenomenon’s presence without providing a textual expansion.

Syntax

An Abbreviated Text sequence followed by parentheses (…) containing zero or more white spaces.

Overview

NotationConceptual ASTPaper Output
…(𝑊×𝑁₀₋ₙ)Unexpandable(𝑊×𝑁₀₋ₙ)
  • 𝑊 = any white space.
  • 𝑁₀₋ₙ = zero or more repetitions.

Examples

NotationPaper Output
Mar()
Mar(–––)

EpiDoc Outputs

NotationEpiDoc (XML)
Mar()
<ab><abbr>Mar</abbr>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
Mar()
Abbreviation[complete]
  Written
    Plain("Mar")
  Expanded(unexpandable)

Editorial Expansion Types

Classification of abbreviative phenomena based on the position and nature of the editor’s integrative intervention (truncations, contractions, mutilations) relative to the portions of surviving text on the support.

Abbreviation by Final Truncation

A fully resolved word where the portion present on the support constitutes the beginning (head) of the lexical unit, while the part omitted by truncation is reintegrated by the editor within parentheses (e.g., Aug(ustus)).

Syntax

A sequence of signs (Abbreviated Text) acting as the root, immediately followed by the completion in parentheses (Expansion Components).

Examples

NotationPaper Output
Aug(ustus) trib(unicia) pot(estate)
Augustus tribunicia potestate

EpiDoc Outputs

NotationEpiDoc (XML)
Aug(ustus) trib(unicia) pot(estate)
<ab>
    <expan>
        <abbr>Aug</abbr>
        <ex>ustus</ex>
    </expan> 
    <expan>
        <abbr>trib</abbr>
        <ex>unicia</ex>
    </expan> 
    <expan>
        <abbr>pot</abbr>
        <ex>estate</ex>
    </expan>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
Aug(ustus) trib(unicia) pot(estate)
Abbreviation[complete]
  Written
    Plain("Aug")
  Expanded(certain)
    Plain("ustus")
WS
Abbreviation[complete]
  Written
    Plain("trib")
  Expanded(certain)
    Plain("unicia")
WS
Abbreviation[complete]
  Written
    Plain("pot")
  Expanded(certain)
    Plain("estate")

Overview

NotationConceptual ASTPaper Output
…⊙(⊙)Abbrev(Segmented(…, Written([ ⊙ ]), Expanded([ ⊙ ])), Complete))…⊙(⊙)
  • ABBREV_TEXT_ALLOWED = any phenomena allowed within Abbrev (notation, AST or rendering depending on its placement).
  • EXPANS_CONTENT_ALLOWED = any phenomena allowed within Abbrev (notation, AST or rendering depending on its placement).

Abbreviation by Initial Truncation

A fully resolved word where the portion present on the support constitutes the end (tail) of the lexical unit, while the initial part, omitted by truncation, is reintegrated by the editor within parentheses at the beginning of the word (e.g., (bi)cornis).

Syntax

A sequence in parentheses (Expansion Components) immediately followed by a sequence of signs (Abbreviated Text) acting as the tail of the word.

Examples

NotationPaper Output
(Vale)rius
Valerius

EpiDoc Outputs

NotationEpiDoc (XML)
(Vale)rius
<ab>
    <expan>
        <ex>Vale</ex>
        <abbr>rius</abbr>
    </expan>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
(Vale)rius
Abbreviation[complete]
  Expanded(certain)
    Plain("Vale")
  Written
    Plain("rius")

Overview

NotationConceptual ASTPaper Output
(⊙)⊙…Abbrev(Segmented(Expanded([ ⊙ ]), Written([ ⊙ ]), …, Complete))(⊙)⊙…
  • ABBREV_TEXT_ALLOWED = any phenomena allowed within Abbrev (notation, AST or rendering depending on its placement).
  • EXPANS_CONTENT_ALLOWED = any phenomena allowed within Abbrev (notation, AST or rendering depending on its placement).

Abbreviation by Internal Truncation

A fully resolved word where the portions present on the support constitute the beginning and the end of the lexical unit, while the central part, omitted by contraction, is reintegrated by the editor within parentheses (e.g., D(omi)n(u)s).

Syntax

An alternating sequence of signs (Abbreviated Text) and completions in parentheses (Expansion Components), where the phenomenon begins and ends with text present on the support.

Overview

NotationConceptual ASTPaper Output
⊙(⊙)⊙…Abbrev(Segmented(Written([ ⊙ ]), Expanded([ ⊙ ])), Written([ ⊙ ]), …, Complete))⊙(⊙)⊙…
  • EXPANS_CONTENT_ALLOWED = any phenomena allowed within Abbrev (notation, AST or rendering depending on its placement).

Examples

NotationPaper Output
Lib(erta)s
Libertas
D(omi)n(u)s
Dominus

EpiDoc Outputs

NotationEpiDoc (XML)
Lib(erta)s
<ab>
    <expan>
        <abbr>Lib</abbr>
        <ex>erta</ex>
        <abbr>s</abbr>
    </expan>
</ab>
D(omi)n(u)s
<ab>
    <expan>
        <abbr>D</abbr>
        <ex>omi</ex>
        <abbr>n</abbr>
        <ex>u</ex>
        <abbr>s</abbr>
    </expan>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
Lib(erta)s
Abbreviation[complete]
  Written
    Plain("Lib")
  Expanded(certain)
    Plain("erta")
  Written
    Plain("s")
D(omi)n(u)s
Abbreviation[complete]
  Written
    Plain("D")
  Expanded(certain)
    Plain("omi")
  Written
    Plain("n")
  Expanded(certain)
    Plain("u")
  Written
    Plain("s")

Suspended Abbreviation

A multi-part abbreviation consisting of a series of legible portions on the support (suspensions) each followed by its respective editorial expansion within parentheses.

Syntax

One or more sequences of Abbreviated Text followed by their respective Expansion Components.

In the case of suspended abbreviations, the LexicalUnit notation using ampersands &...& is the only way to explicitly indicate that the sequence of abbreviations constitutes a single lexical unit (e.g., &q(uin)q(uennalis)&).

Overview

NotationConceptual ASTPaper Output
…⊙(⊙)…Abbrev(Segmented(…, Written([ ⊙ ]), Expanded([ ⊙ ])), …, Complete))…⊙(⊙)…
  • ABBREV_TEXT_ALLOWED = any phenomena allowed within Abbrev (notation, AST or rendering depending on its placement).
  • EXPANS_CONTENT_ALLOWED = any phenomena allowed within Abbrev (notation, AST or rendering depending on its placement).

Examples

NotationPaper Output
proco(n)s(ul)
proconsul

EpiDoc Outputs

NotationEpiDoc (XML)
proco(n)s(ul)
<ab>
    <expan>
        <abbr>proco</abbr>
        <ex>n</ex>
        <abbr>s</abbr>
        <ex>ul</ex>
    </expan>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
proco(n)s(ul)
Abbreviation[complete]
  Written
    Plain("proco")
  Expanded(certain)
    Plain("n")
  Written
    Plain("s")
  Expanded(certain)
    Plain("ul")

Truncated Abbreviation

An abbreviation interrupted by a physical lacuna in the support (fracture or erosion). It represents a lexical unit that is not only contracted or suspended but also partially lost, preventing a complete or certain resolution of the term.

Syntax

A sequence of abbreviations (text and parentheses) immediately followed by a fracture or physical truncation indicator (e.g., -).

Overview

NotationConceptual ASTPaper Output
…⊙(⊙)…-Abbrev(Segmented(…, Written([ ⊙ ]), Expanded([ ⊙ ])), …, Truncated))…⊙(⊙)…–
  • ABBREV_TEXT_ALLOWED = any phenomena allowed within Abbrev (notation, AST or rendering depending on its placement).
  • EXPANS_CONTENT_ALLOWED = any phenomena allowed within Abbrev (notation, AST or rendering depending on its placement).

Examples

NotationPaper Output
co(n)s(ul)-
consul

EpiDoc Outputs

NotationEpiDoc (XML)
co(n)s(ul)-
<ab>
    <expan>
        <abbr>co<gap reason="lost" extent="unknown" unit="character"/>
        </abbr>
        <ex>n</ex>
        <abbr>s<gap reason="lost" extent="unknown" unit="character"/>
        </abbr>
        <ex>ul</ex>
    </expan>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
co(n)s(ul)-
Abbreviation[truncated]
  Written
    Plain("co")
  Expanded(certain)
    Plain("n")
  Written
    Plain("s")
  Expanded(certain)
    Plain("ul")

Logograms, Conventional Symbols and Heterograms

Graphic elements that directly represent an entire word or concept, regardless of their phonetic realisation.

The notation is similar to that used for identifying lexical units (see Lexical Unit Boundary), to which linguistic annotations are added to define the nature of the graphic elements (for a detailed discussion of linguistic annotation, see Linguistic Annotation of a Lexical Unit).

The graphic function of signs is indicated via the metadata keys graphic, function, or gf, with the following possible values:

  • lg or logogram: logogram or conventional symbol — a sign integrated into the current writing system, whose foreign origin, if any, is synchronically opaque.
  • ht or heterogram: heterogram — a logogram whose belonging to a distinct foreign writing system remains synchronically transparent and functionally relevant in the text.
  • pl or plain: neither of the above; a normal sequence of signs consistent with the language and writing system of the text.

Delimiters

SideSignNameUnicode
Left&AmpersandU+0026
Right&AmpersandU+0026

&abc& ↓ Formatter optimisation for human legibility ↓ &abc⅋

SideSignNameUnicode
Left&AmpersandU+0026
RightTurned AmpersandU+214B

Logogram or conventional symbol

Signs that phenomenologically constitute a logogram, usually identified in the following subcategories:

  • logograms in the strict sense: signs that directly represent an entire word or concept, fully integrated into the current writing system — whose foreign origin, if any, is synchronically opaque to both scribe and reader (and therefore not classifiable as heterograms).
  • numerals: signs that directly represent quantities.
  • conventional symbols: shorthand or abbreviated signs (e.g. Tironian marks).
  • special glyphs: signs present on the medium with an auxiliary or formatting function (e.g. word separators, archaic punctuation).

The term “ideogram”, common in traditional literature, is here treated as synonymous with logogram. The theoretical distinction between the two terms — the former referring to the representation of concepts, the latter of words — is considered by modern linguistics to be non-operational in practice, since every logographic sign is always anchored to a specific language.

When writing the logogram, it is advisable to follow the standard transcription conventions for the text in question; this means, for example, that when transliterating texts written in complex writing systems — such as most Iranian and Semitic languages — into the scientific Latin alphabet, any Unicode symbol or sequence that visually represents the logogram should be assigned as the value of the metadata key dipl (or diplomatic), which is reserved for containing characters intended to faithfully represent the appearance of the logogram. The examples below clearly demonstrate how to apply this convention.

Overview

NotationConceptual ASTPaper Output
&𝑆×𝑁;fₛ=fₗ;…&`LexicalUnit([𝘜], LinguisticAnalysis[
fₖ:fₗ,…])`𝑆×𝑁
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • fₛ["gf", "graphic", "function"] = label for the graphic function.
  • fₗ["lg", "logogram"] = value of the graphic function indicating a logogram.
  • fₖ = canonical key for the graphic function derived from the corresponding label.

Syntax

Any number of Unicode characters constituting the logogram followed by a semicolon ; (representing any sequence of IbiUnit variants), followed by one of the keys indicating the graphic function (graphic, function or gf), an equal sign = and the value lg (or logogram); all enclosed within ampersands &…&.

Examples

NotationPaper Output
&DINGIR;
gf=lg;
ts=DINGIR;
read=šiu-;
dipl=𒀭&
DINGIR𒀭šiu-lgunknown:ts=DINGIR
&pr;
gf=lg;
ts=pr;
read=pr;
dipl=𓉐&
pr𓉐prlgunknown:ts=pr
&𐆖;
gf=lg;
ts=denarius;
read=denarius;
dipl=𐆖&
𐆖𐆖denariuslgunknown:ts=denarius
&⁊;
gf=lg;
ts=et;
read=et;
dipl=⁊&
etlgunknown:ts=et
&nwk';
gf=lg;
read=nōg;
ts=nwk';
dipl=𐭻𐭻𐭸;
pos=num&
nwk'𐭻𐭻𐭸nōglgnumunknown:ts=nwk'
&D̄;
gf=lg;
ts=Dominus;
read=Dominus;
dipl=D̄&
Dominuslgunknown:ts=Dominus
&☧;
gf=lg;
ts=Χριστός;
read=Χριστός;
dipl=☧&
Χριστόςlgunknown:ts=Χριστός

EpiDoc Outputs

NotationEpiDoc (XML)
&DINGIR;
gf=lg;
ts=DINGIR;
read=šiu-;
dipl=𒀭&
<ab>
    <w xml:id="gen-0" type="lg">DINGIR</w>
    <note target="#gen-0" type="reading">šiu-
    </note>
    <note target="#gen-0" type="unknown:ts">DINGIR
    </note>
</ab>
&pr;
gf=lg;
ts=pr;
read=pr;
dipl=𓉐&
<ab>
    <w xml:id="gen-0" type="lg">pr</w>
    <note target="#gen-0" type="reading">pr
    </note>
    <note target="#gen-0" type="unknown:ts">pr
    </note>
</ab>
&𐆖;
gf=lg;
ts=denarius;
read=denarius;
dipl=𐆖&
<ab>
    <w xml:id="gen-0" type="lg">𐆖</w>
    <note target="#gen-0" type="reading">denarius
    </note>
    <note target="#gen-0" type="unknown:ts">denarius
    </note>
</ab>
&⁊;
gf=lg;
ts=et;
read=et;
dipl=⁊&
<ab>
    <w xml:id="gen-0" type="lg">⁊</w>
    <note target="#gen-0" type="reading">et
    </note>
    <note target="#gen-0" type="unknown:ts">et
    </note>
</ab>
&nwk';
gf=lg;
read=nōg;
ts=nwk';
dipl=𐭻𐭻𐭸;
pos=num&
<ab>
    <w xml:id="gen-0" type="lg" pos="num">nwk&apos;</w>
    <note target="#gen-0" type="reading">nōg
    </note>
    <note target="#gen-0" type="unknown:ts">nwk'
    </note>
</ab>
&D̄;
gf=lg;
ts=Dominus;
read=Dominus;
dipl=D̄&
<ab>
    <w xml:id="gen-0" type="lg">D̄</w>
    <note target="#gen-0" type="reading">Dominus
    </note>
    <note target="#gen-0" type="unknown:ts">Dominus
    </note>
</ab>
&☧;
gf=lg;
ts=Χριστός;
read=Χριστός;
dipl=☧&
<ab>
    <w xml:id="gen-0" type="lg">☧</w>
    <note target="#gen-0" type="reading">Χριστός
    </note>
    <note target="#gen-0" type="unknown:ts">Χριστός
    </note>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
&DINGIR;
gf=lg;
ts=DINGIR;
read=šiu-;
dipl=𒀭&
LexicalUnit[meta]
  Plain("DINGIR")
&pr;
gf=lg;
ts=pr;
read=pr;
dipl=𓉐&
LexicalUnit[meta]
  Plain("pr")
&𐆖;
gf=lg;
ts=denarius;
read=denarius;
dipl=𐆖&
LexicalUnit[meta]
  Plain("𐆖")
&⁊;
gf=lg;
ts=et;
read=et;
dipl=⁊&
LexicalUnit[meta]
  Plain("⁊")
&nwk';
gf=lg;
read=nōg;
ts=nwk';
dipl=𐭻𐭻𐭸;
pos=num&
LexicalUnit[meta]
  Plain("nwk'")
&D̄;
gf=lg;
ts=Dominus;
read=Dominus;
dipl=D̄&
LexicalUnit[meta]
  Plain("D\u{304}")
&☧;
gf=lg;
ts=Χριστός;
read=Χριστός;
dipl=☧&
LexicalUnit[meta]
  Plain("☧")

Heterogram

A heterogram is a logogram whose belonging to a foreign writing system remains synchronically transparent and functionally relevant in the text: the scribe deliberately employs signs from another language as such, not as elements absorbed into the current system. The distinction from a logogram is therefore not diachronic (foreign origin) but synchronic (perceived and codified otherness).

The paradigmatic case is that of Aramaic heterograms in epigraphic Middle Persian, where sequences such as MLKʾ are written in Aramaic but read in Middle Persian (šāh, “king”).

Overview

NotationConceptual ASTPaper Output
&𝑆×𝑁;fₛ=fₕ;…&`LexicalUnit([𝘜], LinguisticAnalysis[
fₖ:fₕ,…])`𝑆×𝑁
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • fₛ["gf", "graphic", "function"] = label for the graphic function.
  • fₕ["ht", "heterogram"] = value of the graphic function indicating a heterogram.
  • fₖ = canonical key for the graphic function derived from the corresponding label.

Syntax

Syntax

Any number of Unicode characters constituting the logogram followed by a semicolon ; (representing any sequence of IbiUnit variants), followed by one of the keys indicating the graphic function (graphic, function or gf), an equal sign = and the value ht (or heterogram); all enclosed within ampersands &…&.

Examples

NotationPaper Output
&MLKʾ;
gf=ht;
tl=MLKʾ;
read=šāh;
dipl=𐭬𐭫𐭪𐭠&
MLKʾ𐭬𐭫𐭪𐭠MLKʾšāhhg
&ŠNT;
gf=ht;
tl=ŠNT;
read=sāl;
dipl=𐭔𐭍𐭕&
ŠNT𐭔𐭍𐭕ŠNTsālhg
&'YŠH;
gf=ht;
tl='YŠH;
read=zan;
dipl=𐼰𐼷𐽁𐼳&
'YŠH𐼰𐼷𐽁𐼳'YŠHzanhg

EpiDoc Outputs

NotationEpiDoc (XML)
&MLKʾ;
gf=ht;
tl=MLKʾ;
read=šāh;
dipl=𐭬𐭫𐭪𐭠&
<ab>
    <w xml:id="gen-0" type="hg" norm="MLKʾ">MLKʾ</w>
    <note target="#gen-0" type="reading">šāh
    </note>
</ab>
&ŠNT;
gf=ht;
tl=ŠNT;
read=sāl;
dipl=𐭔𐭍𐭕&
<ab>
    <w xml:id="gen-0" type="hg" norm="ŠNT">ŠNT</w>
    <note target="#gen-0" type="reading">sāl
    </note>
</ab>
&'YŠH;
gf=ht;
tl='YŠH;
read=zan;
dipl=𐼰𐼷𐽁𐼳&
<ab>
    <w xml:id="gen-0" type="hg" norm="&apos;YŠH">&apos;YŠH</w>
    <note target="#gen-0" type="reading">zan
    </note>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
&MLKʾ;
gf=ht;
tl=MLKʾ;
read=šāh;
dipl=𐭬𐭫𐭪𐭠&
LexicalUnit[meta]
  Plain("MLKʾ")
&ŠNT;
gf=ht;
tl=ŠNT;
read=sāl;
dipl=𐭔𐭍𐭕&
LexicalUnit[meta]
  Plain("ŠNT")
&'YŠH;
gf=ht;
tl='YŠH;
read=zan;
dipl=𐼰𐼷𐽁𐼳&
LexicalUnit[meta]
  Plain("'YŠH")

Critical and Editorial Apparatus

A set of notations for the meta-textual phenomena that constitute the philological analysis of the inscribed text. Includes assessments of epistemicity and interpretative plausibility, discursive critical apparatus notes, linguistic annotations, and bibliography.

The Concept of Lectio

The term lectio (pl. lectiones) refers to the specific outcome of the interpretative choice made by the editor in the fields of epigraphy, philology or linguistics. It represents the critical assertion arising from the analysis of the data: not only the reading of a textual sequence, but also the identification of a scribal hand or the morphological attribution of a form (e.g. the choice between the genitive or dative case).

The preference for the term lectio — whilst acknowledging its traditional meaning in textual philology (linked to variants between manuscripts, cf. lectio difficilior) — responds to a specific methodological requirement of IbiScript.

This term was chosen because:

  • “Phenomenon” is excessively vague, overlapping with the description of the physical evidence on the medium (the material data);
  • “Interpretation” appears too generic, risking confusion between the hermeneutic act and its concrete result.

Lectio, on the other hand, precisely identifies the specific editorial assertion, isolating the smallest unit of critical choice applied to the text.

Interpretative Certainty or Precision Assessment

Notations used to define the degree of epistemicity of the editorial interpretation in relation to the material or semantic characteristics of the artefact.

Informational Saturation and the Default Medium Value

The absence of an explicit indicator of certainty or precision results in the automatic assignment of the neutral value Medium. Every node in the notation that supports these attributes therefore always has a defined value (be it Low, Medium or High).

This architecture responds to a specific critique of EpiDoc/TEI practice. In these standards, the omission of the certainty attribute (@cert) generates a semantic aporia: does the absence of marking imply a "certain" fact or an "undeclared" fact?

IbiScript resolves this ambiguity on the basis of two postulates:

  • Interpretation as an epistemological act: Every notational choice (for example, the distinction between Erasure and Gap) is the outcome of a deliberate hermeneutic process. There is no such thing as a "neutral" transcription: every mark made by the editor serves as a scientific thesis on the reality of the artefact.
  • Informational saturation: Since the act of transcribing implies an assumption of scientific responsibility, the formulated reading inherently possesses a degree of epistemicity. The Medium value formalises the "heuristic contract" between editor and reader, defining the standard of epistemicity of the editorial proposal in the absence of further specifications.

It follows that every node in the system is semantically saturated, ensuring absolute consistency both in data processing and in the rigour of textual criticism.

VariantCategoryReference
PreviousSeenCertainty (Cert)@previousseen
UnclearCertainty (Cert)@unclear
SuppliedCertainty (Cert)@supplied
OmittedCertainty (Cert)@omitted
SurplusCertainty (Cert)@surplus
ErasureCertainty (Cert)@erasure
AdditionCertainty (Cert)@addition
LigatureCertainty (Cert)@addition
GapPrecision (Precision)@gap
VacatPrecision (Precision)@vacat

Low Epistemicity

A logical modifier that downgrades the epistemicity of the editorial interpretation. Its semantics depend on the context:

  • Uncertainty: indicates qualitative doubt regarding the identity of phenomena (e.g., Unclear, Supplied, Erasure) or their associated metadata.
  • Low precision: indicates that the quantitative estimation of a gap (Gap) or empty space (Vacat) is purely indicative.
  • Assertive inferiority: indicates that the assertion made by the editor is of lower magnitude than the norm (#underline[same operator but with a different meaning, thus cf. #ref() for examples and syntax]).

Syntax

A question mark ? placed at the end of a phenomenon’s notation, strictly within any applicable delimiters of the phenomenon.

Overview

NotationConceptual ASTPaper Output
𝘋?𝘋Cert::LOW ⊻ Precision::LOW
  • 𝘋 = any IbiScript notation delimiter.

Examples

NotationPaper Output
*abc?*
abc
[.3.?]
.3.

EpiDoc Outputs

NotationEpiDoc (XML)
*abc?*
<ab>
    <unclear cert="low">abc</unclear>
</ab>
[.3.?]
<ab>
    <supplied reason="lost" cert="low">.3.</supplied>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
*abc?*
Unclear[low, legibility: normal]
  Plain("abc")
[.3.?]
Supplied[low]
  Plain(".3.")

High Epistemicity

A logical modifier that increases or greatly confirms the epistemicity of the editorial interpretation. Its semantics depend on the context:

  • Absolute certainty: indicates qualitative confidence regarding the identity of phenomena (e.g., Unclear, Supplied, Erasure) or their associated metadata, often used for difficult but guaranteed readings.
  • High precision: indicates that the quantitative estimation of a gap (Gap) or empty space (Vacat) is to be considered exact and not an approximation.
  • Assertive superiority: indicates that the assertion made by the editor is of higher magnitude than the norm (#underline[same operator but with a different meaning, thus cf. Decreasing Plausibility among Lectiones for examples and syntax])

Syntax

An exclamation mark ! placed at the end of a phenomenon’s notation, strictly within any applicable delimiters of the phenomenon.

Overview

NotationConceptual ASTPaper Output
𝘋!𝘋Cert::HIGH ⊻ Precision::HIGH
  • 𝘋 = any IbiScript notation delimiter.

Examples

NotationPaper Output
*abc!*
abc
[.3.!]
.3.

EpiDoc Outputs

NotationEpiDoc (XML)
*abc!*
<ab>
    <unclear cert="high">abc</unclear>
</ab>
[.3.!]
<ab>
    <supplied reason="lost" cert="high">.3.</supplied>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
*abc!*
Unclear[high, legibility: normal]
  Plain("abc")
[.3.!]
Supplied[high]
  Plain(".3.")

Interpretative Plausibility Assessment

Notations allowing the editor to structure critical doubt by ordering alternative lectiones#footnote[lectio] according to their degree of plausibility, or by declaring them simply non-comparable.

Delimiters

SideSignNameUnicode
Left%Percent SignU+0025
Right%Percent SignU+0025

%abc% ↓ Formatter optimisation for human legibility ↓ %abc‰

SideSignNameUnicode
Left%Percent SignU+0025
RightPer Mill SignU+2030

Internally Allowed Constructs

ConstructSpecific ReferenceGeneral Reference
Plain🔎 Plain
Direction🔎 Direction
Language🔎 Language
Whitespace🔎 Whitespace
Newline🔎 Newline
LineBreak🔎 LineBreak
SectionBreak🔎 SectionBreak
WordBreak🔎 WordBreak
Vacat🔎 Vacat
Gap-Known🔎 Gap-Known
Gap-Range🔎 Gap-Range
Gap-Unknown🔎 Gap-Unknown
Fracture🔎 Fracture
Unclear🔎 Unclear
Supplied🔎 Supplied
PreviousSeen🔎 PreviousSeen
Omitted🔎 Omitted
Surplus🔎 Surplus
Erasure🔎 Erasure
Correction🔎 Correction
Addition🔎 Addition
Ligature🔎 Ligature
Abbreviation🔎 Abbreviation
ApparatusMark🔎 ApparatusMark
ApparatusNote🔎 ApparatusNote
LexicalUnit🔎 LexicalUnit
PlausibilityAssessment🔎 PlausibilityAssessment
Strong🔎 Strong
Emphasis🔎 Emphasis
Comment🔎 Comment
Cite🔎 Cite
Locus🔎 Locus
Facsimile🔎 Facsimile

Plausibility Operators

The editor has two fundamental plausibility operators.

[>], [Preferred], [], [The previous lectio is preferable to the next one],

[|], [Alternative], [], [The lectiones are non-comparable alternatives: the editor expresses no preference], )

When the editor wishes to specify the extent of the plausibility gap between two consecutive lectiones, a degree modifier may be appended to the > operator: ? (small gap) or ! (marked gap). These are the same modifiers used for absolute epistemicity (cf. Interpretative Certainty or Precision Assessment).

[>?], [], [The previous lectio is slightly preferable to the next one: the plausibility gap is small.],

[>!], [], [The previous lectio is clearly preferable to the next one: the plausibility gap is marked.], )

Each relationship exists exclusively between two adjacent lectiones (a pair). Plausibility chains with mixed assertions are permitted, freely combining > and | (cf. Examples of Mixed Plausibility Sequences).

To Draw an Analogy

To understand the structure of a plausibility chain, an architectural metaphor is helpful. Each relationship between two adjacent lectiones represents one element of a path that always proceeds from left to right, in a descending direction: the leftmost lectio is always the most plausible.

The > operator introduces a descending step, whose steepness is determined by the degree modifier: >? indicates a gentle step, > a step of medium steepness, and >! a steep step. The | operator, by contrast, introduces a landing: the two lectiones stand at the same level, with no preference expressed by the editor.

A plausibility chain is therefore an architecture of steps and landings that, taken as a whole, always tends downward — even when the path alternates between horizontal stretches and descents of varying steepness.

Decreasing Plausibility among Lectiones

Pair of lectiones arranged by the editor in descending order of plausibility (from left to right). The critical discrepancy between the variants varies and may optionally be classified, using a specific notation, as minor or major.

Overview

NotationConceptual ASTPaper Output
%⊙>‽ᵟ…%`PlausibilityAssessment(
PlausibilitySeq{
lectiones: [ ⊙, … ],
links: [
PlausibilityLink(
kind: Preferred,
degree: Some(γ)
), …
]
}
)`⦃ ⊙ 𝘱 … ⦄
  • ‽ᵟ ∈ {?, !, ε} = uncertainty marker ?, certainty marker !, or empty string (ε).
  • 𝘱 ∈ {, , } = rendering of the plausibility operator (preference) based on the presence/absence of the ? or ! modifier.
  • γ ∈ {Low, High, Medium} = assertive strenght corresponding to the marker used in the notation.
  • PLAUSIBILITY_ALLOWED = any phenomena allowed within PlausibilityAssessment (notation, AST or rendering depending on its placement).

Syntax

  • In the body of the text: any notation valid for expressing IbiScript phenomena separated by the > plausibility operator (optionally qualified), all enclosed within percent signs %…%.
  • In the phenomenon annotations/metadata: any Unicode character sequence representing plain text (philological sigla and conventions, linguistic remarks, etc.) separated by the > plausibility operator (optionally qualified), all enclosed within percent signs %…%.

See Interpretative Plausibility Assessment for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
%a>b>c%
abc
%a>?b>?c%
abc
%a>!b>!c%
abc
+textus;h=%a>b%+
abtextus

EpiDoc Outputs

NotationEpiDoc (XML)
%a>b>c%
<ab>
    <app type="alternative">
        <lem>a</lem>
        <rdg>b</rdg>
        <rdg>c</rdg>
        <note>Detailed plausibility chain available in IbiScript source
        </note>
    </app>
</ab>
%a>?b>?c%
<ab>
    <app type="alternative">
        <lem cert="low">a</lem>
        <rdg cert="low">b</rdg>
        <rdg cert="low">c</rdg>
        <note>Detailed plausibility chain available in IbiScript source
        </note>
    </app>
</ab>
%a>!b>!c%
<ab>
    <app type="alternative">
        <lem>a</lem>
        <rdg>b</rdg>
        <rdg>c</rdg>
        <note>Detailed plausibility chain available in IbiScript source
        </note>
    </app>
</ab>
+textus;h=%a>b%+
<ab>
    <add cert="medium">textus<app type="alternative"><lem><handShift new="#a"/>textus</lem><rdg><handShift new="#b"/>textus</rdg></app></add>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
%a>b>c%
PlausibilityAssessment
  lectio:
    Plain("a")
  link: Preferred[medium]
  lectio:
    Plain("b")
  link: Preferred[medium]
  lectio:
    Plain("c")
%a>?b>?c%
PlausibilityAssessment
  lectio:
    Plain("a")
  link: Preferred[low]
  lectio:
    Plain("b")
  link: Preferred[low]
  lectio:
    Plain("c")
%a>!b>!c%
PlausibilityAssessment
  lectio:
    Plain("a")
  link: Preferred[high]
  lectio:
    Plain("b")
  link: Preferred[high]
  lectio:
    Plain("c")
+textus;h=%a>b%+
Addition[medium][meta]
  Plain("textus")
Lines 1–3 of the example tables show the plausibility hierarchy applied to _lectiones_ in the main text (e.g. epigraphic phenomena); line 4 shows the use case in annotations, i.e. among the optional metadata supported by certain phenomena.

Not-Given Plausibility among Lectiones

Pair of lectiones for which the editor is either unable or unwilling to offer a judgment regarding the plausibility emerging from their comparison.

Overview

NotationConceptual ASTPaper Output
`%⊙…%``PlausibilityAssessment(
PlausibilitySeq{
lectiones: [ ⊙, … ],
links: [
PlausibilityLink(
kind: Alterative,
degree: None
), …
]
}
)`⦃ ⊙ ∥ … ⦄
  • PLAUSIBILITY_ALLOWED = any phenomena allowed within PlausibilityAssessment (notation, AST or rendering depending on its placement).

Syntax

  • In the body of the text: any notation valid for expressing IbiScript phenomena separated by the not-given plausibility operator |, all enclosed within percent signs %…%.
  • In the phenomenon annotations/metadata: any Unicode character sequence representing plain text (philological sigla and conventions, linguistic remarks, etc.) separated by the not-given plausibility operator |, all enclosed within percent signs %…%.

See Interpretative Plausibility Assessment for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
%a|b|c%
abc
+textus;h=%a|b%+
abtextus

EpiDoc Outputs

NotationEpiDoc (XML)
%a|b|c%
<ab>
    <app type="alternative">
        <rdg>a</rdg>
        <rdg>b</rdg>
        <rdg>c</rdg>
    </app>
</ab>
+textus;h=%a|b%+
<ab>
    <add cert="medium">textus<app type="alternative"><rdg><handShift new="#a"/>textus</rdg><rdg><handShift new="#b"/>textus</rdg></app></add>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
%a|b|c%
PlausibilityAssessment
  lectio:
    Plain("a")
  link: Alternative
  lectio:
    Plain("b")
  link: Alternative
  lectio:
    Plain("c")
+textus;h=%a|b%+
Addition[medium][meta]
  Plain("textus")
Line 1 of the example tables shows the plausibility hierarchy applied to _lectiones_ in the main text (e.g. epigraphic phenomena); line 2 shows the use case in annotations, i.e. among the optional metadata supported by certain phenomena.

Examples of Mixed Plausibility Sequences

Illustrative demonstration of mixed plausibility sequences: a series of interpretive pairs where the editor expresses a descending or not-given plausibility between the lectiones.

See Interpretative Plausibility Assessment for the automatic rectification performed by the formatter to improve legibility.

Examples

NotationPaper Output
%a>b|c%
abc
%a|b>?c%
abc
%a>!b|c%
abc
+textus;h=%a|b>?c%+
abctextus

EpiDoc Outputs

NotationEpiDoc (XML)
%a>b|c%
<ab>
    <app type="alternative">
        <lem>a</lem>
        <rdg>b</rdg>
        <rdg>c</rdg>
        <note>Detailed plausibility chain available in IbiScript source
        </note>
    </app>
</ab>
%a|b>?c%
<ab>
    <app type="alternative">
        <lem>a</lem>
        <rdg>b</rdg>
        <rdg cert="low">c</rdg>
        <note>Detailed plausibility chain available in IbiScript source
        </note>
    </app>
</ab>
%a>!b|c%
<ab>
    <app type="alternative">
        <lem>a</lem>
        <rdg>b</rdg>
        <rdg>c</rdg>
        <note>Detailed plausibility chain available in IbiScript source
        </note>
    </app>
</ab>
+textus;h=%a|b>?c%+
<ab>
    <add cert="medium">textus<app type="alternative"><lem><handShift new="#a"/>textus</lem><rdg><handShift new="#b"/>textus</rdg><rdg cert="low"><handShift new="#c"/>textus</rdg><note>Detailed plausibility chain available in IbiScript source</note></app></add>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
%a>b|c%
PlausibilityAssessment
  lectio:
    Plain("a")
  link: Preferred[medium]
  lectio:
    Plain("b")
  link: Alternative
  lectio:
    Plain("c")
%a|b>?c%
PlausibilityAssessment
  lectio:
    Plain("a")
  link: Alternative
  lectio:
    Plain("b")
  link: Preferred[low]
  lectio:
    Plain("c")
%a>!b|c%
PlausibilityAssessment
  lectio:
    Plain("a")
  link: Preferred[high]
  lectio:
    Plain("b")
  link: Alternative
  lectio:
    Plain("c")
+textus;h=%a|b>?c%+
Addition[medium][meta]
  Plain("textus")

Apparatus Notation

A system of markers and logical anchors used to link portions of the transcribed text to external critical notes. It allows for the association of variants, alternative readings, or philological comments with specific textual segments or anchor points.

Apparatus Mark

Any text marked for an apparatus note.

Delimiters

SideSignNameUnicode
Left$Dollar SignU+0024
Right$Dollar SignU+0024

Internally Allowed Constructs

ConstructSpecific ReferenceGeneral Reference
Plain🔎 Plain
Direction🔎 Direction
Language🔎 Language
Whitespace🔎 Whitespace
Newline🔎 Newline
LineBreak🔎 LineBreak
SectionBreak🔎 SectionBreak
WordBreak🔎 WordBreak
Vacat🔎 Vacat
Gap-Known🔎 Gap-Known
Gap-Range🔎 Gap-Range
Gap-Unknown🔎 Gap-Unknown
Fracture🔎 Fracture
Unclear🔎 Unclear
Supplied🔎 Supplied
PreviousSeen🔎 PreviousSeen
Omitted🔎 Omitted
Surplus🔎 Surplus
Erasure🔎 Erasure
Correction🔎 Correction
Addition🔎 Addition
Ligature🔎 Ligature
Abbreviation🔎 Abbreviation
ApparatusMark🔎 ApparatusMark
ApparatusNote🔎 ApparatusNote
LexicalUnit🔎 LexicalUnit
PlausibilityAssessment🔎 PlausibilityAssessment
Strong🔎 Strong
Emphasis🔎 Emphasis
Comment🔎 Comment
Cite🔎 Cite
Locus🔎 Locus
Facsimile🔎 Facsimile

Syntax

Any sequence of Unicode characters representing the marker followed by a colon : and any other philological notation, enclosed between dollar signs $…$.

Overview

NotationConceptual ASTPaper Output
$𝘔:𝘜$ApparatusMark(𝘔, [𝘜])φ``𝘔
  • 𝘔 = marker characters of the note.
  • 𝘜 = any other philological phenomenon.
  • φ = philological rendering of any notation.

Examples

NotationPaper Output
$1a:abc$
abc1a

EpiDoc Outputs

NotationEpiDoc (XML)
$1a:abc$
<ab>
    <seg xml:id="app-1a">abc</seg>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
$1a:abc$
ApparatusMark(1a)
  Plain("abc")

Apparatus Note

Any text marked for an apparatus note. The note may also contain real editorial phenomena as well as simple text.

Apparatus notes are of two types:

  • General: the note is intended for the entire text.
  • Marked: if the note is intended for a specific part of the text, sharing the same marker as the relative ApparatusMark.

Delimiters

SideSignNameUnicode
Left^Circumflex AccentU+005E
Right^Circumflex AccentU+005E

Internally Allowed Constructs

ConstructSpecific ReferenceGeneral Reference
Plain🔎 Plain
Direction🔎 Direction
Language🔎 Language
Whitespace🔎 Whitespace
Newline🔎 Newline
LineBreak🔎 LineBreak
SectionBreak🔎 SectionBreak
WordBreak🔎 WordBreak
Vacat🔎 Vacat
Gap-Known🔎 Gap-Known
Gap-Range🔎 Gap-Range
Gap-Unknown🔎 Gap-Unknown
Fracture🔎 Fracture
Unclear🔎 Unclear
Supplied🔎 Supplied
PreviousSeen🔎 PreviousSeen
Omitted🔎 Omitted
Surplus🔎 Surplus
Erasure🔎 Erasure
Correction🔎 Correction
Addition🔎 Addition
Ligature🔎 Ligature
Abbreviation🔎 Abbreviation
ApparatusMark🔎 ApparatusMark
ApparatusNote🔎 ApparatusNote
LexicalUnit🔎 LexicalUnit
PlausibilityAssessment🔎 PlausibilityAssessment
Strong🔎 Strong
Emphasis🔎 Emphasis
Comment🔎 Comment
Cite🔎 Cite
Locus🔎 Locus
Facsimile🔎 Facsimile

Syntax

  • General note: An asterisk * followed by two colons : and any text representing the commentary, enclosed between carets ^…^.
  • Marked note: Any sequence of Unicode characters representing the marker, followed by a colon : and any text representing the commentary, enclosed between carets ^…^.

Notations for other phenomena can be inserted between double full stops ..…...

Overview

NotationConceptual ASTPaper Output
^*:C^ApparatusNote(General, 𝘊)φ
  • 𝘊 = the commentary (plain text or further notation inside ..).
  • 𝘔 = marker characters of the note.
  • φ = philological rendering of any notation.

Examples

NotationPaper Output
^*:This inscription represents a unique case of royal epigraphy.^

Apparatus

[Gen.]This inscription represents a unique case of royal epigraphy.
^1a:Maybe to be read as ..*abc*...^

Apparatus

1aMaybe to be read as abc.

EpiDoc Outputs

NotationEpiDoc (XML)
^*:This inscription represents a unique case of royal epigraphy.^
<ab>
</ab>
^1a:Maybe to be read as ..*abc*...^
<ab>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
^*:This inscription represents a unique case of royal epigraphy.^
ApparatusNote(General)
  Plain("This inscription represents a unique case of royal epigraphy.")
^1a:Maybe to be read as ..*abc*...^
ApparatusNote(1a)
  Plain("Maybe to be read as ")
  Unclear[medium, legibility: normal]
    Plain("abc")
  Plain(".")

Linguistic Annotation of a Lexical Unit

Annotation of a linguistic-lexical unit for in-depth analysis, featuring a comprehensive set of metadata which is omitted from the final visual representation but can be accessed depending on the output.

Delimiters

SideSignNameUnicode
Left&AmpersandU+0026
Right&AmpersandU+0026

&abc& ↓ Formatter optimisation for human legibility ↓ &abc⅋

SideSignNameUnicode
Left&AmpersandU+0026
RightTurned AmpersandU+214B

Any number of Unicode characters (representing any philological phenomenon) followed by a semicolon ; and optionally any number of linguistic annotations (metadata) made of a key (listed below), an equals sign =, and a value; everything enclosed between ampersands &…&.

Almost all annotations support the plausibility scale notation, allowing for stratified interpretations (cf. Interpretative Plausibility Assessment).

NotationConceptual ASTPaper Output
&𝑆×𝑁;λₛ=λᵥ;…&`LexicalUnit([𝘜], LinguisticAnalysis[
λₖ:λᵥ,…])`𝑆×𝑁
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • λₛ = label, which may also be in abbreviated form, for linguistic annotation.
  • λᵥ = value of the linguistic annotation (plausibility scale).
  • λₖ = canonical key for the linguistic annotation derived from the corresponding label.

Supported Metadata Keys

KeyMeaningFormattingMinification
language, lang, llanguagelangl
lemma, lem, llemmaleml
gloss, glglossglossgl
etymology, etymo, etym, etetymologyetymet
semantic_domain, semantic, semdom, sema, semsemantic domainsemdomsem
part_of_speech, pospart of speechpospos
notes, notenotesnotesnote

Supported Metadata Keys

KeyMeaningFormattingMinification
noun, nnounnn
verb, vverbvv
adjective, adj, ajadjectiveadjaj
article, art, atarticleartat
adverb, adv, avadverbadvav
pronoun, pron, prn, pnpronounpronpn
preposition, prep, pre, ppprepositionpreppp
conjunction, conj, cj, cconjunctionconjc
particle, part, prt, ptparticlepartpt
numeral, num, nunumeralnumnu

Supported Metadata Keys

KeyMeaningFormattingMinification
number, no, nr, numnumbernono
gender, gen, ggendergeng
person, pers, ppersonpersp
case, ccasecasec
tense, tntensetensetn
mood, mdmoodmoodmd
diathesis, diath, dia, voice, vcdiathesis, voicediathvc
comparison, compcomparison degreecompcomp
status, stat, ststatusstatst
definiteness, def, dfdefinitenessdefdf
declension, decl, dcdeclensiondecldc
conjugation, conj, cjconjugationconjcj

Supported Metadata Keys

KeyMeaningFormattingMinification
masculine, masc, male, mmasculinemascm
feminine, fem, female, ffemininefemf
neuter, neu, nneuterneun
common, com, mfcommoncomc

Supported Metadata Keys

KeyMeaningFormattingMinification
singular, sing, sg, ssingularsgs
plural, plur, pl, ppluralplp
dual, du, ddualdud
collective, coll, col, ccollectivecollc

Supported Metadata Keys

KeyMeaningFormattingMinification
first, 1st, 1first person1st1
second, 2nd, 2second person2nd2
third, 3rd, 3third person3rd3

Supported Metadata Keys

KeyMeaningFormattingMinification
nominative, nom, nnominativenomn
genitive, gen, ggenitivegeng
dative, dat, ddativedatd
accusative, acc, acaccusativeaccac
ablative, abl, abablativeablab
locative, loc, llocativelocl
instrumental, instr, iinstrumentalinstri
vocative, voc, vvocativevocv
direct, dir, didirect casedirdi
oblique, obl, o, indirect, indiroblique, indirect caseoblo

Supported Metadata Keys

KeyMeaningFormattingMinification
present, pres, prpresentprespr
past, paspastpaspa
imperfect, imperf, imp, ipimperfectimpip
perfect, perf, pfperfectperfpf
pluperfect, plupf, plup, plfpluperfectplupfplf
future, fut, ffuturefutf
aorist, aor, aoaoristaorao

Supported Metadata Keys

KeyMeaningFormattingMinification
indicative, indic, ind, idindicativeindid
imperative, imper, imp, ipimperativeimpip
subjunctive, subj, sub, sjsubjunctivesubjsj
optative, opt, ooptativeoo
infinitive, infin, inf, ifinfiniteinfif
participle, part, pt, pparticiplepartp
gerund, gerd, gdgerundgerdgd
gerundive, gerv, gvgerundivegervgv
supine, sup, spsupinesupsp

Supported Metadata Keys

KeyMeaningFormattingMinification
active, act, aactiveacta
passive, pass, ppassivepassp
middle, mid, mmiddlemidm
deponent, dep, ddeponentdepd
medio_passive, mediopassive, mpmediopassivempmp

Supported Metadata Keys

KeyMeaningFormattingMinification
positive, pos, ppositiveposp
comparative, comp, ccomparativecompc
superlative, super, sup, ssuperlativesups

Supported Metadata Keys

KeyMeaningFormattingMinification
absolute, abs, aabsoluteabsa
construct, cons, cconstructconsc
emphatic, emph, eemphaticemphe
predicative, pred, ppredicativepredp

Supported Metadata Keys

KeyMeaningFormattingMinification
definite, def, ddefinitedefd
indefinite, indef, ind, iindefiniteindi

Supported Metadata Keys

KeyMeaningFormattingMinification
diplomatic, diplo, dipldiplomaticdipldipl
transliteration, transl, tltransliterationtransltl
reading, read, rd, transcription, transc, trreadingreadrd
palaeographic, palaeo, paleographic, paleo, palpalaeographic formpalaeopal
graphic_function, graphic, function, grafunc, gfgraphic functiongrafuncgf

Supported Metadata Keys

KeyMeaningFormattingMinification
heterogram, hetero, ht, hgheterogramheterohg
logogram, logo, lglogogramlogolg
plain, plplain textplainpl

Supported Metadata Keys

KeyMeaningFormattingMinification
morph, mmorphological namespacemorphm
ling, llinguistic namespacelingl
script, sscript namespacescripts

References to Other Works

Notations that allow expressing external bibliographic references or intra-corpus remands.

Citation of External Works in Bibliography

An in-text citation referring to a secondary work already listed in the bibliography, with an optional sublocation.

Syntax

Any number of bibliographic citations, separated by semicolons ; and enclosed within double at signs @…@, consisting of:

  • the BibLaTeX label of a previously listed bibliographic entry;
  • an optional sublocation, consisting of a metadata key (listed below) and value separated by an equals sign =.

Overview

NotationConceptual ASTPaper Output
@βₗ=kᵟ:toᵟ-fromᵟ;…@Cite { refs: βᵣ }βₚ
  • βₗ = the label of the bibliographic entry, i.e. the text immediately after the curly bracket { until the end of the line.
  • kᵟ = any valid location key (listed below).
  • toᵟ = optional sublocation key for the end of the interval.
  • fromᵟ = optional sublocation key for the start of the interval or none if the interval is a single point.
  • βₚ = the parenthetic in-text citation rendered according to the Chicago Manual of Style, with optional sublocation.
Supported Metadata Keys
KeyMeaningFormattingMinification
column, col, ccolumncolc
line, ln, llinelnl
section, sec, sect, ssectionsects
page, pag, p, pgpagepagp
entry, nentryentryn
plate, pltplateplateplt

Examples

NotationPaper Output
@author_work_2026@

Bibliography

author_work_2026
@someone_book_1998=pag:30-33@

Bibliography

someone_book_1998
@first_scholar_book_1861=plate:6;second_scholar_book_1969=line:10-15@

Bibliography

first_scholar_book_1861
second_scholar_book_1969

EpiDoc Outputs

NotationEpiDoc (XML)
@author_work_2026@
<ab>
    <bibl>
        <ptr target="#author_work_2026"/>
    </bibl>
</ab>
@someone_book_1998=pag:30-33@
<ab>
    <bibl>
        <ptr target="#someone_book_1998"/>
        <citedRange unit="page" from="30" to="33">
        </citedRange>
    </bibl>
</ab>
@first_scholar_book_1861=plate:6;second_scholar_book_1969=line:10-15@
<ab>
    <bibl>
        <ptr target="#first_scholar_book_1861"/>
        <citedRange unit="plate" from="6">
        </citedRange>
    </bibl>
    <bibl>
        <ptr target="#second_scholar_book_1969"/>
        <citedRange unit="line" from="10" to="15">
        </citedRange>
    </bibl>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
@author_work_2026@
Cite
  → author_work_2026
@someone_book_1998=pag:30-33@
Cite
  → someone_book_1998 (pag 30)
@first_scholar_book_1861=plate:6;second_scholar_book_1969=line:10-15@
Cite
  → first_scholar_book_1861 (plate 6)
  → second_scholar_book_1969 (ln 10)

Reference to a Textual Locus

A cross-reference to a specific location within the text being edited or another text in the BEDA corpus, with one or more hierarchical levels (block, column, line, etc.).

Syntax

An optional BEDA file key, used to reference another project, separated by a colon :, possibly followed by a series of sublocations separated by semicolons ;, each consisting of a metadata key and a value separated by an equal sign =, all enclosed within hash symbols #…#.

Multiple locations, each with its own file key and optional series of sublocations, may be placed within the hash symbols #…#, separated by slashes /.

Overview

NotationConceptual ASTPaper Output
#ρₖᵟ:kᵟ=vᵟ;…/…#Locus { refs: ρᵣ }ρₚ
  • ρₖᵟ = optional BEDA key that redirects to another project.
  • kᵟ = any key corresponding to an arbitrary reference level (listed below).
  • vᵟ = value of the reference.
  • ρₚ = loci references rendered.
Supported Metadata Keys
KeyMeaningFormattingMinification
column, col, ccolumncolc
line, ln, llinelnl
section, sec, sect, ssectionsects
page, pag, p, pgpagepagp
entry, nentryentryn
folio, fol, ffoliofolf
face, facfacefacefac
side, sidsidesidesid
row, rwrowrowrw
block, blblockblockbl
fragment, frag, frfragmentfrfr
volume, vol, vvolumevolv
part, ptpartpartpt
manuscript, msmanuscriptmsms
chapter, chap, chchapterchapch
paragraph, para, parparagraphparpar
clause, clclauseclcl
word, wwordwordw
glyph, gglyphgg
number, no, nr, numnumbernono

Examples

NotationPaper Output
#manuscript=A; folio= 1#
#paikuli-d2-mp: block = D2; ln = 03#
#      thle-ta1: entry = Ta1; inscription = 2; col = 2; line = 1 /      cie-important-section: vol = 4; page = 100; section = 3    #

EpiDoc Outputs

NotationEpiDoc (XML)
#manuscript=A; folio= 1#
<ab>
    <ref target="#ms-A-fol-1">fol 1
    </ref>
</ab>
#paikuli-d2-mp: block = D2; ln = 03#
<ab>
    <ref target="beda:paikuli-d2-mp#block-D2-ln-03">block D2, ln 03
    </ref>
</ab>
#      thle-ta1: entry = Ta1; inscription = 2; col = 2; line = 1 /      cie-important-section: vol = 4; page = 100; section = 3    #
<ab>
    <ref target="beda:thle-ta1#entry-Ta1-inscription-2-col-2-ln-1">entry Ta1, inscription 2, col 2, ln 1
    </ref>
    <ref target="beda:cie-important-section#vol-4-pag-100-sect-3">vol 4, pag 100, sect 3
    </ref>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
#manuscript=A; folio= 1#
Locus
  → (ms A, fol 1)
#paikuli-d2-mp: block = D2; ln = 03#
Locus
  → paikuli-d2-mp (block D2, ln 03)
#      thle-ta1: entry = Ta1; inscription = 2; col = 2; line = 1 /      cie-important-section: vol = 4; page = 100; section = 3    #
Locus
  → thle-ta1 (entry Ta1, inscription 2, col 2, ln 1)
  → cie-important-section (vol 4, pag 100, sect 3)

Formatting and Internal Annotation

Tools dedicated to managing typographic emphasis and inserting metatextual comments. Includes markers for graphic relief (bold, italics) and documentation features for internal use (line or block comments) not intended for the publication of the critical text.

Italic Text (Emphasis)

Text displayed in italics, useful for example in apparatus notes (see Apparatus Note).

Syntax

Any number of Unicode characters enclosed by curly brackets {…} preceded by the command \i (italic).

Overview

NotationConceptual ASTPaper Output
\i{𝑆×𝑁}Emphasis(𝑆×𝑁)𝑆×𝑁
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).

Examples

NotationPaper Output
\i{abc}
abc

EpiDoc Outputs

NotationEpiDoc (XML)
\i{abc}
<ab>
    <hi rend="italic">abc</hi>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
\i{abc}
Emphasis
  Plain("abc")

Bold Text

Text displayed in bold, useful for example in footnotes (see Apparatus Note).

Syntax

Any number of Unicode characters enclosed by curly brackets {…} preceded by the command \b (bold).

Overview

NotationConceptual ASTPaper Output
\b{𝑆×𝑁}Strong(𝑆×𝑁)𝑆×𝑁
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).

Examples

NotationPaper Output
\b{abc}
abc

EpiDoc Outputs

NotationEpiDoc (XML)
\b{abc}
<ab>
    <hi rend="bold">abc</hi>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
\b{abc}
Strong
  Plain("abc")

Comments

Comments utilised to annotate IbiScript source code.

Comments may be entered freely as standard text. However, depending on the presence of an optional tag specified immediately after the left-hand delimiters, the purpose of the reminder can be categorised for file management tasks:

  • Untagged: introduces a standard comment, free working note, or general reminder;
  • TODO: indicates tasks, text segments, or record fields that are pending insertion or completion;
  • FIXME: flags syntactic errors, typos, or sections of the source code requiring a fix;
  • WARN: highlights critical points within the file or configurations demanding strict attention;
  • NOTE: introduces targeted annotations or specific clarifications regarding the code.

Opaque Line Comment

An entire line treated as an opaque comment, i.e. ignored in the final output and used solely to provide information to other contributors to the project.

Syntax

Any number of Unicode characters following the double slashes //, optionally preceded by a valid comment tag.

Overview

NotationConceptual ASTPaper Output
//Tᶜᵟ 𝑆×𝑁Comment(𝑆×𝑁, Tᵥᵟ, Line)
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • Tᶜᵟ = optional comment tag.
  • Tᵥᵟ = validated optional comment tag.

Examples

NotationPaper Output
//abc

EpiDoc Outputs

NotationEpiDoc (XML)
//abc
<ab>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
//abc
Comment(Line, None, "abc")

Opaque Block Comment

A block of text of any length and in any location, treated as an opaque comment – that is, ignored in the final output and used solely to leave information for other project contributors.

Syntax

Any number of Unicode enclosed between /*…*/, optionally preceded by a valid comment tag.

Overview

NotationConceptual ASTPaper Output
/*Tᶜᵟ 𝑆×𝑁*/Comment(𝑆×𝑁, Tᵥᵟ, Block)
  • 𝑆 = any sign (Unicode character) ∉ STOP_SET (cf. Technical Catalogue of Symbols) otherwise preceded by the escape character \.
  • 𝑁 = number of characters (represented by char or digits).
  • Tᶜᵟ = optional comment tag.
  • Tᵥᵟ = validated optional comment tag.

Examples

NotationPaper Output
/*abc*/

EpiDoc Outputs

NotationEpiDoc (XML)
/*abc*/
<ab>
</ab>

Structural Analysis (Conceptual AST)

NotationAST
/*abc*/
Comment(Block, None, "abc")

Software Guide

The IbiScript ecosystem comprises distinct software utilities designed to enable scholars to produce digital critical editions. This section of the manual details their operation, covering:

  • the foundational command-line interface (ibis CLI).
  • the web-based environment (IbiScript Editor) tailored for transcription and validation.

ibis Command Line Interface

The ibis CLI serves as the core command-line utility for processing IbiScript files bearing the .ibi extension. Invoking the tool with the --help option (or its short form, -h) provides a comprehensive list of available commands.

$ ibis -h

A compiler for the IbiScript epigraphic DSL

Usage: ibis <COMMAND>

Commands:
  compile      Compile a source file into the specified target format
  format       Format and canonicalise an IbiScript source file
  minify       Minify and canonicalise an IbiScript source file
  restitute    Restitute multiple IbiScript blocks (contiguous or parallel) into a composite critical edition
  annotations  Scan IbiScript files for tagged annotation comments (TODO, FIXME, WARN, NOTE)
  help         Print this message or the help of the given subcommand(s)


Options:
  -h, --help  Print help

Compiling source files via the compile command

The compile command processes an IbiScript source file to generate the specified target output format.

$ ibis compile -h

Compile a source file into the specified target format

Usage: ibis compile [OPTIONS] <FILE>

Arguments:
  <FILE>  The .ibi source file to compile

Options:
  -f, --format <FORMAT>               The target output format [default: html] [possible values: unicode, html, epidoc, typst, pdf]
  -o, --output <OUTPUT>               The output file path
      --inline-section-breaks         Inline section breaks instead of dropping them as block-level structural breaks
  -s, --lines <SEMANTIC_LINE_FILTER>  Extract specific semantic lines or ranges from the inscription (e.g., "2" or "4..5")
  -h, --help                          Print help

Formatting source files via format

The format command standardises the target IbiScript source file, ensuring syntactic consistency and optimal typographic layout.

$ ibis format -h

Format and canonicalise an IbiScript source file

Usage: ibis format [OPTIONS] <FILE>

Arguments:
  <FILE>  The .ibi source file to format

Options:
  -o, --output <OUTPUT>               Write output to a separate file, disabling in-place formatting
      --check                         Check compliance without rewriting the file (returns a non-zero exit code if non-compliant)
  -s, --lines <SEMANTIC_LINE_FILTER>  Extract specific semantic lines or ranges from the inscription (e.g., "2" or "4..5")
  -h, --help                          Print help

Minifying source files via minify

The minify command reduces the footprint of an IbiScript source file by eliminating computationally redundant elements — such as extraneous white space, line breaks, and optionally, editorial comments — without altering the semantic integrity of the text. This process of syntactic compression is ideal for optimizing data storage and ensuring a canonical, compact representation of the document.

$ ibis minify -h

Minify and canonicalise an IbiScript source file

Usage: ibis minify [OPTIONS] <FILE>

Arguments:
  <FILE>  The .ibi source file to minify

Options:
  -o, --output <OUTPUT>               Write output to a separate file, disabling in-place minification
      --check                         Check compliance without rewriting the file (returns a non-zero exit code if non-compliant)
  -k, --keep-comments                 Preserve comments in the minified output rather than discarding them
  -s, --lines <SEMANTIC_LINE_FILTER>  Extract specific semantic lines or ranges from the inscription (e.g., "2" or "4..5")
  -h, --help                          Print help

Restitutio textus from multiple inscriptions with restitute

The restitute command enables the reconstruction of a composite or synoptic critical text from parallel witnesses or contiguous epigraphic fragments. The process is driven by a TOML manifest file, which provides ANSELMUS with the necessary instructions to compute structural relationships between text blocks, alignment parameters, and fragment seams. Supported export formats include all those available via the compile command, in addition to the IbiScript format itself.

$ ibis restitute -h

Restitute multiple IbiScript inscriptions (contiguous or parallel) into a composite critical edition

Usage: ibis restitute [OPTIONS] --output <OUTPUT> <MANIFEST>

Arguments:
  <MANIFEST>  A manifest (TOML) instructing the engine on block relationships, alignment parameters, and seams

Options:
  -f, --format <FORMAT>  The target output format [default: html] [possible values: unicode, html, epidoc, typst, pdf, ibiscript]
  -o, --output <OUTPUT>  The output file path
  -h, --help             Print help

Scanning work comments with annotations

The annotations command systematically scans IbiScript source files for work comments marked with specific tags (TODO, FIXME, WARN, NOTE). This tool enables the editor to track the progress of the edition and locate unresolved critical points prior to final compilation. Via the CLI options, users can restrict the scan to specific tags, collapse output onto a single line to facilitate grep integration, export results as JSON, or force a non-zero exit status if matches are found (ideal for automated validation scripts).

$ ibis annotations -h

Scan IbiScript files for tagged annotation comments (TODO, FIXME, WARN, NOTE)

Usage: ibis annotations [OPTIONS] [PATHS]...

Arguments:
  [PATHS]...  Files or directories to scan

Options:
  -t <TAGS>           Restrict to specific tags (repeatable). Omit to include all tagged comments
      --no-recursive  Do not descend into subdirectories
      --check         Exit non-zero if any matching annotation is found; suppresses listing unless --verbose
      --verbose       Print matches even when --check is set
      --json          Output as JSON
      --oneline       Collapse multi-line comment text onto a single line (useful for grep/scripting)
  -h, --help          Print help

Integrated web editor

The IbiScript Editor serves as the central environment for encoding critical editions and apparatus, seamlessly embedded within the BEDA suite. The interface is engineered to support the scholar’s workflow without disruption: the ANSELMUS parsing engine operates continuously in the background, highlighting syntactic anomalies via inline visual indicators directly within the text. Should an error occur, the live preview panel, which displays the web-rendered edition, avoids crashing; instead, it gracefully preserves the last valid state alongside a clear message to guide the user’s correction.

Document Management and Data Persistence

The File menu handles the import and preservation of epigraphic data. The editor allows local files bearing the .ibi or plain text extensions to be loaded. To prevent the accidental loss of transcriptions due to abrupt browser tab closure, the environment integrates a protective safeguard: if unsaved changes are present, any attempt to navigate away from the page is intercepted, prompting the user for explicit confirmation.

Syntactic Standardisation (Format)

Accessible via the Edit menu, the Format Document function acts as a formal regulariser of the source text. Without altering the semantic value of the readings or critical marks entered, the algorithm automatically reorganises the spacing, alignment, and indentation of the IbiScript code. This operation ensures maximum readability of the source file and standardises the logical layout criteria of the document.

Error Tolerance in the Dynamic Preview

The preview panel offers a real-time rendering of the web-ready edition. To prevent disruptions to the philological workflow, the interface adopts a strict error-tolerance policy during parsing: should a syntactically non-compliant string be entered, the system moves into a warning state. In this mode, the preview preserves the rendering of the last valid state intact, displaying a descriptive notification alongside it to facilitate the detection and correction of the anomaly.

Visual Management and Facsimile Data Persistence

The facsimile panel allows precise geometric coordinates to be mapped onto the lines of the inscription text. The user is not required to write the configuration syntax manually: the editor automatically generates and updates a dedicated metadata block as soon as a region is drawn or resized using the mouse on the image. This data block ensures the persistence and portability of the visual anchoring directly within the source file.

An example of a block automatically generated by the graphical interface:

$image;
url = paikuli-block.png;
categ = museum;
regions = [
  1 = 0.042501, 0.083288, 0.905037, 0.198611;
  2 = 0.052631, 0.364167, 0.892105, 0.242778;
  3 = 0.044736, 0.701359, 0.902631, 0.182083
]
$

Within this structure, the url field identifies the visual resource, cat defines the archaeological or museum category of the image, and the reg array stores the geometric regions (normalised on a decimal scale) indexed according to their respective inscription line number.

Exporting to Scientific Dissemination Formats

The Export menu allows the instant conversion of the IbiScript file into five standard formats for research and publishing:

  • pure Unicode text for elementary diplomatic editions;
  • HTML for direct publication on the web portal;
  • EpiDoc XML to ensure data interoperability according to international Digital Humanities criteria;
  • Typst and PDF, the latter being compiled directly by the server from the former, delivering a high-definition, print-ready typographic document.

Editor Keyboard Shortcuts

ShortcutFunction
Alt + Shift + FFormat and standardise syntax
Alt + IToggle facsimile panel
Alt + PToggle preview panel
Ctrl + BFormat as bold
Ctrl + IFormat as italic
Ctrl + Shift + ILoad facsimile image
Ctrl + OOpen local file
Ctrl + SSave changes
Ctrl + Shift + SSave document as
Ctrl + PExport directly to PDF document
Ctrl + UInsert characters through Unicode aliases or codepoints
F11Toggle fullscreen editor workspace
F1Open official documentation in a new tab

Technical Catalogue of Symbols

Systematic reference tables associating each epigraphic sign or delimiter with its Unicode code, providing the descriptive name, the code, and, where applicable, usage contexts or explanatory notes.

Output Delimiters

SignNameUnicodeConstruct
(Left ParenthesisU+0028Abbreviation, Cite
)Right ParenthesisU+0029Abbreviation, Cite
[Left Square BracketU+005BSupplied, Gap
]Right Square BracketU+005DSupplied, Gap
Left White Curly BracketU+2983Choice
Right White Curly BracketU+2984Choice
Z Notation Left Image BracketU+2987Unclear
Z Notation Right Image BracketU+2988Unclear
Mathematical Left White Square BracketU+27E6Erasure
Mathematical Right White Square BracketU+27E7Erasure
Left-Pointing Angle BracketU+2329Omitted
Right-Pointing Angle BracketU+232AOmitted
Bottom Left Half BracketU+2E24PreviousSeen
Bottom Right Half BracketU+2E25PreviousSeen
Reverse Solidus OperatorU+29F5Ligature
Reverse Solidus with Horizontal StrokeU+29F7Ligature
Left Substitution BracketU+2E02Addition
Right Substitution BracketU+2E03Addition
Left Dotted Substitution BracketU+2E02Correction
Right Dotted Substitution BracketU+2E03Correction
Triple Nested Less-ThanU+2AF7ApparatusMark
Triple Nested Greater-ThanU+2AF8ApparatusMark

Special Stop Characters

SignNameUnicode
\nLine Feed (LF)U+000A
!Exclamation MarkU+0021
#Number SignU+0023
$Dollar SignU+0024
/SolidusU+002F
(Left ParenthesisU+0028
)Right ParenthesisU+0029
*AsteriskU+002A
Low AsteriskU+204E
Two Asterisks Aligned VerticallyU+2051
%Percent SignU+0025
Per Mill SignU+2030
+Plus SignU+002B
Double DaggerU+2021
Mathematical Left White Square BracketU+27E6
Mathematical Right White Square BracketU+27E7
=Equals SignU+003D
Not Equal ToU+2260
-Hyphen-MinusU+002D
<Less-Than SignU+003C
>Greater-Than SignU+003E
?Question MarkU+003F
[Left Square BracketU+005B
]Right Square BracketU+005D
^Circumflex AccentU+005E
_Low LineU+005F
{Left Curly BracketU+007B
}Right Curly BracketU+007D
|Vertical LineU+007C

Writing systems supported for key:value entry

List of ISO 15924 codes relating to the writing systems supported by IbiScript for the engonomic insertion of Unicode characters. The four-letter code must be entered as the identifier for the chosen writing system, followed by a colon : and the nominal aliases for each glyph, separated by commas , if more than one is to be entered (cf. Coded Signs).

All characters, including those from unsupported writing systems, can be entered using the corresponding Unicode character code.

ISO CodeName
aghbCaucasian Albanian
ahomAhom
arabArabic
armiImperial Aramaic
armnArmenian
avstAvestan
bengBengali
bhksBhaiksuki
brahBrahmi
cakmChakma
cariCarian
chrsChorasmian
coptCoptic
cpmnCypro-Minoan
cprtCypriot
cyrlCyrillic
devaDevanagari
diakDives Akuru
dogrDogra
egypEgyptian Hieroglyphs
elbaElbasan
elymElymaic
ethiEthiopic
georGeorgian
glagGlagolitic
gongGunjala Gondi
gonmMasaram Gondi
gothGothic
granGrantha
grekGreek
gujrGujarati
gukhGurung Khema
guruGurmukhi
hatrHatran
hebrHebrew
hluwAnatolian Hieroglyphs
hmngPahawh Hmong
hmnpNyiakeng Puachue Hmong
hungOld Hungarian
italOld Italic
kaliKayah Li
kawiKawi
kharKharoshthi
khojKhojki
kndaKannada
kraiKirat Rai
kthiKaithi
latnLatin
lepcLepcha
limbLimbu
linaLinear A
linbLinear B
lyciLycian
lydiLydian
mahjMahajani
mandMandaic
maniManichaean
marcMarchen
mercMeroitic Cursive
meroMeroitic Hieroglyphs
mlymMalayalam
modiModi
mongMongolian
mteiMeetei Mayek
multMultani
mymrMyanmar
nandNandinagari
narbOld North Arabian
nbatNabataean
newaNewa
nkooNko
ogamOgham
orkhOld Turkic
oryaOriya
osmaOsmanya
ougrOld Uyghur
palmPalmyrene
permOld Permic
phagPhags-pa
phliInscriptional Pahlavi
phlpPsalter Pahlavi
phnxPhoenician
prtiInscriptional Parthian
runrRunic
samrSamaritan
sarbOld South Arabian
shrdSharada
siddSiddham
sindKhudawadi
sinhSinhala
sogdSogdian
sogoOld Sogdian
soraSora Sompeng
soyoSoyombo
sunuSunuwar
syloSyloti Nagri
syrcSyriac
takrTakri
tamlTamil
teluTelugu
tfngTifinagh
thaaThaana
tibtTibetan
tirhTirhuta
tnsaTangsa
tutgTulu-Tigalari
ugarUgaritic
xpeoOld Persian
xsuxCuneiform
yeziYezidi
zanbZanabazar Square
---COMMON

Glossary of terms

Lectio (pl. lectiones) — The individual interpretative choice made by the editor in epigraphic, philological, or linguistic matters.