Information about a section, or a short summary, may follow a heading, as in this example. Such paragraphs should be formatted with the SectionInfo paragraph style. Note that the information below is from an early version of ThML and should not be used as a reference.
Character styles are similar to paragraph styles, except that they only contain character formatting and they may occur within a paragraph style. The character styles used for ThML are "Name", and "Default". Keyboard shortcuts have been provided for certain common paragraph and character styles:
", "", "
Style Name | Shortcut Keys | Description |
P | ctrl-alt-p | Normal paragraph |
P_First | ctrl-alt-r | First paragraph of section |
Comment (character) | ctrl-alt-c | Comment -- ignored |
Default (character) | ctrl-alt-d | Default paragraph font |
Heading 1 | ctrl-alt-1 | Level-1 heading |
Heading 2 | ctrl-alt-2 | Level-2 heading |
HTML (character) | ctrl-alt-h | HTML (or XML) markup |
Name (character) | ctrl-alt-n | A person's name |
Verse | ctrl-alt-v | Poetry, verse, etc. |
XML | ctrl-alt-x | XML (or HTML) markup |
When markup requires attributes (e.g. lang="el"),
paragraph styles are not sufficient, and XML or HTML tags are used. The markup may
consist of opening and closing tags with attributes, surrounding some text, as
for example
The BlockQuote paragraph style should be used for extended quotations. A BlockQuote paragraph is normally indented on both sides. There is also some extra space before and after a BlockQuote paragraph.
The XML notation for notes uses the <note> element, following the syntax used by TEI Lite1 [e.g. . The 2
Plain, numbered, or bulleted lists with several levels of indent may be represented with Word styles List, List 2, List 3, List 4 for the plain version; List Bullet, List Bullet 2, …; List Number, List Number 2, etc. There are also styles called List Continue, List Continue 2, …, used for additional paragraphs of a list entry. The plain or list is converted to the HTML elements <UL> and <LI>, and the numbered list to <OL> and <LI>.
This is a plain list with
one
one-a
one-b
two
three entries.
· This is a bullet list with
· one
· one-a
· one-b
· two
· three entries and a
continued entry.
1. This is a numbered list with
1. one
1. one-a
2. one-b
2. two
3. three entries and a
continued entry.
Some documents contain a glossary. It should be surrounded by <glossary> tags, and individual terms and definitions should use paragraph styles called Term and Definition. These are converted to the HTML elements <dl>, <dt>, and <dd>.
Theological books often contain verse -- poetry, hymns, or versified presentation of material such as the Psalms. Verse is often typeset with varying levels of indentation. These are represented with Verse 1, Verse 2, and Verse 3 paragraph styles. In the example below, the first and third line of each stanza is of style Verse 1, the second Verse 2, and the fourth Verse 3.
O God, a world of empty show,
Dark wilds of restless, fruitless quest
Lie round me wheresoe'er I go:
Within, with Thee, is rest.
And sated with the weary sum
Of all men think, and hear, and see,
O more than mother's heart, I come,
A tired child to Thee.
Sweet childhood of eternal life!
Whilst troubled days and years go by,
In stillness hushed from stir and strife,
Within Thine Arms I lie.
Thine Arms, to whom I turn and cling
With thirsting soul that longs for Thee;
As rain that makes the pastures sing,
Art Thou, my God, to me.
G. Ter Steegen
Let's also try some versey
Which may be rather tersey,
But has scripRef and index
For anyone who inspects
Attributions to authors, of poetry or letters for example, may be given the Attribution paragraph style, as in the "G. Ter Steegen" attribution in the poem above. These are by default rendered as right-justified, italic text. Names that occur in text may be given the Name character style. (You can also use the name attribute in order to give the standard form of a name: Mr. Smith. Citations to other books, such as The Imitation of Christ, may be formatted with the Citation paragraph style, and dates, such as last Christmas may be marked as shown. Here is unclear sentence.
In theological texts, scripture passages may be cited, quoted, or explained. Citations refer to a passage, but quotes include the text of a passage in the document. References may occur in footnotes3, in parentheses (Phil. 2:1-11), or in the text itself -- see Rom. 8:28. Context may be needed in order to interpret a reference -- see verse 29 and 10:8-13. Several passages may be stacked together in one citation (Matt. 5:44, 46; Luke 7:42; John 5:42, 13:35, 14:15, 23; 15:12-13; 21:15-16). For marking scripture citations, ThML will use the scripRef element, as in this example:
<scripContext version="NIV" passage="Romans 8" /> element is used to set the default context for the parser, and the <scripParseOff /> and <scripParseOn /> elements may be used to turn the parser off or on, to prevent linking of a passage such as "Bob had 2 apples and John 3." The version attribute may be set in a scripContext element but it is never set by the parser.
In theological texts, scripture is also sometimes quoted. In this case, it is not desirable to link the reference to the scripture passage, but it may be desirable to incorporate the passage into a table of scripture references. Quotations of scripture may be marked with the scripture element. A passage may be represented as in this example:
Explanation or commentary on a passage will be marked with the scripCom tag, as in this example:
<scripCom type="Commentary" passage="Mark 7:16"/>Mark 7:16. This admonition seems to apply to most everyone . . .
Passages in the text may be marked for insertion into an index using the <index/> element. For example, one might mark a passage for inclusion in a subject index this way:
The primary language for a document is specified in the header. Passages in other languages may be marked with the foreign tag and the lang attribute. For example, the Greek passage <foreign lang="el">logos</foreign> may be marked as shown. "lang" attribute values are as specified in ISO 639.4 Some examples are Dutch: nl, English: en, French: fr, German: de, Greek: el, Hebrew: he, Latin: la, Spanish: es, Portuguese: pt, Russian: ru.
If the language
uses characters not available in the ISO-8859-1 (Latin-1) character set, they
may be represented with the Latin-1 character set using an appropriate font.
The Greek and Hebrew fonts used for the CCEL are the excellent, freeware SIL
Galatia and SIL Ezra fonts and related software from the Summer Institute of Linguistics5, used here in a Greek example (
Hypertext Links can be inserted using the Microsoft Word link facility, perhaps using the ctrl-k shortcut. Links can be either HTML or XML format. This is an example of a link to the CCEL.
Horizontal rules that span 30% of the page can be inserted with a paragraph using the HR30 style. These would be rendered in html as <hr align="center" width="30%">. The above paragraph is an example. The paragraph below, of style HR, represents a horizontal rule that spans the entire page. Of course, any HTML including horizontal rules can be inserted directly, thus: <hr width="50%">
Here is a paragraph resumed after a break, such as a table or figure.
Fonts and styles: text may occur in italic, bold, underline, or even all three. One can use different fonts, such as Times New Roman or Zapf Dingbats. There may also be superscripts or subscripts.
One may also have new paragraph styles, made up just for a particular document. They could be converted to <P class="stylename">. If there are any special character styles with names, they should be handled as well. Here is some colored text: red green blue yellow. Here are quotes: "smart" and "dumb". In addition there is a footnote containing a scripRef6. And here is an identified scripture reference: Rom. 8:28.
Rom. 8:28(targeted)
1 See http://www_tei.uic.edu/orgs/tei/lite/.
2 This is the endnote. It even has a special symbol, an asterisk.
3 Rom. 8:28.
4 See http://www.sil.org/sgml/iso639a.html.
5 Available from SIL at http://www.sil.org/computing/fonts/silgreek/ and http://www.sil.org/computing/fonts/silhebrew/