Cross References

Syntax notes.

Cross Reference Syntax

Cross references are laid out in the following format:

\x_cross reference caller_cross reference content\x*

They consist of these four parts:

1. \x: (initial marker) starts the footnote.

2. cross reference caller: may be one of these three:

* + means that the caller is generated automatically, eg. progressive letters or numbers.

* - means no caller is generated.

* * means any character, where * represents the character to be used as the caller – defined by the user.

3. cross reference content:

* Everything that is part of the cross reference.

* This will contain the reference, the text, reference, and any additional elements.

* Each element should be prefixed by the relevant back-slash code listed, see below. listed below.

4. \x*: (final marker) ends the cross reference

\x * Cross Reference

\x_

* Beginning of cross reference

\x*

* Cross reference ending.

Cross Reference Content Elements

The following codes can be included as part of the cross reference content:

\xo (*) Origin Reference

\xo_...

* Cross reference origin reference.

* The chapter and verse location in the text which the target references refer to.

* Usually in the format <chapter>.<verse> or <chapter>,<verse>.

\xk (*) Keyword

\xk_...

* Cross reference keyword.

\xq (*) Quotation

\xq_...

* Quotation from the scripture text.

* A current and/or alternative translation of a portion of the scripture text.

\xt (*) Targets

\xt_...

* Target references.

* A list of the target cross references for the origin reference.

* This is a list of book name abbreviations and <chapter>.<verse> references, separated by semicolons (though there may be alternate formats for this list in different regions and countries).

\xdc * Apocrypha

\xdc_...\xdc*_

* References (or other text) between these markers is material to be included only in editions that contain the Apocrypha.

Nesting

By default cross reference codes are not nested (i.e. they are not embedded within each other). The use of each new code cancels out the 'environment' of the previous. However, an alternative markup may be used requiring each internal marker to be explicitly closed (e.g. \x - \xo...\xo*...\x*.). The examples below include variants which use the "nested", and "non-nested" approach. If the nested approach is used, each code must be explicitly closed, and the unmarked text within \x ..\x* is assumed to be target reference text.

Examples of use

TEV Mat 1.11:

\p
\v 2-6a From Abraham to King David, the following ancestors
are listed: Abraham, Isaac, Jacob, Judah and his brothers;
then Perez and Zerah (their mother was Tamar), Hezron, Ram,
Amminadab, Nahshon, Salmon, Boaz (his mother was Rahab), Obed
(his mother was Ruth), Jesse, and King David.
\p
\v 6b-11 From \x - \xo 1.11: \xt 2Ki 24.14,15; 2Ch 36.10;
Jer 27.20.\x* David to the time when the people of Israel were
taken into exile in Babylon, the following ancestors are listed:

Cross reference with multiple "parts" (TEV Gen 49.31):

\v 31
\x - \xo 49.31: a \xt Gen 25.9,10; \xo b \xt Gen 35.29.\x*
That is where they buried Abraham and his wife Sarah; that is where they buried
Isaac and his wife Rebecca; and that is where I buried Leah.

Cross reference with references to the Apocrypha marked (TEV Gen 1.26):

\p
\v 26 \x - \xo 1.26: \xt \xdc Wis 2.23; Sir 17.3,4;\xdc* 1Co 11.7.\x* Then God said,
?And now we will make human beings; they will be like us and resemble us.