Skip to main content

Block

Enum Block 

Source
pub enum Block {
Show 24 variants Heading { level: u8, lemma: String, }, Paragraph { text: String, }, Dialogue { lemma: String, text: String, lit: bool, }, Speech { text: String, genoses: Vec<String>, fields: Vec<(String, String)>, }, Span { kind: String, lo: u32, hi: u32, genoses: Vec<String>, fields: Vec<(String, String)>, }, Milestone { scheme: String, value: String, at: u32, }, Annotate { fields: Vec<(String, String)>, }, Parsed { lo: u32, hi: u32, onym: Option<String>, parsings: Vec<Parsing>, }, Periodos { lo: u32, hi: u32, id: String, }, Character { lemma: String, onym: Option<String>, text: String, genoses: Vec<String>, }, Wear { genoses: Vec<String>, }, Text { text: String, }, Open { kind: Container, lemma: Option<String>, }, Close { hypograph: Option<String>, }, Verbatim { lang: Option<String>, text: String, }, NoteRef { onym: String, family: Option<NoteFamily>, margin: bool, at: Option<u32>, }, IndexMark { term: String, }, Ref { target: String, text: Option<String>, internal: bool, }, Anchor { onym: String, }, Cite { target: String, locator: Option<String>, }, Bib { key: String, text: String, fields: Vec<(String, String)>, genus: Option<String>, }, Label { onym: String, }, Verse { lemma: Option<String>, strophes: Vec<Vec<String>>, hypograph: Option<String>, }, Table { lemma: Option<String>, headers: Option<Vec<String>>, rows: Vec<Vec<Cell>>, },
}
Expand description

A block-level event in the text-level vocabulary — what a format adapter emits. Headings arrive flat; the section tree is derived here, once, for every adapter.

Variants§

§

Heading

A flat heading: level is the source level (h2 → 2, a LaTeX \section → its depth), lemma its text.

Fields

§level: u8
§lemma: String
§

Paragraph

A plain paragraph — the implicit, lemma-less block.

Fields

§text: String
§

Dialogue

A speech: a paragraph whose lemma names the speaker (TEI’s <said who> / <sp><speaker>, litogramma’s dialogue sim). The reader sees a paragraph; ::lemma answers the speaker and the text stays the words spoken.

Fields

§lemma: String
§text: String
§lit: bool

The literary reading names the block dialogue (litogramma’s sim); the text level reads it as a paragraph with a lemma.

§

Speech

The literary reading (lit:): a prose block that is a speech — litogramma’s dialogue-line (at-drama @:-), TEI’s whole-paragraph <said> — with the unseen metadata its aphanes monosims carry (prosopon, the speaker) as fields and its genoses as traits.

Fields

§text: String
§genoses: Vec<String>
§fields: Vec<(String, String)>
§

Span

The literary reading: an inline span of the preceding flow block — a quotation, an annotation (a name), an emphasis, a stage direction — named by its litogramma sim, at byte offsets into the block’s normalized text, with its genoses as traits and its aphanes monosims as fields. Spans nest by containment of offsets: a name inside a speech is the speech’s child.

Fields

§kind: String
§lo: u32
§hi: u32
§genoses: Vec<String>
§fields: Vec<(String, String)>
§

Milestone

The literary reading: a milestone (@("page:12")) at an offset into the preceding flow block — ::scheme, ::value.

Fields

§scheme: String
§value: String
§at: u32
§

Annotate

The literary reading: unseen metadata on the preceding block itself (a paragraph’s eidos).

Fields

§fields: Vec<(String, String)>
§

Parsed

The parsing pack (ruling #80): a token the source itself parsed — litogramma’s at-epimerismos diaphane, which TEI’s w/pc, the Russian National Corpus, OpenCorpora and PROIEL import to — at byte offsets into the preceding flow block, with its parsings (the first is the reading’s; the rest are alternatives) and the onym a head may point at.

Fields

§lo: u32
§hi: u32
§parsings: Vec<Parsing>
§

Periodos

The parsing pack: a sentence the source declared (the periodos diaphane, TEI’s s), at byte offsets into the preceding flow block, with the source’s id.

Fields

§lo: u32
§hi: u32
§

Character

The literary reading: a cast entry the source declares (at-drama’s @:!! name … !!:@(id), a dramatis-persona line, TEI’s cast list) — the name, the id when the source gives one, the description as the node’s text.

Fields

§lemma: String
§text: String
§genoses: Vec<String>
§

Wear

The literary reading: genoses the preceding block wears as traits — the sim of a paragraph-level simmere that has no reading of its own (a block stage direction’s paragraphs read paragraph<stage-direction>).

Fields

§genoses: Vec<String>
§

Text

Inline content belonging directly to the open container (a list item’s own text, a bare-text blockquote). With no open container it is read as a paragraph.

Fields

§text: String
§

Open

Open a nesting container. Items take their unordered- / ordered- flavor (and taxis) from the enclosing list.

Fields

§

Close

Close the innermost open container, optionally with its hypograph (footer or attribution).

Fields

§hypograph: Option<String>
§

Verbatim

A verbatim block — code or other preformatted lines, kept as authored.

Fields

§text: String
§

NoteRef

An in-text note callout (the deixis, ruling #35): onym names the body it cites within its family. Emitted after the flow block it sits in; it becomes that block’s child, in order, and the block’s own text stays clean of markers. family: None means the source declares none (an HTML noteref): the callout takes its resolved body’s family, and a dangling one defaults to footnote.

Fields

§onym: String
§margin: bool

The declared spelling placed this pair in the margin (a Tufte-style sidenote): surfaced as ::::form = "margin" on both ends — the family stays footnote, placement is presentation.

§at: Option<u32>

The callout’s byte offset in the flow block’s text, when the producer knows it (the literary reading’s inline notes): the citation in force at the note.

§

IndexMark

An index mark (ruling #36): an invisible anchor declaring this place concerns term. The back-of-book index is a query over these, never a stored structure.

Fields

§term: String
§

Ref

A reference mark — the text-level mention (html’s in-prose <a href>, markdown’s [text](url), LaTeX’s \ref): target is the identifier as written, text the authored link text (LaTeX \ref has none), and internal is the producer’s declaration that the target names a label in this document (#fragment, a \ref key) rather than another document. A mention, not an attachment: refs do not carry <deixis>.

Fields

§target: String
§internal: bool
§

Anchor

A point anchor — an invisible in-flow node bearing an onym at this position (LaTeX’s mid-flow \label, an inline html id=). The IndexMark construction: child of its flow block, document order.

Fields

§onym: String
§

Cite

A citation mark — the bibliography’s mention (LaTeX’s \cite, koine’s cite monosim): target is the authored key, resolved against the bib bearers — a namespace of its own, separate from labels (LaTeX precedent). The locator is the mark’s own pinpoint (\cite[I.1]{key}, [@key, I.1]), kept as written.

Fields

§target: String
§locator: Option<String>
§

Bib

One bibliographic entry: a block bearing its authored key. Unstructured sources (\bibitem) carry the full reference as text; structured ones (bibliogramma, BibTeX/BibLaTeX through it) carry fields — canonical campus name → value, Latin per the bibliogramma vocabulary — and the entry’s genus (liber, commentarius, …).

Fields

§text: String
§fields: Vec<(String, String)>
§

Label

A block label: the innermost open section takes onym as the name it bears (a heading’s id; a \label attached to a sectioning command — the promotion rule). With no open section it degrades to a point Block::Anchor.

Fields

§onym: String
§

Verse

A verse block (ruling #37 — litogramma’s stichoi model): strophes of lines, denormalized like Block::Table. Lines arrive flattened by the adapter and are kept as authored; the stichos ::taxis numbers lines 1-based, CONTINUOUSLY across strophes — the citation coordinate.

Fields

§strophes: Vec<Vec<String>>
§hypograph: Option<String>
§

Table

A table, denormalized here into nested lists (rows = ordered items with the <row> trait, cells = unordered items with the <cell> trait and the column name as ::lemma). Header detection is the adapter’s job; the lowering rule lives here. A cell’s own label (a row’s th) wins over the positional headers entry.

Fields

§headers: Option<Vec<String>>
§rows: Vec<Vec<Cell>>

Trait Implementations§

Source§

impl Clone for Block

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source. Read more
Source§

impl Debug for Block

Source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
Source§

impl PartialEq for Block

Source§

fn eq(&self, other: &Self) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl StructuralPartialEq for Block

Auto Trait Implementations§

§

impl Freeze for Block

§

impl RefUnwindSafe for Block

§

impl Send for Block

§

impl Sync for Block

§

impl Unpin for Block

§

impl UnsafeUnpin for Block

§

impl UnwindSafe for Block

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.