<note> Types

Footnote <note>

Element:note
empty (all content is contained within the note’s child char elements)
Added:1.0
Use:Contains child <char> elements to contain the content for a footnote, endnote, or study note.
@caller:Note caller. *
+ | - | <user defined caller>
A <user defined caller> may be any single character or sequence of characters preferred as the caller for a note.
@style:Content (footnote) type. *
f (footnote) | fe (endnote) | ef (extended / study note)
@category:Optional attribute used to tag the Footnote <note> as belonging to a specific category of study content (e.g. Ideas, People, Places, Objects etc.). The @category attribute is normally only applied to <note> @style=”ef”.
Valid in:Book Titles, Book Introduction, Book Introduction End Titles, Chapter Content
Parents:<para>, <char>, <cell>

Diagram

_images/usx-element_notef.png

Footnote <char>

Element:char
xsd:string
Added:1.0
Use:An element for marking various footnote content types.
@style:Footnote content type. *
The <char> (Footnote) @style types list (below) presents an itemization of @style values valid within <char> elements which are children of <note> @style=”f”, <note> @style=”fe”, and <note> @style=”ef”.
Valid in:Footnote <note>

Diagram

_images/usx-element_charf.png

Footnote <char> @style Types

fr

@style:fr
Use:Footnote “origin” reference.
This is the chapter and verse(s) that note refers to.
Valid In:Any Footnote <char>

Text and Formatting Sample - Mark 1.1 (GNT)

<note caller="+" style="f">
  <char style="fr">1.1: </char>
  <char style="ft">Some manuscripts do not have </char>
  <char style="fq">the Son of God.</char>
</note>

ft

@style:ft
Use:Footnote text
The primary (explanatory) text of the footnote.
Valid In:Any Footnote <char>

fk

@style:fk
Use:A specific keyword/term from the text for which the footnote is being provided.
Valid In:Any Footnote <char>

Text and Formatting Sample - Genesis 3.20 (GNT)

<note caller="+" style="f">
  <char style="fr">3.20: </char>
  <char style="fk">Adam </char>
  <char style="ft">This name in Hebrew means "all human beings."</char>
</note>
_images/usx-notechar-style_fk.jpg

fq

@style:Footnote translation quotation.
Use:A quotation from the current scripture text translation for which the note is being provided.
Longer quotations are sometimes shortened using an ellipsis (i.e. suspension dots “…”).
Valid In:Any Footnote <char>

Text and Formatting Sample - Mark 1.1 (GNT)

<note caller="+" style="f">
  <char style="fr">1.1: </char>
  <char style="ft">Some manuscripts do not have </char>
  <char style="fq">the Son of God.</char>
</note>
_images/usx-notechar-style_fq.jpg

fqa

@style:fqa
Use:Footnote alternate translation.
Used to distinguish between a quotation of the current scripture text translation, and an alternate translation.
Valid In:Any Footnote <char>

Text and Formatting Sample - Mark 1.4 (GNT)

<note caller="+" style="f">
  <char style="fr">1.4: </char>
  <char style="fq">John appeared in the desert, baptizing and preaching; </char>
  <char style="ft">some manuscripts have </char>
  <char style="fqa">John the Baptist appeared in the desert, preaching.</char>
</note>
_images/usx-notechar-style_fqa.jpg

fl

@style:fl
Use:Footnote “label” text.
Can be used for marking or “labeling” a word or words which are used consistently across certain types of translation notes (such as the words “Or” in an alternative translation style note, “Others”, “Heb.”, “LXX” etc.).
Valid In:Any Footnote <char>

fw

usx3.0

@style:fw
Added:3.0
Use:Footnote witness list.
For distinguishing a list of sigla representing witnesses in critical editions.
Valid In:Any Footnote <char>

Note

Apparatus entries of printed critical editions are densely packed with information. One key part is the list of witnesses supporting a specific reading. The witnesses are usually represented by sigla consisting of one character, an abbreviation, or a number. It can be very helpful to distinguish witness lists from other footnote text, which can make it simpler to introduce checking tools for these lists, and to create linking and reader helps in digital representations.

Text and Formatting Samples - Matthew 28.14 (Nestle-Aland 29)

<note caller="⸀" style="f">
        <char style="fr" closed="false">28,14 </char><char style="ft" closed="false">υπο </char>
        <char style="fw" closed="false">B D 0148. 892</char>
</note>
_images/usx-notechar-style_fw.jpg

Matthew 4.1 (Nestle-Aland 29)

<note caller="°" style="f">
        <char style="fr" closed="false">4,1 </char><char style="fw" closed="false">B Δ 700</char>
</note>
_images/usx-notechar-style_fw-alt.jpg

fp

@style:fp
Use:Footnote additional paragraph.
Use this marker to if you need to indicate the start of a new paragraph within a footnote (uncommon).
Valid In:Any Footnote <char>

fv

@style:fv
Use:Footnote verse number.
A verse number in the the text quotation or alternative translation.
Valid In:Any Footnote <char>

Text and Formatting Sample - John 7.38 (GNT)

<note caller="+" style="f">
  <char style="fr">7.38: </char>
  <char style="ft">Jesus' words in verses 37-38 may be translated: </char>
  <char style="fqa">“Whoever is thirsty should come to me and drink. </char>
  <char style="fv">38</char> As the scripture says, ‘Streams of life-giving water
  will pour out from within anyone who believes in me.’”
</note>
_images/usx-notechar-style_fv.jpg

fdc

@style:fdc
Deprecated:usx3.0 3.0
Use:Material to be included only in publications that contain the Deuterocanonical/Apocrypha books.
Deprecated (use is discouraged)

ico_Cg Recommended alternate: General purpose use of <char> @style dc wherever DC-only content is being marked.
Valid In:Any Footnote <char>

Note

Other <char> @style types may be nested within any of the standard footnote <char> @style types shown in the list above.

Cross Reference <note>

Element:note
empty (all content is contained within the note’s child char elements)
Added:1.0
Use:Contains child <char> elements to contain the content for a cross reference or study cross reference.
@caller:Cross reference caller. *
+ | - | <user defined caller>
A <user defined caller> may be any single character or sequence of characters preferred as the caller for a note.
@style:Content (cross reference) type. *
x (cross reference) | ex (extended / study cross reference)
Valid in:Book Titles, Book Introduction, Book Introduction End Titles, Chapter Content
Parents:<para>, <char>, <cell>

Diagram

_images/usx-element_notex.png

Cross Reference <char>

Element:char
xsd:string
Added:1.0
Use:An element for marking various cross reference content types.
@style:Cross reference content type. *
The <char> (Cross Reference) @style types list (below) presents an itemization of @style values valid within <char> elements which are children of <note> @style=”x”.
Valid in:Cross Reference <note>

Diagram

_images/usx-element_charx.png

Cross Reference <char> @style Types

xo

@style:xo
Use:Cross reference origin reference.
This is the chapter and verse(s) that target (@style=”xt”) reference(s) are being provided for.
Valid In:Any Cross Reference <char>

Text and Formatting Sample - Matthew 2.23 (GNT)

<note caller="-" style="x">
  <char style="xo">2.23: </char>
  <char style="xt">Mk 1.24; Lk 2.39; Jn 1.45.</char>
</note>
_images/usx-notechar-style_xo.jpg

xop

usx3.0

@style:xop
Added:3.0
Use:Published cross reference origin text.
In some texts, the content intended to be published in the position of the cross reference origin text xo does not follow the typical <chapter><separator><verse> pattern. An origin reference following this pattern is required for validation of the cross reference location. <char @style="xop">...</char> can be used in order to supply the content intended for publishing, similar to the use of chapter@pubnumber and verse@pubnumber.
Valid In:Any Cross Reference <char>

Text and Formatting Sample - Jonah 1.1-5 (Bulgarian Orthodox Bible)

<note caller="-" style="x">
        <char style="xo">1:1 </char>
        <char style="xop">Гл 1. (1) </char>
        <char style="xt">4 Царств. 14:25.</char>
</note>
...
<note caller="-" style="x">
        <char style="xo">1:2 </char>
        <char style="xop">(2) </char>
        <char style="xt">Бит. 10:11. Иона 3:3.</char>
</note>
...
<note caller="-" style="x">
        <char style="xo">1:4 </char>
        <char style="xop">(4) </char>
        <char style="xt">Пс. 106:25.</char>
</note>
...
<note caller="-" style="x">
        <char style="xo">1:5 </char>
        <char style="xop">(5) </char>
        <char style="xt">4 Царств. 17:29.</char>
</note>
_images/usx-notechar-style_xop.jpg

xt

@style:xt
Use:Cross reference target reference(s).
The list of target scripture passages being suggested as references for comparison/review with respect to the text (or concept) of the origin reference.
A list of book name abbreviations and chapter + verse references, separated by semicolons or other book list separator character.
Updated:3.0 (attributes)
Valid In:Any Cross Reference <char>

Attributes ico_Tag

usx3.0

An additional link-href attribute for <char> can be used in this context, followiung the definitions for linking attributes.

@link-href:Citation form for the term in the glossary
link-href:Unambiguously identifies the scripture target reference using a standard scripture reference format. (default)
Book names must be one of bookCode. Chapter verse separator is always a colon :. A string of pattern: [A-Z1-4]{3} ?[a-z0-9\-,:]*

In some scenarios a target reference is written in a format which cannot be accurately parsed and identified. Providing the link-href attribute allows greater flexibility in the use of char@style xt.

In this context, link-href should only target scripture references for the current text (i.e. references to other project texts or non-scripture URIs are not allowed)

Text Sample - Genesis 2 (Russian Synodal, Protestant Version, extending the sample for para@style cd - chapter description)

<chapter number="2" style="c" />
<para style="cd"><char style="xt" link-href="GEN 2:1">1</char> Бог благословляет седьмой
  день; <char style="xt" link-href="GEN 2:8">8</char> человек в раю Едемском; четыре реки;
  дерево познания добра и зла. <char style="xt" link-href="GEN 2:18">18</char> Человек дает
  названия животным. <char style="xt" link-href="GEN 2:21">21</char> Создание женщины.
<para style="p">
  <verse number="1" style="v" sid="GEN 2:1" />Так совершены небо и земля и все воинство их.
  <verse eid="GEN 2:1" />
</para>
<para style="p">
  <verse number="2" style="v" sid="GEN 2:2" />И совершил Бог к седьмому дню дела Свои, которые
  Он делал, и почил в день седьмой от всех дел Своих, которые делал.<verse eid="GEN 2:2" />
</para>

A number (7) alone marked with <char style="xt">7</char> is ambiguous, since it could refer to chapter 7 or verse 7 (in Paratext, a number alone is interpreted as a chapter reference). Extending char@style xt with the link-ref attribute makes it possible to express the target reference unambiguously.

<char style="xt" link-href="MAT 6:7">7</char>
<char style="xt" link-href="MAT 6:7">verse 7</char>
<char style="xt" link-href="MAT 6:7">v7</char>

xta

usx3.0

@style:xta
Added:3.0
Use:Target reference(s) extra / added text.
Used for marking text which should be ignored when identifying or linking to cross reference target references.
Valid:Any Cross Reference <char>

Text Sample - Matthew 3.0 (GNT)

<note caller="-" style="x">
  <char style="xo">3.0: </char>
  <char style="xta">Compare with </char>
  <char style="xt">Mk 1.1-8; Lk 3.1-18; </char>
  <char style="xta">and</char>
  <char style="xt">Jn 1.19-28 </char>
  <char style="xta">parallel passages.</char>
</note>

xk

@style:xk
Use:A keyword from the scripture translation text which the target reference(s) also refer to.
Valid In:Any Cross Reference <char>

xq

@style:xq
Use:A quotation from the scripture text.
Use of a quotation would be intended to help the reader to understand the portion of text (or concept) for which the target (xt) reference(s) are being supplied.
Valid In:Any Cross Reference <char>

xot

@style:xot
Use:References (or other text) which is only to be included in publications that contain the Old Testament books.
Valid In:Any Cross Reference <char>

xnt

@style:xnt
Use:References (or other text) which only to be included in publications that contain the New Testament books.
Valid In:Any Cross Reference <char>

xdc

@style:xdc
Deprecated:usx3.0 3.0
Use:References (or other material) to be included only in publications that contain the Deuterocanonical/Apocrypha books.
Deprecated (use is discouraged)

ico_Cg Recommended alternate: General purpose use of <char> @style dc wherever DC-only content is being marked.
Valid In:Any Cross Reference <char>