1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
3
<!--Converted with LaTeX2HTML 2002 (1.67)
4
original version by: Nikos Drakos, CBLU, University of Leeds
5
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
6
* with significant contributions from:
7
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
10
<TITLE>bibleref.sty v1.07: a LATEX2e package for typesetting bible references</TITLE>
11
<META NAME="description" CONTENT="bibleref.sty v1.07: a LATEX2e package for typesetting bible references">
12
<META NAME="keywords" CONTENT="manual">
13
<META NAME="resource-type" CONTENT="document">
14
<META NAME="distribution" CONTENT="global">
16
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
17
<META NAME="Generator" CONTENT="LaTeX2HTML v2002">
18
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
25
<H1 ALIGN="CENTER">bibleref.sty v1.07: a L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X2<SUB>e</SUB> package for
26
typesetting bible references</H1>
27
<P ALIGN="CENTER"><STRONG>Nicola Talbot
30
School of Computing Sciences
32
University of East Anglia
34
Norwich. Norfolk. NR4 7TJ.
37
<BR><TT><A NAME="tex2html1"
38
HREF="http://theoval.cmp.uea.ac.uk/~nlct/">http://theoval.cmp.uea.ac.uk/~nlct/</A></TT></STRONG></P>
39
<P ALIGN="CENTER"><STRONG>20 Aug 2007</STRONG></P>
42
<H2><A NAME="SECTION00010000000000000000">
45
<!--Table of Contents-->
48
<LI><A NAME="tex2html8"
49
HREF="manual.html#SECTION00020000000000000000">Introduction</A>
50
<LI><A NAME="tex2html9"
51
HREF="manual.html#SECTION00030000000000000000">Defining New Styles</A>
52
<LI><A NAME="tex2html10"
53
HREF="manual.html#SECTION00040000000000000000">Indexing Bible References</A>
54
<LI><A NAME="tex2html11"
55
HREF="manual.html#SECTION00050000000000000000">Acknowledgements</A>
57
<!--End of Table of Contents-->
60
<H1><A NAME="SECTION00020000000000000000">
65
The <TT>bibleref</TT> package was designed to provide consistent formatting for referencing
71
<TT>\bibleverse{</TT><EM>book title</EM><TT>}({</TT><EM>chapter</EM><TT>}:</TT><I>verse(s)</I><TT>)</TT>
73
This command can be used to cite a bible book, chapter or verse
74
or range of chapters or verses.
77
The book title, <I>book title</I>, may be given either as the
78
full title (e.g. <TT>Matthew</TT>) or as an abbreviation (e.g. <TT>Mt</TT> or <TT>Matt</TT>), most standard abbreviations are
79
recognised. Books with multiple parts should be preceeded by the
80
book number in uppercase roman numerals. For example, the second
81
book of Kings should be entered as <code>\bibleverse{IIKings}</code>
84
You may have any number, or zero, sets of parenthesis
85
<code>(</code><I>chapter</I><TT>:</TT><I>verse(s)</I><code>)</code>,
86
indicating the chapter and verse or verses. Verses can be
87
specified as a comma separated list of individual verses or range
88
of verses. A range of verses should be written with a single
89
hyphen, e.g. <code>2-4</code>. In the typeset output the verses will
90
be separated with <TT>\BRvsep</TT> (an en-dash
91
by default.) A chapter may be referenced without a verse, but the
92
colon must remain, e.g. <code>(12:)</code> simply indicates chapter
96
A range of verses spanning more than one chapter can
97
be entered as <TT>(</TT><I>ch</I><TT>:</TT><I>v</I><TT>)-(</TT><I>ch</I><TT>:</TT><I>v</I><TT>)</TT>
102
<TABLE CELLPADDING=3>
103
<TR><TD ALIGN="LEFT"><code>\bibleverse{Ex}</code></TD>
104
<TD ALIGN="LEFT">Exodus</TD>
106
<TR><TD ALIGN="LEFT"><code>\bibleverse{Exodus}(20:)</code></TD>
107
<TD ALIGN="LEFT">Exodus 20</TD>
109
<TR><TD ALIGN="LEFT"><code>\bibleverse{Exod}(20:17)</code></TD>
110
<TD ALIGN="LEFT">Exodus 20:17</TD>
112
<TR><TD ALIGN="LEFT"><code>\bibleverse{IICo}(12:21)</code></TD>
113
<TD ALIGN="LEFT">2 Corinthians 12:21</TD>
115
<TR><TD ALIGN="LEFT"><code>\bibleverse{IICor}(12:21-32)</code></TD>
116
<TD ALIGN="LEFT">2 Corinthians 12:21-32</TD>
118
<TR><TD ALIGN="LEFT"><code>\bibleverse{Ex}(20:17)(21:3)</code></TD>
119
<TD ALIGN="LEFT">Exodus 20:17;21:3</TD>
121
<TR><TD ALIGN="LEFT"><code>\bibleverse{Ex}(15:)(17:)(20:)</code></TD>
122
<TD ALIGN="LEFT">Exodus 15;17;20</TD>
124
<TR><TD ALIGN="LEFT"><code>\bibleverse{Rev}(1:2,5,7-9,11)</code></TD>
125
<TD ALIGN="LEFT">Revelation 1:2,5,7-9,11</TD>
127
<TR><TD ALIGN="LEFT"><code>\bibleverse{IChronicles}(1:3)-(2:7)</code></TD>
128
<TD ALIGN="LEFT">1 Chronicles 1:3-2:7</TD>
134
The style of the reference can be specified either by
135
package option or as the argument to the command
138
<TT>\biblerefstyle{</TT><EM>style</EM><TT>}</TT>
140
Styles are listed in Table <A HREF="manual.html#tab:styles">1</A>.
146
<A NAME="tab:styles"></A>
151
<TABLE CELLPADDING=3>
152
<CAPTION><STRONG>Table 1:</STRONG>
153
Bible Citation Styles (can be used as package option or in the argument to
154
<TT>\biblerefstyle</TT>)</CAPTION>
155
<TR><TH ALIGN="LEFT"><B>Style </B></TH>
156
<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=250><B>Example</B></TH>
158
<TR><TD ALIGN="LEFT">default</TD>
159
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>2 Corinthians 12:1-5</TD>
161
<TR><TD ALIGN="LEFT">jerusalem</TD>
162
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>2 Co 12:1-5</TD>
164
<TR><TD ALIGN="LEFT">anglosaxon</TD>
165
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>II Cor 12.1-5</TD>
167
<TR><TD ALIGN="LEFT">JEH</TD>
168
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>2 Cor xii. 1-5</TD>
170
<TR><TD ALIGN="LEFT">NTG</TD>
171
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>2 Cor xii,1-5</TD>
173
<TR><TD ALIGN="LEFT">MLA</TD>
174
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>2 Cor xii.1-5</TD>
176
<TR><TD ALIGN="LEFT">chicago</TD>
177
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>2 Cor xii:1-5</TD>
179
<TR><TD ALIGN="LEFT">text</TD>
180
<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>2 Cor xii:1-5</TD>
188
You can change the name of a book using
191
<TT>\setbooktitle{</TT><EM>name</EM><TT>}{</TT><EM>new title</EM><TT>}</TT>
193
Note that <I>name</I> must be the full name, not the
194
abbreviated name of the book. For example, to change
195
Revelation to Apoc, do
196
<code>\setbookname{Revelation}{Apoc}</code>
197
(<B>Note</B> that you shouldn't do
198
<code>\setbookname{Rev}{Apoc}</code>)
202
<H1><A NAME="SECTION00030000000000000000">
203
Defining New Styles</A>
207
You can define a new style using the command
210
<TT>\newbiblerefstyle{</TT><EM>style-name</EM><TT>}{</TT><EM>commands</EM><TT>}</TT>
212
where <I>commands</I> are
213
the commands needed to modify the citation style.
217
This new style is based on the `default' style, but
218
has verses in lower case Roman numerals, and redefines
219
``Revelation'' as ``Apocalypse''.
221
\newbiblerefstyle{sample}{%
222
\biblerefstyle{default}%
223
\renewcommand{\BRversestyle}[1]{\romannumeral##1}%
224
\setbooktitle{Revelation}{Apocalypse}%
227
Note the use of <code>##1</code> instead of <code>#1</code>.
231
<H1><A NAME="SECTION00040000000000000000">
232
Indexing Bible References</A>
238
<TT>\ibibleverse{</TT><EM>book title</EM><TT>}({</TT><EM>chapter</EM><TT>}:</TT><I>verse(s)</I><TT>)</TT>
240
This does the same as <TT>\bibleverse</TT>
241
but also adds an index entry (provided you have used
242
<TT>\makeindex</TT> in the preamble.) The default page number
243
format is given by the command
244
<TT>\bvidxpgformat</TT>. This
245
is <TT>textrm</TT> by default, but can be redefined. To
246
override the page number format for a particular entry you can
247
use the optional argument to <TT>\ibibleverse</TT>. For example:
249
\ibibleverse[textit]{Exodus}
251
(Note there is no backslash.)
255
<H1><A NAME="SECTION00050000000000000000">
258
Many thanks to all the useful comments from comp.text.tex,
259
especially from Jesse Billett, Brooks Moses and Ulrich M. Schwarz.
266
<A href=http://theoval.cmp.uea.ac.uk/~nlct/>Nicola L. C. Talbot</A>.
267
<A HREF=http://www.cmp.uea.ac.uk/>School of Computing Sciences</A>.
268
<A HREF=http://www.uea.ac.uk/>University of East Anglia.</A>
269
Last Modified: 2007-08-20
added
removed
texmf-dist/doc/latex/bibleref/bibleref-manual.html
