Elements

<usx>

Element

usx *
empty

Added

1.0

Use

Root element for USX scripture file.

@version

USX version identifier. *
xsd:decimal
Only the specific USX version number for scripture data contained in the file is allowed (1.0, 2.0, 2.5 etc.).

Parent

ROOT

The following schema diagram displays the document structure of a USX scripture file.

Diagram and Text Sample

_images/usx-element_usx.png
<usx version="2.5">

<book>

Element

book *
xsd:string

Added

1.0

Use

Brief description of scripure translation.

@code

3-letter book code for the scripture or peripheral content in the USX document. *
one of bookCode

@style

Content type. *
id

Valid in

Book Identification

Parent

<usx>

Diagram and Text Sample - Matthew (GNT)

_images/usx-element_book.png
<book code="MAT" style="id">English: Good News Translation 2nd Ed. 1992</book>

<chapter>

Note

Background on <chapter> and <verse> as ‘milestones’

A milestone type markup is required when a document has two or more structures that interact in a non-hierarchical manner. This is also referred to as overlapping or concurrent markup. A principle example of this type of overlapping structure in scripture text is the contrast between 1) the paragraph structures used to express the discourse / narrative of the text and 2) the division of the text into books, chapters and verses. In scripture texts encoded using USX (and similarly also in USFM), the paragraph level markup forms the main structure of the document, while chapter and verse elements are empty milestones which identify the location where the chapter or verse begins.

Note

Accurately identifying chapter text within the scripture paragraph structure

usx3.0 USX 3.0 adds a pair of attributes to <chapter/> (sid and eid) which are used to unambiguously identify the start and end position for a specific chapter text within the scripture discourse structure.

IMPORTANT: In USX 3.0 a <chapter/> milestone is required at the start and at the end of the verse text, with corresponding sid and eid attributes. In previous versions of USX, only a <chapter/> start milestone was required.

ico_See See: Background on chapter and verse as milestones

Element

chapter *
empty

Added

1.0

Use

Initial element within each chapter text division. Marks the start of a new chapter.

@style

Content type. *
c

@number

Current chapter number (sequential; according to versification definition for the scripture text). *
xsd:integer

@altnumber

Alternate chapter number. (Used to supply the chapter number for an alternate versification scheme. This is required when the numbering for an alternate versification tradition need to be maintained within the same translation text.)
xsd:string of pattern [0-9]+\w?(\u200F?[\-,][0-9]+\w?)*

@pubnumber

Published chapter character. (The chapter character(s) (a string - number, letter or both) which should be displayed in a published version of the scripture text, where the published chapter character is different than the sequential chapter number used within the translation editing environment, as defined by the project versification.) *
xsd:string

@sid

usx3.0 Chapter start identifier. * (required at chapter start milestone)
A standard book + chapter scripture reference. Book names must be one of bookCode.
xsd:string of pattern [A-Z1-4]{3} ?[0-9]+

@eid

usx3.0 Chapter end identifier. * (required at chapter end milestone)
A standard book + chapter scripture reference. Book names must be one of bookCode.
xsd:string of pattern [A-Z1-4]{3} ?[0-9]+

Valid in

Chapter Content

Parent

<usx>

Diagram and Text Sample

_images/usx-element_chapterStart.png _images/usx-element_chapterEnd.png

Code examples for chapter and verse are provided after the definition for element verse (below).


<verse>

Note

Accurately identifying verse text within the scripture paragraph structure

usx3.0 USX 3.0 adds a pair of attributes to <verse/> (sid and eid) which are used to unambiguously identify the start and end position for a specific verse text within the scripture discourse structure. A companion attribute vid is added to <para> and <table> in order to re-identify the current verse when the previous <para> or <table> has closed prior the end of the verse text.

IMPORTANT: In USX 3.0 a <verse/> milestone is required at the start and at the end of the verse text, with corresponding sid and eid attributes. In previous versions of USX, only a <verse/> start milestone was required.

ico_See See: Background on chapter and verse as milestones

Element

verse *
empty

Added

1.0

Use

Marks the start of a new verse.

@style

Content type. *
v

@number

Current verse number (sequential; according to versification definition for the scripture text). *
xsd:string of pattern [0-9]+\w?(\u200F?[\-,][0-9]+\w?)*

@altnumber

Alternate verse number. (Used to supply the verse number for an alternate versification scheme. This is required when the numbering for an alternate versification tradition need to be maintained within the same translation text.)
xsd:string of pattern [0-9]+\w?(\u200F?[\-,][0-9]+\w?)*

@pubnumber

Published chapter character. (The chapter character(s) (a string - number, letter or both) which should be displayed in a published version of the scripture text, where the published chapter character is different than the sequential chapter number used within the translation editing environment, as defined by the project versification.)
xsd:string

@sid

usx3.0 Verse start identifier. * (required at verse start milestone)
A standard book + chapter + verse scripture reference. Book names must be one of bookCode. Chapter verse separator is always a colon (:).
xsd:string of pattern [A-Z1-4]{3} ?[a-z0-9\-,:]*

@eid

usx3.0 Verse end identifier. * (required at verse end milestone)
A standard book + chapter + verse scripture reference. Book names must be one of bookCode. Chapter verse separator is always a colon (:).
xsd:string of pattern [A-Z1-4]{3} ?[a-z0-9\-,:]*

Valid in

Chapter Content

Parents

<para>, <row>, <cell>

Diagram and Text Samples

_images/usx-element_verseStart.png _images/usx-element_verseEnd.png

chapter and verse - Genesis 1:21-25

<chapter number="1" style="c" sid="GEN 1" />
<para style="s">The Story of Creation</para>
...
<para style="p">
  <verse number="21" style="v" sid="GEN 2:21" />Then the <char style="nd">Lord</char> God
  made the man fall into a deep sleep, and while he was sleeping, he took out one of the
  man's ribs and closed up the flesh.<verse eid="GEN 2:21" />
  <verse number="22" style="v" sid="GEN 2:22" />He formed a woman out of the rib and brought
  her to him.<verse eid="GEN 2:22" />
  <verse number="23" style="v" sid="GEN 2:23" />Then the man said,
</para>
<para style="q1" vid="GEN 2:23">“At last, here is one of my own kind—</para>
<para style="q1" vid="GEN 2:23">Bone taken from my bone, and flesh from my flesh.</para>
<para style="q1" vid="GEN 2:23">‘Woman’ is her name because she was taken out of man.”
  <verse eid="GEN 2:23" />
</para>
<para style="m">
  <verse number="24" style="v" sid="GEN 2:24" />That is why a man leaves his father and mother
  and is united with his wife, and they become one.<verse eid="GEN 2:24" />
</para>
<para style="p">
  <verse number="25" style="v" sid="GEN 2:25" />The man and the woman were both naked, but
  they were not embarrassed.<verse eid="GEN 2:25" />
</para>
...
<chapter eid="GEN 1" />
<chapter number="2" style="c" sid="GEN 2" />

An additional six chapters appear interspersed in Esther in the Septuagint. There are 3 common approaches to handling the Greek additions (and many additional variations!). Although Paratext requires sequential chapter and verse numbers to be used within the translation editing environment – as defined by the project versification – in numerous places this is not the string to be published for the chapter and/or verse identifiers at these locations. Examples from Esther Greek are shown below to highlight the application of the @pubnumber attribute for chapter and verse.

The following example of the text for Esther Greek chapter 1 is taken from the English Good News Bible text. This text follows a versification scheme for Esther Greek which may be referred to as “modern scholars” configuration. Some versions following this scheme include English Good News, French La Bible en francais courant, and German Gute Nachricht Bible.

  • In the first portion of this example, you can see a chapter element with the sequential @number “1” which includes a @pubnumber “A”. The “A” should be presented to the reader.

  • In the second portion of this example, a para element with @style “cp” is found. Although a sequential chapter element is not present at this location, a chapter heading or other appropriate chapter style showing “1” should be presented to the reader.

  • In the second portion of this example you can also see verse elements with sequential @number “18-19”, “20”, “21”, “22”. The corresponding @pubnumber “1-2”, “3”, “4”, and “5” should be presented to the reader.

chapter and verse - ESG 1, showing chapter, @pubnumber A, and cp 1; verse 18-19 @pubnumber 1-2 etc.

<chapter number="1" style="c" pubnumber="A" sid="ESG 1" />
<para style="s">Mordecai's Strange Dream</para>
<para style="p">
<verse number="1-3" style="v" sid="ESG 1:1-3" />Mordecai, a Jew who belonged to the tribe of
  Benjamin, was taken into exile, along with King Jehoiachin of Judah, when King Nebuchadnezzar
  of Babylonia captured Jerusalem...<verse eid="ESG 1:1-3" /></para>

...

<para style="cp">1</para>
<para style="s">Queen Vashti Defies King Xerxes</para>
<para style="p">
  <verse number="18-19" style="v" pubnumber="1-2" sid="ESG 1:18-19" />These things happened
  in the time of King Xerxes, who ruled 127 provinces, all the way from India to Ethiopia,
  from his royal throne in Susa, Persia's capital city.<verse eid="ESG 1:18-19" />
  <verse number="20" style="v" pubnumber="3" sid="ESG 1:20" />In the third year of his reign,
  the king gave a banquet for all his advisers, the representatives of the other countries, the
  noblemen from Persia and Media, and the governors of the provinces.<verse eid="ESG 1:20" />
  <verse number="21" style="v" pubnumber="4" sid="ESG 1:21" />For six whole months he made a
  show of the riches of the imperial court with magnificent and expensive celebrations.
  <verse eid="ESG 1:21" />
</para>
<para style="p">
  <verse number="22" style="v" pubnumber="5" sid="1:22" />After the feast the king gave a banquet
  for the people of other nations who were in the city...<verse eid="ESG 1:22" />
</para>

...

The following example is taken from the English Contemporary English Version (CEV) text, which applies a different versification scheme to Esther Greek following the Vulgate. The NRSV Anglicised Edition is another example following this scheme.

chapter and verse - ESG 1, showing chapter 1 @pubnumber 11, cp 12, and 1; verse 1-3 @pubnumber 2-4, verse 4 @pubnumber 5, verse 12 @pubnumber 1 etc.

<chapter number="1" style="c" pubnumber="11" sid="ESG 1"/>
<para style="ms1">Addition A</para>
<para style="s1">Mordecai's Dream</para>
<para style="p">
  <verse number="1-3" style="v" pubnumber="2-4" sid="ESG 1:1-3" />Mordecai son of Jair was a Jew
  from the Benjamin tribe, and he lived in the city of Susa in Persia. Mordecai had been taken
  away from Jerusalem as a prisoner, when King Nebuchadnezzar of Babylonia had captured King
  Jehoiachin. ...</para>
<para style="p" vid="ESG 1:1-3">In Mordecai's dream,<verse eid="ESG 1:1-3" />
  <verse number="4" style="v" pubnumber="5" sid="ESG 1:4" /> there was confusion and unrest all
  over the world. He heard crashing thunder, and the earth shook with an earthquake
  <verse eid="ESG 1:4" /> <verse number="5" style="v" pubnumber="6" sid="ESG 1:5" />as two huge
  dragons went toward each other, ready to fight<verse eid="ESG 1:5" />...
</para>

...

  <verse number="11" style="v" pubnumber="12" sid="ESG 1:11" /> Mordecai woke up, but he knew
  that in his dream he had seen what God was planning to do. And so, Mordecai thought about
  his dream all day, trying to understand exactly what it meant.<verse eid="ESG 1:11" />
</para>
<para style="cp">12</para>
<para style="s1">Mordecai <optbreak /> Saves the King's Life</para>
<para style="p">
  <verse number="12" style="v" pubnumber="1" sid="ESG 1:12" />That night, Mordecai was in the
  palace courtyard. He was resting not far from Gabatha and Tharra, the two officers who were
  on guard duty.<verse eid="ESG 1:12" />
  <verse number="13" style="v" pubnumber="2" sid="ESG 1:13" /> Mordecai overheard them talking,
  and as he listened carefully, he realized they were planning to murder King Artaxerxes.
  <verse eid="ESG 1:13" />
</para>

...

<para style="ms1">End of Addition A</para>
<para style="cp">1</para>
<para style="s1">Queen Vashti Disobeys <optbreak /> King Artaxerxes</para>
<para style="p">
  <verse number="18-20" style="v" pubnumber="1-3" sid="ESG 1:18-20" />King Artaxerxes lived
  in his capital city of Susa and ruled 127 provinces from India to Ethiopia.
  <verse eid="ESG 1:18-20" />
</para>

An example from Psalms (modified French TOB) showing an alternate chapter and verse numbering scheme encoded within the text.

chapter and verse - PSA 42, showing chapter @altnumber and verse @altnumber

<chapter number="42" style="c" altnumber="41" sid="PSA 42"/>
<para style="ms1">DEUXIÈME LIVRE</para>
<para style="mr">(Ps 42–72)</para>
<para style="s1">PSAUME 42</para>
<para style="d">
<char style="va">1</char> Du chef de chœur. Instruction des fils de Coré.</para>
<para style="q1">
  <verse number="1" style="v" altnumber="2" sid="PSA 42:1" /> Comme une biche se
  tourne</para>
<para style="q1" vid="PSA 42:1">vers les cours d'eau,</para>
<para style="q1" vid="PSA 42:1">ainsi mon âme se tourne</para>
<para style="q1" vid="PSA 42:1">vers toi, mon Dieu.<verse eid="PSA 42:1" /></para>
<para style="q1">
<verse number="2" style="v" altnumber="3" sid="PSA 42:2" /> J'ai soif de Dieu,</para>
<para style="q1" vid="PSA 42:2">du Dieu vivant:</para>
<para style="q1" vid="PSA 42:2">Quand pourrai-je entrer</para>
<para style="q1" vid="PSA 42:2">et paraître face à Dieu?<verse eid="PSA 42:2" /></para>

<para>

Element

para
xsd:string

Added

1.0

Use

Paragraph content.

@style

Content type. *
Permitted values vary for each document division. The para @style types list presents an itemization of style values by category (paragraphs, poetry, titles etc.) and indicates the document divisions in which each type is valid.

@vid

usx3.0 Verse identifier.
Required to re-identify the current verse whenever the previous para or table closed prior the end of the current verse text.
A standard book + chapter + verse scripture reference. Book names must be one of bookCode. Chapter verse separator is always a colon (:).
xsd:string of pattern [A-Z1-4]{3} ?[a-z0-9\-,:]*

Valid in

Book Headers, Book Titles, Book Introduction, Book Introduction End Titles, Book Chapter Label, Chapter Content

Parents

<usx>

Diagram and Text Sample - Mark 1.1; Matthew 5.1,14-16 (GNT)

_images/usx-element_para.png
<para style="p">
  <verse number="1" style="v" sid="MRK 1:1" />This is the Good News about Jesus Christ, the Son
  of God.<verse eid="MRK 1:1"/> <verse number="2" style="v" sid="MRK 1:2" />It began as the prophet
  Isaiah had written:</para>
<para style="q1" vid="MRK 1:1">“God said, ‘I will send my messenger ahead of you</para>
<para style="q2" vid="MRK 1:1">to open the way for you.’</para>
<para style="q1">
  <verse number="3" style="v" sid="MRK 1:3" />Someone is shouting in the desert,</para>
<para style="q2" vid="MRK 1:3">‘Get the road ready for the Lord;</para>
<para style="q2" vid="MRK 1:3">make a straight path for him to travel!’”</para>

<para style="s">The Sermon on the Mount</para>
<para style="p">
  <verse number="1" style="v" sid="MAT 5:1" />Jesus saw the crowds and went up a hill, where he
  sat down. His disciples gathered around him,<verse eid="MAT 5:1" />
  <verse number="2" style="v" sid="MAT 5:2" />and he began to teach them:<verse eid="MAT 5:2" />
</para>
<para style="s">True Happiness</para>
<para style="r">(Luke 6.20-23)</para>
<para style="q1">
  <verse number="3" style="v" sid="MAT 5:3" />“Happy are those who know they are spiritually poor;
</para>
<para style="q2" vid="MAT 5:3" />the Kingdom of heaven belongs to them!<verse eid="MAT 5:3" /></para>
<para style="q1">
  <verse number="4" style="v" sid="MAT 5:4" />“Happy are those who mourn;</para>
<para style="q2" vid="MAT 5:4" />God will comfort them!<verse eid="MAT 5:4" /></para>

<table>

Element

table
empty

Added

1.0

Use

Contains <row> and <cell> child elements which compose the structure of a USX <table>. Tables are composed of a vertical sequence of one or more rows. Rows are composed of a horizontal sequence of one of more cells.

@vid

usx3.0 Verse identifier.
Required to re-identify the current verse when the previous para closed prior the end of the current verse text.
A standard book + chapter + verse scripture reference. Book names must be one of bookCode. Chapter verse separator is always a colon (:).
xsd:string of pattern [A-Z1-4]{3} ?[a-z0-9\-,:]*

Valid in

Book Introduction, Chapter Content

Parents

<usx>

Diagram

_images/usx-element_table.png

<row>

Element

row (* within <table>)
empty

Added

1.0

Use

Contains a horizontal sequence of table <cell> elements. The horizontal position of a table cell relates to its corresponding table column.

Valid in

Any valid <table>

Parents

<table>

Diagram

_images/usx-element_row.png

<cell>

Element

cell (* within <row>)
xsd:string

Added

1.0 (updated 3.0 - column spanning)

Use

Table cell content. Contains the cell text and and child elements.

@style

Cell column and alignment (legacy). *
th# | thr# | tc# | tcr#
The variable represents the table column number. See “About cell @style” note below.

@align

Cell alignment. *
start | center | end
Represents “left”, “center”, and “right” respectively in left-to-right direction texts, and “right”, “center”, “left” in right-to-left direction texts.

@colspan

usx3.0 An integer indicating how many columns the current cell should span in a rendered view.

Valid in

Any valid <row>

Parents

<row>

Note

Like the @style attribute applied to other USX elements, the cell @style value is a reference to the source text USFM marker in Paratext, from which USX encoded text is often derived. In USFM text, the table cell markers define the column to which they belong. The variable # represents the table column number. Strictly speaking @style is redundant information in USX. It is used by Paratext for round-tripping USX to USFM. In USX, the position of a <cell> in its sequence defines its respective column, and the @align attribute is the primary source of cell alignment information.

Diagram and Text Sample - NUM 2:3-9

_images/usx-element_cell.png
<table>
  <row style="tr">
    <cell style="th1" align="start">Tribe </cell>
    <cell style="th2" align="start">Leader </cell>
    <cell style="th3" align="start">Number</cell>
  </row>
  <row style="tr">
    <cell style="tc1" align="start">Judah </cell>
    <cell style="tc2" align="start">Nahshon son of Amminadab </cell>
    <cell style="tcr3" align="end">74,600</cell>
  </row>
  <row style="tr">
    <cell style="tc1" align="start">Issachar </cell>
    <cell style="tc2" align="start">Nethanel son of Zuar </cell>
    <cell style="tcr3" align="end">54,400</cell>
  </row>
  <row style="tr">
    <cell style="tc1" align="start">Zebulun </cell>
    <cell style="tc2" align="start">Eliab son of Helon </cell>
    <cell style="tcr3" align="end">57,400</cell>
  </row>
  <row style="tr">
    <cell style="tc1" colspan="2" align="end">Total: </cell>
    <cell style="tcr3" align="end">186,400</cell>
  </row>
</table>

<char>

Element

char
xsd:string

Added

1.0

Use

An element for marking character level content types within para, table cell and note elements.

@style

Content type. *
Permitted values vary for each document division. The char @style types list presents an itemization of style values by category and indicates the document divisions in which each type is valid.

@lemma

usx3.0 Valid when used together with selected @style types. ico_See See: @style w

@strong

usx3.0 Valid when used together with selected @style types. ico_See See: @style w

@srcloc

usx3.0 Valid when used together with selected @style types. ico_See See: @style w

@link-href

usx3.0 ico_See See: Linking Attributes

@link-title

usx3.0 ico_See See: Linking Attributes

@link-id

usx3.0 ico_See See: Linking Attributes

Valid in

Book Titles, Book Introduction, Book Introduction End Titles, Book Chapter Label, Chapter Content
A limited subset of @style types are valid within note (Footnote, CrossReference)

Parents

<para>, <cell>, <note>

Diagram and Text Sample - Genesis Introduction; 2.7; Mark 1.1 (GNT)

_images/usx-element_char.png
<para style="ip">The name <char style="bk">Genesis</char> means “origin.”

Then the <char style="nd">Lord</char> God took some soil from the ground and formed a man

<para style="p">
  <verse number="1" style="v" sid="MRK 1:1" />This is the Good News about Jesus Christ, the Son
  of God.<verse eid="MRK 1:1"/> <verse number="2" style="v" sid="MRK 1:2" />It began as the
  prophet Isaiah had written:</para>
<para style="q1" vid="MRK 1:1">
  <char style="qt">“God said, ‘I will send my messenger ahead of you</char></para>
<para style="q2" vid="MRK 1:1">
  <char style="qt">to open the way for you.’</char></para>
...

<ms>

usx3.0

USX 3.0 provides the <ms/> element for indicating the start and ending milestones for a span of text, where the boundaries of the content being marked may cross the boundary of a curently open paragraph (usually a <para> element).

An milestone type markup is required when a document has two or more structures that interact in a non-hierarchical manner. This is also referred to as overlapping or concurrent markup. A principle example of this type of overlapping structure in scripture text is the contrast between 1) the paragraph structures used to express the discourse / narrative of the text and 2) the division of the text into books, chapters and verses. In scripture texts encoded using USX (and similarly also in USFM), the paragraph level markup forms the main structure of the document, while chapter and verse markers are empty milestones which identify the location where the chapter or verse begins.

Another example of an overlapping structure exists when there is a need to indicate the start and end of the quotations of the “actors” who are speaking within the text. These spans of text will commonly cross paragraph boundaries.

Element

ms
empty
A milestone is always an empty element and should be written using the self-closing syntax, like <ms/>.

Added

3.0

Use

For indicating a specific milestone position within the text, or the start and ending milestones for a span of text, and where the boundaries of the content being marked may cross one or more paragraph boundaries.

@style

Milestone type. *
The ms @style types list presents an itemization of milestone styles in the current version of USX.

@sid

A unique identifier which can be used to unambiguously identify the starting milestone, and to clearly associate the starting milestone with the ending milestone (eid).
The sid can be composed of any mixture of numbers, letters, and underscores, and should be a unique sid throughout the scripture text.

@eid

A unique identifier which can be used to unambiguously identify the ending milestone, and to clearly associate the ending milestone with the starting milestone (sid).
If a sid attribute is used for the starting milestone in a milestone pair, the ending milestone must include eid.

Valid in

Book Titles, Book Introduction, Book Introduction End Titles, Book Chapter Label, Chapter Content

Parents

<para>, <cell>, <note>

Indicating Start and End Milestones

The style attribute for a milestone marker may end with either -s or -e.

  • -s indicates that the milestone is for marking the start of a span of text.

  • -e indicates that the milestone is an end milestone.

Standalone Milestones

Milestones do not need to occur in pairs or require the use of start -s and end -e @style attribute suffixes. The <ms/> element can also be used for a standalone milestone.

Example: Note use of the ‘z’ namespace in this example, which would be the USX representation for a user generated USFM milestone marker \zms\*)

<ms style="zms"/>

USX does not formally provide any specific standalone milestone types. This may change with future updates to USX 3.x, as use of milestones highlights specific needs.

Diagram and Text Sample - Act 17:22-31 (GNT)

_images/usx-element_para.png
<para style="p">
  <verse number="22" style="v" sid="ACT 17:22" />Paul stood up in front of the city council
  and said, <ms style="qt1-s" who="Paul"/>“I see that in every way you Athenians are very
  religious.<verse eid="ACT 17:22" />
  <verse number="23" style="v" sid="ACT 17:23" />For as I walked through your city ...
  ...
  <verse number="27" style="v" sid="ACT 17:27" />He did this so that they would look for him,
  and perhaps find him as they felt around for him. Yet God is actually not far from any one of us;
  <verse eid="ACT 17:27" /> <verse number="28" style="v"/>as someone has said,</para>
<para style="q1" vid="ACT 17:28" /><ms style="qt2-s" who="someone" />‘In him we live and move
  and exist.’<ms style="qt2-e" />
<para style="b" />
<para style="m" vid="ACT 17:28" />It is as some of your poets have said,</para>
<para style="q1" vid="ACT 17:28"><ms style="qt2-s" who="poets"/>‘We too are his children.’
  <ms style="qt2-e"/><verse eid="ACT 17:28" />
</para>
...
  <verse number="31" style="v" sid="ACT 17:31" />For he has fixed a day in which he will judge
  the whole world with justice by means of a man he has chosen. He has given proof of this to
  everyone by raising that man from death!”<ms style="qt1-e"/><verse eid="ACT 17:31" />
</para>

<note>

The USX note element is used to contain the content for any footnotes or cross references. Different note types are distinguished by the note @style attribute. The inner content for notes are marked using <char> with a specific subset of @style types for the current note type.

To help make things clear in this document, the markup for footnotes and cross references are described in separate sections because they use different <char> @style types within them.

Diagram

_images/usx-element_notef.png _images/usx-element_notex.png

ico_See See: <note> Types for detail.


<periph>

usx3.0

Element

periph
empty

Added

3.0

Use

Contains <para> (@style types Titles and Headings, Paragraphs, Poetry), <table>, <note>, and <char> elements to contain the content for a single peripheral content section.

@id

Used for identifying the specific peripheral division content found in the current file. *
One of the standard peripheral identifiers or a user defined peripheral identifier.

@alt

Provides an alternate title or identifier (possibly vernacular) for the peripheral content.

Valid in

Peripheral

Parents

<usx>

ico_See See: Peripherals for detail.


<figure>

Element

figure
xsd:string

Added

1.0

Use

Definition for an illustration which could be formatted at or near to this location in a publication.
The element’s text content is the caption for the illustration.
xsd:string

@style

Content type. *
fig

@alt

Illustration description. This text is not normally rendered within a publication.
xsd:string

@file

Illustration filename or URI. *
xsd:string | empty

@size

Illustration relative size. *
col | span | <user defined> xsd:string | empty
col - Illustration should be inserted inline within the space for the current text column.
span - Illustration should be inserted across (spanning) all text columns (i.e. the maximum available page or screen width).

@loc

Illustration location/range.
xsd:string

@copy

Copyright information.
xsd:string

@ref

Illustration reference. This text will commonly be rendered together with the illustration caption. * xsd:string

Valid in

Book Introduction, Chapter Content

Parents

<usx>

Diagram and Text Sample - Mark 1.18 (GNT)

_images/usx-element_figure.png
<figure style="fig" file="avnt016.jpg" size="span" ref="1.18">
        At once they left their nets.</figure>

<optbreak>

Element

optbreak
empty

Added

2.0

Use

Discretionary (optional) line break location.
Primarily used in poetic text, but could also be used for marking optional breaks for titles, headings, or table <cell> content.

Valid in

Book Titles, Book Introduction, Book Introduction End Titles, Book Chapter Label, Chapter Content

Parents

<para>, <cell>

Text Sample

<para style="s1">Jesus Heals a Man <optbreak /> Who Could Not Walk</para>

<ref>

Element

ref

Added

2.0

Use

Scripture reference.
When <ref> is used with a USX encoded text, each segment of a scripture reference should be wrapped in a <ref> element.
xsd:string

@loc

A parsable (machine-readable) representation of the vernacular text for the scripture reference. Book names must be one of bookCode. Chapter verse separator is always a colon (:).
xsd:string of pattern [A-Z1-4]{3} ?[a-z0-9\-,:]*

Valid in

Parents

Diagram and Text Sample

_images/usx-element_ref.png
<ref loc="MAT 3:1-4">Mt 3.1-4</ref>,<ref loc="MAT 3:7-13">7-13</ref>
<ref loc="MAT 3:4-4:5">Mt 3.4—4.5</ref>
<ref loc="LUK 3-5">Lk 3—5</ref>
<ref loc="MAT-LUK">Mt—Lk</ref>
<ref loc="MAT 3:4-5:6">Matthew 3.4—5.6</ref>; <ref loc="LUK 7">Luke 7</ref>

Sample Details

Example:

<char style="xt">Mt 3.4-5</char>

becomes:

<char style="xt"><ref loc="MAT 3:4-3:5">Mt 3.4-5</ref></char>

Comma-delimited verses and chapters are split up as much as possible:

Example:

Mt 3.4-5,6

becomes:

<ref loc="MAT 3:4-3:5">Mt 3.4-5</ref>,<ref loc="MAT 3:6">6</ref>

Example:

Mt 3.4-5.7

becomes:

<ref loc="MAT 3:4-5:7">Mt 3.4-5.7</ref>

Chapter ranges are acceptable:

Example:

Mt 3-5

becomes:

<ref loc="MAT 3-5">Mt 3-5</ref>

Book ranges are encoded as first reference only:

Example:

Mt-Lk

becomes:

<ref loc="MAT">Mt-Lk</ref>