<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)
bk¶
- @style
bk
- Use
Quoted book title.
- Valid In
Any valid <char>
Formatting Sample - Introduction to Mark (GNT)
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
Formatting Sample - Introduction to Mark (CEV)
iqt¶
- @style
iqt
- Use
Introduction quoted text.
Scripture quotations, or other quoted text, appearing in the Book Introduction.- Valid In
litl¶
- @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
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>
...
nd¶
- @style
nd
- Use
Name of God (name of deity).
- Valid In
Any valid <char>
Formatting Sample - Exodus 3.15 (GNT)
ord¶
- @style
ord
- Use
Ordinal number ending (i.e. in 1st —
1<char style="ord">st</char>
).- Valid In
Any valid <char>
png¶
- @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)
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)
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)
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)
sig¶
- @style
sig
- Use
Signature of the author of an epistle.
- Valid In
Any valid <char>
Formatting Sample - Colossians 4.18 (GNT)
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)
Character Styling¶
Special Features¶
rb¶
- @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 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.
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
One Han character with a single ruby gloss.
<char style="rb" gloss="あい">哀</char>
Two Han characters with a single ruby phrase gloss
<char style="rb" gloss="はなはなし">話賄</char>
Phrase gloss broken down into individual pieces by adding colons between ruby characters
<char style="rb" gloss="はな:はなし">話賄</char>
A character sequence which includes non-Han characters (hiragana), which are NOT glossed.
<char style="rb" gloss="さだ:">定ま</char>
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>
pro¶
- @style
pro
- Deprecated
3.0
- Use
Pronunciation information
Used for CJK texts.
Deprecated (use is discouraged)
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>
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) orG#####
(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>
Structured List Entries¶
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.
liv#¶
- @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
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>
Linking¶
jmp¶
- @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>
See: Linking Attributes.