<char> @style Types

Note

@style types for <char> elements occurring within <note>

An additional list of <char> @style types are defined for use in the context of footnotes and cross references. These are described in this document together with the definitions for the <note> elements used for footnotes and cross references.


Special Text

add

@style

add

Use

Translator’s addition.
Words added by the translator for clarity – text which is not literally a part of the original language, but which was supplied to make the meaning of the original clear.

Valid In

Any valid <char>

Formatting Sample - Genesis 5.29 (Russian Synodal, Protestant Version)

_images/usx-char-style_add.jpg

bk

@style

bk

Use

Quoted book title.

Valid In

Any valid <char>

Formatting Sample - Introduction to Mark (GNT)

_images/usx-char-style_bk.jpg

dc

@style

dc

Use

Deuterocanonical/LXX additions or insertions in the Protocanonical text.
General purpose use of <char> @style dc is encouraged wherever DC-only content is being marked. Use of context-specific DC-only markup (i.e. <char> @style fdc, or xdc) is discouraged.

Valid In

Any valid <char>

Text Samples - Hebrews 1.3 (Spanish DHE - footnote)

<verse number="3" style="v" sid="HEB 1:3" />Él es el resplandor glorioso de Dios,
<note caller="c" style="f">
        <char style="fr">1.3: </char>
        <char style="fk">Resplandor: </char>
        <char style="ft">Cf. Jn 1.4-9,14
        <char style="dc"> ; también Sab 7.25-26, donde algo parecido se dice de
        la sabiduría</char></char>
</note>

Psalm 115.3-4 (GNT - cross references)

<para style="q1">
        <verse number="3" style="v" sid="PSA 115:3" />Our God is in heaven;
</para>
<para style="q2" vid="PSA 115:3">he does whatever he wishes.<verse eid="PSA 115:3" /></para>
<para style="q1">
        <verse number="4" style="v" sid="PSA 115:3" />
        <note caller="-" style="x">
                <char style="xo">115.4-8: </char>
                <char style="xt">Ps 135.15-18;
                <char style="dc"> Ltj Jr 4-73;</char> Rev 9.20.</char>
        </note>Their gods are made of silver and gold,</para>
<para style="q2">formed by human hands.<verse eid="PSA 115:4" /></para>

1 Corinthians 15.51-52 (GNT - cross reference)

<para style="p">
        <verse number="51-52" style="v" sid="1CO 15:51-52" />
        <note caller="-" style="x">
                <char style="xo">15.51,52: </char>
                <char style="xt">
                <char style="dc">2Es 6.23; </char>
                1Th 4.15-17.
        </note>Listen to this secret truth: we shall not all die, but when the last trumpet sounds,
we shall all be changed in an instant, as quickly as the blinking of an eye. For when the trumpet
sounds, the dead will be raised, never to die again, and we shall all be changed.

ior

@style

ior

Use

Introduction outline reference range.
An introduction outline entry typically ends with a range of references, sometimes within parentheses. This is an optional char style for marking these references separately.

Valid In

Book Introduction

Formatting Sample - Introduction to Mark (CEV)

_images/usx-char-style_ior.jpg

iqt

@style

iqt

Use

Introduction quoted text.
Scripture quotations, or other quoted text, appearing in the Book Introduction.

Valid In

Book Introduction


k

@style

k

Use

Keyword / keyterm.

Valid In

Any valid <char>


litl

usx3.0

@style

litl

Added

3.0

Use

List entry total.
Use in “accounting” lists for denoting the total component of the text within a list item (<para> @style li). An alternative to using table for the same content.

Valid In

Any valid <char> within <para> @style li#

Text and Formatting Sample - Nehemiah 7.6-14 (GNT - markup adapted)

<para style="pm"><verse number="6" style="v" sid="NEH 7:6" />These are the people of the province
  who came up from the captivity of the exiles whom Nebuchadnezzar king of Babylon had taken
  captive (they returned to Jerusalem and Judah, each to his own town,<verse eid="NEH 7:6" />
  <verse number="7" style="v" sid="NEH 7:7" />in company with Zerubbabel, Jeshua, Nehemiah,
  Azariah, Raamiah, Nahamani, Mordecai, Bilshan, Mispereth, Bigvai, Nehum and Baanah):
</para>
<para style="b" />
<para style="pm" vid="NEH 7:7">The list of the men of Israel:<verse eid="NEH 7:7" />
<para style="b" />
<para style="lim1"><verse number="8" style="v" sid="NEH 7:8" />the descendants of Parosh -
  <char style="litl">2,172</char><verse eid="NEH 7:8" />
</para>
<para style="lim1"><verse number="9" style="v" sid="NEH 7:9" />of Shephatiah -
  <char style="litl">372</char><verse eid="NEH 7:9" />
</para>
<para style="lim1"><verse number="10" style="v" sid="NEH 7:10" />of Arah -
  <char style="litl">652</char><verse eid="NEH 7:10" />
</para>
<para style="lim1"><verse number="11" style="v" sid="NEH 7:11" />of Pahath-Moab (through the
  line of Jeshua and Joab) - <char style="litl">2,818</char><verse eid="NEH 7:11" />
</para>
<para style="lim1"><verse number="12" style="v" sid="NEH 7:12" />of Elam -
  <char style="litl">1,254</char><verse eid="NEH 7:12" />
</para>
<para style="lim1"><verse number="13" style="v" sid="NEH 7:13" />of Zattu -
  <char style="litl">845</char><verse eid="NEH 7:13" />
</para>
<para style="lim1"><verse number="14" style="v" sid="NEH 7:14" />of Zaccai -
  <char style="litl">760</char><verse eid="NEH 7:14" />
</para>
...
_images/usx-char-style_litl.jpg

nd

@style

nd

Use

Name of God (name of deity).

Valid In

Any valid <char>

Formatting Sample - Exodus 3.15 (GNT)

_images/usx-char-style_nd.jpg

ord

@style

ord

Use

Ordinal number ending (i.e. in 1st — 1<char style="ord">st</char>).

Valid In

Any valid <char>


pn

@style

pn

Use

Proper name.

Valid In

Any valid <char>


png

usx3.0

@style

png

Added

3.0

Use

Geographic proper name.
Particularly in China, there are various groups which have the practice of distinguishing visually between proper names of people and proper names of geographic places in published texts. Published materials may use a single underline to present proper names of people, and double underline to present proper names of geographic places. Alternatively, dotted underlines have been used for geographic proper names.

Special presentation for names can assist readers to know what the text means, especially readers who may struggle with reading skills and may be overloaded by the transliterated names.

Valid In

Any valid <char>


qac

@style

qac

Use

Used to indicate the acrostic letter within a poetic line.

Valid In

Any valid <char>

Formatting Sample - Lamentations 1.1,2 (Spanish TLA)

_images/usx-char-style_qac.jpg

qs

@style

qs

Use

Used for the expression “Selah” commonly found in Psalms and Habakkuk.
This text is frequently right aligned, and rendered on the same line as the previous poetic text, if space allows.

Valid In

Any valid <char>

Formatting Sample - Psalm 3.2 (NRSV)

_images/usx-char-style_qs.jpg

qt

@style

qt

Use

Quoted text.
Old Testament quotations in the New Testament, or other quotations.

Valid In

Any valid <char>

Formatting Sample - Mark 1.2-3 (GNT)

_images/usx-char-style_qt.jpg

rq

@style

rq

Use

Inline quotation reference(s).
A reference indicating the source text for the preceding quotation (usually an Old Testament quote).
The reference(s) are intended to be formatted within the scripture body text column, and not extracted from the text as are regular cross-references. They are also typically separated from the main text of Scripture using a different type style and alignment.

Valid In

Any valid <char>

Formatting Sample - Hebrews 1.5 (GNT)

_images/usx-char-style_rq.jpg

sig

@style

sig

Use

Signature of the author of an epistle.

Valid In

Any valid <char>

Formatting Sample - Colossians 4.18 (GNT)

_images/usx-char-style_sig.jpg

sls

@style

sls

Use

Passage of text based on a secondary language or alternate text source.
For example: The Nouvelle Bible Segond 2002 (NBS02) has large sections of text in EZR and DAN in italics, to represent where the original text is in Aramaic, not Hebrew.

Valid In

Any valid <char>

Formatting Sample - Ezra 4.8—6.18 (NBS - French, Nouvelle Bible Segond)

_images/usx-char-style_sls.jpg

tl

@style

tl

Use

Transliterated (or foreign) word(s).

Valid In

Any valid <char>

Formatting Sample - Matthew 27.46 (GNT)

_images/usx-char-style_tl.jpg

wj

@style

wj

Use

Words of Jesus.

Valid In

Any valid <char>


Character Styling

em

@style

em

Use

Emphasis text.

Valid In

Any valid <char>


bd

@style

bd

Use

Bold text.

Valid In

Any valid <char>


bdit

@style

bdit

Use

Bold + Italic text.

Valid In

Any valid <char>


it

@style

it

Use

Italic text.

Valid In

Any valid <char>


no

@style

no

Use

Normal text.
May be used when a containing paragraph element may be set in an alternate font style (e.g. italic), and a selection of text should instead be displayed in normal style.

Valid In

Any valid <char>


sc

@style

sc

Use

Small-cap text.

Valid In

Any valid <char>


sup

@style

sup

Use

Superscript text. Typically for use in critical edition footnotes.

Valid In

Any valid <char>


Spacing and Breaks

Discretionary (optional) line break location. See element optbreak.


Special Features

rb

usx3.0

@style

rb

Added

3.0

Use

Ruby glossing.
Used to mark the base text being annotated with ruby characters.

Valid In

Any valid <char>

Note

About Ruby ico_See See: https://www.w3.org/TR/ruby/

Han characters: Chinese, Japanese, and Korean texts have some characters that they share in common. In Japanese these are called Kanji (literally “Han characters”). There are several thousand of these characters to learn. For new readers or readers new to the Biblical texts it may be very difficult for them to recognize what Chinese or Japanese word corresponds to the Han character(s) they are seeing.

Ruby glosses: In order to help these readers, some Bibles are printed with glosses using small phonetic characters (e.g. Japanese uses the hiragana alphabet) placed above the more symbolic Han characters to tell the reader how to pronounce the character. These phonetic characters are generically called “ruby glosses” or “rubies”. In Japanese this technique is called Furigana.

Attributes ico_Tag

usx3.0

Additional attributes for <char> which can be used in this context.

@gloss

Ruby glosses
Use a colon : to separate multiple elements for glossing each of the characters within a base text phrase.

For example: If the base text being glossed is a phrase of two Han characters (B), then the ruby gloss text (gg) may contain two elements, one for glossing each of the base text characters making up the phrase.

<char style="rb" gloss="gg:gg">BB</char>

This syntax allows the decision to present glosses by phrase or by group to be made at the publication stage, rather than pre-determined during translation.

Parts of a phrase gloss may be left empty. In the example phrase below the second and fourth base characters are unglossed:

<char style="rb" gloss="g1::g3:">BBBB</char>

Text and Formatting Samples

  1. One Han character with a single ruby gloss.

<char style="rb" gloss="あい"></char>
  1. Two Han characters with a single ruby phrase gloss

<char style="rb" gloss="はなはなし">話賄</char>
  1. Phrase gloss broken down into individual pieces by adding colons between ruby characters

<char style="rb" gloss="はな:はなし">話賄</char>
  1. A character sequence which includes non-Han characters (hiragana), which are NOT glossed.

<char style="rb" gloss="さだ:">定ま</char>
  1. An un-glossed character occurring between glossed characters in the “phrase”.

<char style="rb" gloss="かみ::こ">神の子</char>

Genesis 1.1-2 (Japanese Contemporary Bible - Biblica)

<para style="p">
  <verse number="1" style="v" sid="GEN 1:1" />まだ<char style="rb" gloss="なに"></char>
  もなかった<char style="rb" gloss="とき"></char><char style="rb" gloss="かみ"></char><char style="rb" gloss="てん"></char><char style="rb" gloss="ち"></char><char style="rb" gloss="つく"></char>りました。<verse eid="GEN 1:1" />
  <verse number="2" style="v" sid="GEN 1:2" /><char style="rb" gloss="ち"></char><char style="rb" gloss="かたち"></char><char style="rb" gloss="さだ"></char>まらず、
  <char style="rb" gloss="やみ"></char><char style="rb" gloss="つつ"></char>まれた
  <char style="rb" gloss="みず"></char><char style="rb" gloss="うえ"></char>を、さらに
  <char style="rb" gloss="かみ"></char><char style="rb" gloss="れい"></char><char style="rb" gloss="おお"></char>っていました。<verse eid="GEN 1:2" /></para>
_images/usx-char-style_rb.jpg

pro

@style

pro

Deprecated

3.0 usx3.0

Use

Pronunciation information
Used for CJK texts.
Deprecated (use is discouraged)

ico_Cg Recommended alternate: char@style rb.

Valid In

Any valid <char>


w

@style

w

Use

Wordlist/glossary/dictionary entry.
Surround word(s) with this char style to indicate that it appears (or should appear) in a published word list/glossary.

Valid In

Any valid <char>

Attributes ico_Tag

usx3.0

Additional attributes for <char> which can be used in this context.

@lemma

Citation form for the term in the glossary

<char style="w" lemma="grace">gracious</char>
@strong

Strong’s ID in the form H##### (Hebrew) or G##### (Greek)

A strong’s ID augmentation identifier, if required, should be separated from the strong value by a colon :

<char style="w" lemma="grace" strong="G05485">gracious</char>
<char style="w" strong="G05485">gracious</char>
<char style="w" strong="H01234,G05485">gracious</char>

<char style="w" strong="G05485:a">gracious</char>
@srcloc

Location of the word in the source text; Example: GNT version 5 text, book 51, chapter 1, verse 2, word 1.

<char style="w" lemma="grace" srcloc="gnt5:51.1.2.1">gracious</char>

wg

@style

wg

Use

Greek word list entry.

Valid In

Any valid <char>


wh

@style

wh

Use

Hebrew word list entry.

Valid In

Any valid <char>


wa

usx3.0

@style

wa

Added

3.0

Use

Aramaic word list entry.

Valid In

Any valid <char>


Structured List Entries

usx3.0

Standard USX table structures can be challenging to display on small page sizes, or digital device displays. Scripture content is sometimes encoded within a USX table in order to suggest a meaningful presentation, but the encoded presentation may only be rendered accurately or legibly in a larger format. The following <char> @style types can be used to create structured list entries which identify a set of related content, but do not encode a specific presentation.

Note

Structured lists are not strictly a replacement for table markup, but may prove to be a more flexible option for some types of tabular content.

<char> @style types lik and liv# mark the content of list entries (<para> @style li#) which are essentially a key + value pair. A key may have multiple values.


lik

usx3.0

@style

lik

Added

3.0

Use

List entry “key” content.

Valid In

Any valid <char> within <para> @style li#


liv#

usx3.0

@style

liv#

Added

3.0

Use

List entry “value” content.
The variable # represents the sequence of the marked item in a list entry with multiple values.
liv = liv1 (see notes on numbered @style attributes)

Valid In

Any valid <char> within <para> @style li#

Text and Formatting Sample - 1 Chronicles 27:16-22 (GNT - markup adapted)

<para style="s1">Administration of the Tribes of Israel</para>
<para style="lh"><verse number="16-22" style="v" sid="1CH 27:16-22"/>This is the list of
  the administrators of the tribes of Israel:</para>
<para style="li1">
  <char style="lik">Reuben</char> <char style="liv1">Eliezer son of Zichri</char></para>
<para style="li1">
  <char style="lik">Simeon</char> <char style="liv1">Shephatiah son of Maacah</char></para>
<para style="li1">
  <char style="lik">Levi</char> <char style="liv1">Hashabiah son of Kemuel</char></para>
<para style="li1">
  <char style="lik">Aaron</char> <char style="liv1">Zadok</char></para>
<para style="li1">
  <char style="lik">Judah</char> <char style="liv1">Elihu, one of King David's brothers</char>
</para>
<para style="li1">
  <char style="lik">Issachar</char> <char style="liv1">Omri son of Michael</char></para>
<para style="li1">
  <char style="lik">Zebulun</char> <char style="liv1">Ishmaiah son of Obadiah</char></para>
<para style="li1">
  <char style="lik">Naphtali</char> <char style="liv1">Jeremoth son of Azriel</char></para>
<para style="li1">
  <char style="lik">Ephraim</char> <char style="liv1">Hoshea son of Azaziah</char></para>
<para style="li1">
  <char style="lik">West Manasseh</char> <char style="liv1">Joel son of Pedaiah</char></para>
<para style="li1">
  <char style="lik">East Manasseh</char> <char style="liv1">Iddo son of Zechariah</char></para>
<para style="li1">
  <char style="lik">Benjamin</char> <char style="liv1">Jaasiel son of Abner</char></para>
<para style="li1">
  <char style="lik">Dan</char> <char style="liv1">Azarel son of Jeroham</char></para>
<para style="lf">This was the list of the administrators of the tribes of Israel.
  <verse eid="1CH 27:16-22" /></para>
_images/usx-char-style_lik_liv.jpg

Linking

jmp

usx3.0

@style

jmp

Added

3.0

Use

Available for associating linking attributes to a span of text when no other <char> element is already applied to the text at this location.

Valid In

Any valid <char>

ico_See See: Linking Attributes.