Footnotes are built in the following way:
\f_footnotes caller_footnote content\f*
They consist of these four parts:
1. \f: (initial marker) starts the footnote.
2. footnote 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. footnote content:
* Everything that is part of the footnote.
* This will contain the footnote text, reference, and any additional footnote elements (keywords, quotations etc.)
* Each element should be prefixed by the relevant back-slash code listed below.
4. \f*: (final marker) ends the footnote
Endnotes are built in the same way as footnotes:
\fe_endnotes caller_endnote content\fe*
See the f marker above for explanation.
More information is in the section about the biblenotes.
\fm_...\fm*_
* Footnote mark.
* Used in a situation where two or more points in the text need to refer to the same footnote as seen in Gen 2.9 and Gen 2.17.
* Important: Not to be used in scripture authoring. Intended for use during the publishing process.
\v 9 He made all kinds of beautiful trees grow there and produce good fruit. In the middle of the garden stood the tree that gives life and the tree that gives knowledge of what is good and what is bad. \f i \fr 2.9: \fq knowledge of what is good and what is bad; \ft or \fq knowledge of everything.\f*
and later in the file
\v 17 except the tree that gives knowledge of what is good and what is bad. \fm i \fm* You must not eat the fruit of that tree; if you do, you will die the same day.?
* When markers have not been predefined (i.e. when the \f + format is being used), reference footnote text used earlier in the current book by specifying chapter and verse.
\v 17 except the tree that gives knowledge of what is good and what is bad. \fm 2.9 \fm* You must not eat the fruit of that tree; if you do, you will die the same day.?
The following codes can be included as part of the footnote content:
\fr_##.##
* Footnote reference.
* The chapter and verse(s) that note refers to.
\fk_
* Footnote keyword.
* The specified word(s) for which the footnote is being provided.
\fq_
* Quotation from the scripture text.
* The current and/or alternative translations of a portion of the scripture text.
\fqa_
* Alternative translation.
* To be used when it is preferable to distinguish between a quotation of the current translation of the scripture text, and an alternative translation (instead of using \fq for marking both of these elements).
\fl_
* A footnote label text item.
* For marking or "labelling" a word or words which are used consistently across certain types of translation notes (such as the words "Or" in an alternate translation note, "Others", "Heb.", "LXX" etc.).
\fp_
* A footnote additional paragraph marker.
* Use this marker to indicate the start of a new paragraph within a footnote.
* In order to display a new line (in Paratext formatted view) before the start of a new footnote paragraph, add a soft-return before the \fp marker.
\fv_
* Footnote verse number.
* A verse number in the the text being quoted in the footnote.
\ft_
* Footnote text.
* The (explanatory) text of the footnote.
\fdc_...\fdc*_
* Text between these markers is material to be included only in editions that contain the Apocrypha.
Example showing the caller within the body text (TEV Mrk 6.37):
\p \v 37 ?You yourselves give them something to eat,? Jesus answered. \p They asked, ?Do you want us to go and spend two hundred silver coins \f j \fr 6.37: \fk silver coins: \ft A silver coin was the daily wage of a rural worker (see Mt 20.2).\f* on bread in order to feed them??
Examples showing the footnote text (1Ch 4.9 ; Mrk 1.1; Mrk 6.11):
\p \v 9 There was a man named Jabez, who was the most respected member of his family. His mother had given him the name Jabez, \f i \fr 4.9: \fk jabez: \ft This name sounds like the Hebrew for ?pain.?\f* because his birth had been very painful.
c 1 \s The Preaching of John the Baptist \r (Matthew 3.1-12; Luke 3.1-18; John 1.19-28) \p \v 1 This is the Good News about Jesus Christ, the Son of God. \f a \fr 1.1: \ft Some manuscripts do not have \fq the Son of God.\f*
\q1 \v 11 Give us today the food we need. \f c \fr 6.11: \fq we need; \ft or \fq for today, \ft or \fq for tomorrow.\f* \q1 \v 12 Forgive us the wrongs we have done, \q2 as we forgive the wrongs that others have done to us.
By default footnote 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. \f + \fk...\fk*...\f*.). The examples below include variants which use the "nested", and "non-nested" approach. The \ft code is used in the non-nested markup to indicate a return to normal explanatory footnote text. If the nested approach is used, each code must be explicitly closed, and the unmarked text within \f ..\f* is assumed to be normal footnote text.
Additional examples of use (A=non-nested variant, B=nested variant):
\f + Please refer to the illustration in Gen 1.\f*
\f + Some manuscripts do not include John 8:1-20.\f*
\f + \fk Issac:\ft In Hebrew means "laughter"\f*
\f + \fk Issac:\fk* In Hebrew means "laughter"\f*
\f + \fq Feast of the Unleavened Bread:\ft please refer to the explanation in the glossary\f*
\f + \fq Feast of the Unleavened Bread:\fq* please refer to the explanation in the glossary\f*
\f + \fq In the beginning\ft or \fq While God began\f*
\f + \fq In the beginning\fq* or \fq While God began\fq*\f*
Gen 1:14
\f + \fr 1.14 \fq religious festivals;\ft or \fq seasons.\f*
\f + \fr 1.14\fr* \fq religious festivals;\fq* or \fq seasons.\fq*\f*
Gen 2:4
\f + \fr 2.4 \fk The \nd Lord\nd*: \ft See \nd Lord\nd* in Word List.\f*
\f + \fr 2.4\fr* \fk The \nd Lord\nd*:\fk* See \nd Lord\nd* in Word List.\f*
Gen 3:20
\f + \fr 3.20 \fk Adam: \ft This name in Hebrew means "humanity".\f*
\f + \fr 3.20\fr* \fk Adam:\fk* This name in Hebrew means "humanity".\f*
Gen 10:14
\f + \fr 10.14 \ft Probable text \fq and of Crete...descended; \ft Hebrew \fq from whom the Philistines are descended, and Crete.\f*
\f + \fr 10.14\fr* Probable text \fq and of Crete...descended;\fq* Hebrew \fq from whom the Philistines are descended, and Crete.\fq*\f*
There are footnotes that have no markers inside them at all, markers like \ft, \fr, \fq, \fp, and so on. By default, all text between the footnote markers \f and \f*, except the caller, is considered to be footnote text if no markers are used inside a footnote. Example:
\f * 1.3 The word house is used in a figurative sense.\f*
All text between \f and \f* is footnote text. The first asterisk (*) here is the footnote caller. It marks the footnote in the text.
There are also footnotes with double inside markers. One marker to open that particular style, and another marker to close it. In this case each initial marker, e.g. \fr, \fq, has it's corresponding endmarker within the footnote. The footnote-text-marker \ft is not needed, as all text without the marked text is automatically footnote text. Example:
\f * \fr 1.3 \fr* The word \fq house \fq* is used in a figurative sense.\f*
It is possible to use also the footnote text marker. Example:
\f * \fr 1.3 \fr* \ft The word \ft* \fq house \fq* \ft is used in a figurative sense.\ft* \f*
But this is not necessary.
The only case that \ft is needed is when footnotes have single inside markers, that is, when no endmarkers are used. In this case the initial marker is used, e.g. \fr, \ft , \fq, and the
following marker, including \f*, is considered as the endmarker. Example:
\f * \fr 1.3 \ft The word \fq house \ft is used in a figurative sense.\f*.
- \fr is the footnote reference marker
- \ft is the footnote text marker
- \fq is the footnote quotation marker, or the alternate rendering marker
Working with single footnote-inside markers (without end-markers) or with pairs of it (adding the endmarker) depends on the technique you are using to insert those markers.
- If you select and then change the styles within a footnote, then double markup is useful. This corresponds to the way other software does it.
- If you decide on a style before typing, singe mark-up is better.