<para> @style Types


Note

Numbered <para> @style Attributes

Some @style attributes include an optional numeric variable, which is represented in this documentation by a hash character (#). In USX the attribute number indicates:

  • A portion of a complete element, or relative weighting of the “pieces” of the elements, such as mt1, mt2, mt3 which are all parts of a major title.
  • The level of division (hierarchy).
  • The level of indentation relative to other like elements, as in poetry (q#) or lists (li#) or outlines (io#).

style = style1 — The unnumbered version of a style attribute may be used when only one level of this paragraph style exists within the project text. Numbers should always be included when more than one level of the paragraph style exists within the project text.

Identification


@style:

h

Use:

Running header text.

Valid In:

Book Header

_images/usx-para-style_h.jpg

@style:toc1
Use:Long table of contents text.
Valid In:Book Header

@style:toc2
Use:Short table of contents text.
Valid In:Book Header

@style:toc3
Use:Book abbreviation.
Valid In:Book Header

Note

About toc1, toc2, toc3

The metadata.xml file within a DBL text release bundle contains a bookNames element in which each scripture book is itemized together with child elements for its long, short and abbreviated forms. The bookNames element is the key location where this book naming metadata is contained within the bundle. USX para elements with attributes toc1, toc2, or toc3 are strictly optional data. Their presence in a USX file is valid, but reflects a legacy form of USFM markup in which the USFM files for each book were the key location for this book naming metadata.

Introductions


@style:

imt#

Use:

Introduction major title.
# denotes the title level or relative weighting.
imt = imt1 (see notes on numbered @style attributes)

Valid In:

Book Introduction

_images/usx-para-style_imt.jpg

@style:

is#

Use:

Introduction section heading.
# denotes the title level or relative weighting.
is = is1 (see notes on numbered @style attributes)

Valid In:

Book Introduction

_images/usx-para-style_is.jpg

@style:

ip

Use:

Introduction paragraph.

Valid In:

Book Introduction

_images/usx-para-style_ip.jpg

@style:

ipi

Use:

Indented introduction paragraph.

Valid In:

Book Introduction

_images/usx-para-style_ipi.jpg

@style:

im

Use:

Introduction flush left (margin) paragraph.

Valid In:

Book Introduction

_images/usx-para-style_im.jpg

@style:

imi

Use:

Indented introduction flush left (margin) paragraph.

Valid In:

Book Introduction

_images/usx-para-style_imi.jpg

@style:

ipq

Use:

Introduction quote from scripture text paragraph.

Valid In:

Book Introduction

_images/usx-para-style_ipq.jpg

@style:

imq

Use:

Introduction flush left (margin) quote from scripture text paragraph.

Valid In:

Book Introduction

_images/usx-para-style_imq.jpg

@style:

ipr

Use:

Introduction right-aligned paragraph.
Typically used for the reference for a quote from the scripture text (imq, ipq)

Valid In:

Book Introduction

_images/usx-para-style_ipr.jpg

@style:

iq#

Use:

Introduction poetic line.
# represents the level of indent (i.e. iq1, iq2, iq3 etc.)
iq = iq1 (see notes on numbered @style attributes)

Valid In:

Book Introduction

_images/usx-para-style_iq.jpg

@style:ib
Use:Introduction blank line.
May be used to explicitly indicate additional white space between paragraphs.
Valid In:Book Introduction

@style:

ili#

Use:

Introduction list item.
# represents the level of indent
ili = ili1 (see notes on numbered @style attributes)

Valid In:

Book Introduction

_images/usx-para-style_ili.jpg

@style:iot
Use:Introduction outline title. (see io# below)
Valid In:Book Introduction

@style:

io#

Use:

Introduction outline entry.
The outline entry typically ends with a range of references in parentheses.
References may be marked with char @style ior.
# represents the outline (indent) level. io = io1 (see notes on numbered @style attributes)

Valid In:

Book Introduction

_images/usx-para-style_io.jpg

@style:ior
See:char @style ior

@style:iex
Use:Introduction explanatory or bridge text (e.g. explanation of missing book in a short Old Testament).
This para @style is used within Chapter Text.
Valid In:Book Introduction

@style:iqt
See:char @style iqt

@style:imt#
Use:Introduction major title ending.
Used to mark a major title indicating the end of the introduction.
# represents a portion of the title, with the lesser emphasis (relative weighting) being on the higher numbers.
imte = imte1 (see notes on numbered @style attributes)
Valid In:Book Introduction

@style:ie
Use:Introduction end.
Optionally included to explicitly indicate the end of the introduction material.
Valid In:Book Introduction

Titles and Headings


@style:

mt#

Use:

Main title.
Key components in the title of a biblical book.
# represents a portion of the title, with the lesser emphasis (relative weighting) being on the higher numbers.
mt = mt1 (see notes on numbered @style attributes)

Valid In:

Book Titles

_images/usx-para-style_mt.jpg


_images/usx-para-style_mtAlt.jpg

@style:mte#
Use:Main title at introduction ending.
May be used in texts which repeat the main title at the end of the introduction.
Valid In:Book Introduction

@style:

ms#

Use:

Major section heading. A heading added before a broader text division than what is typically considered a “section” division (see s#).
# represents the level of division.
ms = ms1 (see notes on numbered @style attributes)

Valid In:

Chapter Text

_images/usx-para-style_ms.jpg


_images/usx-para-style_msAlt.jpg

@style:

mr

Use:

Major section reference range.
The text reference range listed under a major section heading.

Valid In:

Chapter Text

_images/usx-para-style_mr.jpg

@style:

s#

Use:

Section heading.
The typical (common) section division heading.
# represents the level of division.
s = s1 (see notes on numbered @style attributes)

Valid In:

Chapter Text

s1 example

_images/usx-para-style_s1.jpg


s2 example

_images/usx-para-style_s2.jpg

@style:

sr

Use:

Section reference range.
The text reference range listed under a section heading.
sr is not equivalent to r which is used for marking parallel references.

See also:

mr

Valid In:

Chapter Text

_images/usx-para-style_sr.jpg

@style:

r

Use:

Parallel passage reference(s).
A reference to a parallel passage usually located under a section heading s#.

See also:

char @style rq.

Valid In:

Chapter Text

_images/usx-para-style_r.jpg

@style:

d

Use:

Descriptive title (or “Hebrew subtitle”).
Sometimes used in Psalms under the section title (e.g. “For the director of Music”).

Valid In:

Chapter Text

_images/usx-para-style_d.jpg

@style:

sp

Use:

Speaker identification (e.g. Job and Song of Songs).

Valid In:

Chapter Text

_images/usx-para-style_sp.jpg

Paragraphs


@style:

p

Use:

Normal paragraph.

Valid In:

Chapter Text

_images/usx-para-style_p.jpg

@style:

m

Use:

Margin paragraph.
Typically used to resume prose at the margin (without indent) after poetry or OT quotation (i.e. a continuation of the previous paragraph).

Valid In:

Chapter Text

_images/usx-para-style_m.jpg

@style:

pmo

Use:

Embedded text opening.

Valid In:

Chapter Text

_images/usx-para-style_pmo.jpg

@style:

pm

Use:

Embedded text paragraph.

Valid In:

Chapter Text

_images/usx-para-style_pm.jpg

@style:

pmc

Use:

Embedded text closing.

Valid In:

Chapter Text

_images/usx-para-style_pmc.jpg

@style:

pmr

Use:

Embedded text refrain.

Valid In:

Chapter Text

_images/usx-para-style_pmr.jpg

@style:

pi#

Use:

Indented paragraph.
Used in some texts for discourse sections.
# represents the level of indent.
pi = pi1 (see notes on numbered @style attributes)

See also:

pm

Valid In:

Chapter Text

_images/usx-para-style_pi.jpg

@style:

mi

Use:

Indented flush left paragraph

Valid In:

Chapter Text

_images/usx-para-style_mi.jpg

@style:

cls

Use:

Closure of an epistle / letter

Valid In:

Chapter Text

_images/usx-para-style_cls.jpg

@style:

li#

Use:

List item (out-dented paragraph meant to highlight the items of a list.).
# represents the level of indent
li = li1 (see notes on numbered @style attributes)

Valid In:

Chapter Text

_images/usx-para-style_li.jpg

@style:

pc

Use:

Centered paragraph

Valid In:

Chapter Text

_images/usx-para-style_pc.jpg

@style:pr
Use:Right-aligned paragraph

ico_W Use is strongly discouraged.
ico_Cg Recommended alternate is pmr
Valid In:Chapter Text

@style:ph#
Use:Indented paragraph with hanging indent.
# represents the level of indent
ph = ph1 (see notes on numbered @style attributes)

ico_W Use is strongly discouraged.
ico_Cg Recommended alternate is li#
Valid In:Chapter Text

@style:

lit

Use:

Liturgical note/comment. (e.g. a guide which tells the reader/worshiper that he/she should recite a prayer or recitation etc.)
In the formatting example image (below) the word Слава = “Glory”

Valid In:

Chapter Text

_images/usx-para-style_lit.jpg

Poetry


@style:

q#

Use:

Poetic line.
# represents the level of indent (i.e. q1, q2, q3 etc.). q = q1 (see notes on numbered @style attributes)

Valid In:

Chapter Text

_images/usx-para-style_q1.jpg


_images/usx-para-style_q2.jpg

@style:

qr

Use:

Right-aligned poetic line.
ico_Cg Common use: Poetic refrain

Valid In:

Chapter Text

_images/usx-para-style_qr.jpg

@style:

qc

Use:

Centered poetic line.

Valid In:

Chapter Text

_images/usx-para-style_qc.jpg

@style:

qa

Use:

Acrostic heading.

Valid In:

Chapter Text

_images/usx-para-style_qa.jpg

@style:qac
See:char @style qac

@style:

qm#

Use:

Embedded text poetic line.
# represents the level of indent (i.e. qm1, qm2, etc.).
qm = qm1 (see notes on numbered @style attributes)

Valid In:

Chapter Text

_images/usx-para-style_qm.jpg

@style:qs
See:char @style qs

@style:

b

Use:

Blank line.
May be used to explicitly indicate additional white space between paragraphs.

ico_W A para element with b style type should always be empty.
b should not be used before or after titles to indicate white-space.

Valid In:

Chapter Text

_images/usx-para-style_b.jpg


_images/usx-para-style_bAlt.jpg