diff options
author | Norbert Preining <preining@logic.at> | 2007-11-16 10:31:42 +0000 |
---|---|---|
committer | Norbert Preining <preining@logic.at> | 2007-11-16 10:31:42 +0000 |
commit | ae2de180caf254f4bf858f2eaead6f19f19f0093 (patch) | |
tree | e886beb741084518dbdac7803986cee6ea7ad23f /Master/texmf-dist/doc/latex/bibleref/bibleref-manual.html | |
parent | bc5f7832361ad6f48e2053a7b124ffd3176446cd (diff) |
bibleref 1.7 from CTAN, fix ctan2tds for bibleref
git-svn-id: svn://tug.org/texlive/trunk@5436 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/bibleref/bibleref-manual.html')
-rw-r--r-- | Master/texmf-dist/doc/latex/bibleref/bibleref-manual.html | 272 |
1 files changed, 272 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/bibleref/bibleref-manual.html b/Master/texmf-dist/doc/latex/bibleref/bibleref-manual.html new file mode 100644 index 00000000000..1d1faa3a794 --- /dev/null +++ b/Master/texmf-dist/doc/latex/bibleref/bibleref-manual.html @@ -0,0 +1,272 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> + +<!--Converted with LaTeX2HTML 2002 (1.67) +original version by: Nikos Drakos, CBLU, University of Leeds +* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan +* with significant contributions from: + Jens Lippmann, Marek Rouchal, Martin Wilck and others --> +<HTML> +<HEAD> +<TITLE>bibleref.sty v1.07: a LATEX2e package for typesetting bible references</TITLE> +<META NAME="description" CONTENT="bibleref.sty v1.07: a LATEX2e package for typesetting bible references"> +<META NAME="keywords" CONTENT="manual"> +<META NAME="resource-type" CONTENT="document"> +<META NAME="distribution" CONTENT="global"> + +<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1"> +<META NAME="Generator" CONTENT="LaTeX2HTML v2002"> +<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> + + +</HEAD> + +<BODY > + +<H1 ALIGN="CENTER">bibleref.sty v1.07: a L<SUP><SMALL>A</SMALL></SUP>T<SMALL>E</SMALL>X2<SUB>e</SUB> package for +typesetting bible references</H1> +<P ALIGN="CENTER"><STRONG>Nicola Talbot +<BR> +<BR> +School of Computing Sciences +<BR> +University of East Anglia +<BR> +Norwich. Norfolk. NR4 7TJ. +<BR> +United Kingdom +<BR><TT><A NAME="tex2html1" + HREF="http://theoval.cmp.uea.ac.uk/~nlct/">http://theoval.cmp.uea.ac.uk/~nlct/</A></TT></STRONG></P> +<P ALIGN="CENTER"><STRONG>20 Aug 2007</STRONG></P> +<BR> + +<H2><A NAME="SECTION00010000000000000000"> +Contents</A> +</H2> +<!--Table of Contents--> + +<UL> +<LI><A NAME="tex2html8" + HREF="manual.html#SECTION00020000000000000000">Introduction</A> +<LI><A NAME="tex2html9" + HREF="manual.html#SECTION00030000000000000000">Defining New Styles</A> +<LI><A NAME="tex2html10" + HREF="manual.html#SECTION00040000000000000000">Indexing Bible References</A> +<LI><A NAME="tex2html11" + HREF="manual.html#SECTION00050000000000000000">Acknowledgements</A> +</UL> +<!--End of Table of Contents--> +<P> + +<H1><A NAME="SECTION00020000000000000000"> +Introduction</A> +</H1> + +<P> +The <TT>bibleref</TT> package was designed to provide consistent formatting for referencing +parts of the bible. + +<P> + +<P> +<TT>\bibleverse{</TT><EM>book title</EM><TT>}({</TT><EM>chapter</EM><TT>}:</TT><I>verse(s)</I><TT>)</TT> +<P> +This command can be used to cite a bible book, chapter or verse +or range of chapters or verses. + +<P> +The book title, <I>book title</I>, may be given either as the +full title (e.g. <TT>Matthew</TT>) or as an abbreviation (e.g. <TT>Mt</TT> or <TT>Matt</TT>), most standard abbreviations are +recognised. Books with multiple parts should be preceeded by the +book number in uppercase roman numerals. For example, the second +book of Kings should be entered as <code>\bibleverse{IIKings}</code> + +<P> +You may have any number, or zero, sets of parenthesis +<code>(</code><I>chapter</I><TT>:</TT><I>verse(s)</I><code>)</code>, +indicating the chapter and verse or verses. Verses can be +specified as a comma separated list of individual verses or range +of verses. A range of verses should be written with a single +hyphen, e.g. <code>2-4</code>. In the typeset output the verses will +be separated with <TT>\BRvsep</TT> (an en-dash +by default.) A chapter may be referenced without a verse, but the +colon must remain, e.g. <code>(12:)</code> simply indicates chapter +12. + +<P> +A range of verses spanning more than one chapter can +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> + +<P> +Examples: +<DIV ALIGN="CENTER"> +<TABLE CELLPADDING=3> +<TR><TD ALIGN="LEFT"><code>\bibleverse{Ex}</code></TD> +<TD ALIGN="LEFT">Exodus</TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\bibleverse{Exodus}(20:)</code></TD> +<TD ALIGN="LEFT">Exodus 20</TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\bibleverse{Exod}(20:17)</code></TD> +<TD ALIGN="LEFT">Exodus 20:17</TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\bibleverse{IICo}(12:21)</code></TD> +<TD ALIGN="LEFT">2 Corinthians 12:21</TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\bibleverse{IICor}(12:21-32)</code></TD> +<TD ALIGN="LEFT">2 Corinthians 12:21-32</TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\bibleverse{Ex}(20:17)(21:3)</code></TD> +<TD ALIGN="LEFT">Exodus 20:17;21:3</TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\bibleverse{Ex}(15:)(17:)(20:)</code></TD> +<TD ALIGN="LEFT">Exodus 15;17;20</TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\bibleverse{Rev}(1:2,5,7-9,11)</code></TD> +<TD ALIGN="LEFT">Revelation 1:2,5,7-9,11</TD> +</TR> +<TR><TD ALIGN="LEFT"><code>\bibleverse{IChronicles}(1:3)-(2:7)</code></TD> +<TD ALIGN="LEFT">1 Chronicles 1:3-2:7</TD> +</TR> +</TABLE> +</DIV> + +<P> +The style of the reference can be specified either by +package option or as the argument to the command + +<P> +<TT>\biblerefstyle{</TT><EM>style</EM><TT>}</TT> +<P> +Styles are listed in Table <A HREF="manual.html#tab:styles">1</A>. + +<P> +<BR><P></P> +<DIV ALIGN="CENTER"> + +<A NAME="tab:styles"></A> +<BR> +<BR> +<DIV ALIGN="CENTER"> +<A NAME="172"></A> +<TABLE CELLPADDING=3> +<CAPTION><STRONG>Table 1:</STRONG> +Bible Citation Styles (can be used as package option or in the argument to +<TT>\biblerefstyle</TT>)</CAPTION> +<TR><TH ALIGN="LEFT"><B>Style </B></TH> +<TH ALIGN="LEFT" VALIGN="TOP" WIDTH=250><B>Example</B></TH> +</TR> +<TR><TD ALIGN="LEFT">default</TD> +<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>2 Corinthians 12:1-5</TD> +</TR> +<TR><TD ALIGN="LEFT">jerusalem</TD> +<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>2 Co 12:1-5</TD> +</TR> +<TR><TD ALIGN="LEFT">anglosaxon</TD> +<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>II Cor 12.1-5</TD> +</TR> +<TR><TD ALIGN="LEFT">JEH</TD> +<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>2 Cor xii. 1-5</TD> +</TR> +<TR><TD ALIGN="LEFT">NTG</TD> +<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>2 Cor xii,1-5</TD> +</TR> +<TR><TD ALIGN="LEFT">MLA</TD> +<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>2 Cor xii.1-5</TD> +</TR> +<TR><TD ALIGN="LEFT">chicago</TD> +<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>2 Cor xii:1-5</TD> +</TR> +<TR><TD ALIGN="LEFT">text</TD> +<TD ALIGN="LEFT" VALIGN="TOP" WIDTH=250>2 Cor xii:1-5</TD> +</TR> +</TABLE> +</DIV> +</DIV> +<BR> + +<P> +You can change the name of a book using + +<P> +<TT>\setbooktitle{</TT><EM>name</EM><TT>}{</TT><EM>new title</EM><TT>}</TT> +<P> +Note that <I>name</I> must be the full name, not the +abbreviated name of the book. For example, to change +Revelation to Apoc, do +<code>\setbookname{Revelation}{Apoc}</code> +(<B>Note</B> that you shouldn't do +<code>\setbookname{Rev}{Apoc}</code>) + +<P> + +<H1><A NAME="SECTION00030000000000000000"> +Defining New Styles</A> +</H1> + +<P> +You can define a new style using the command + +<P> +<TT>\newbiblerefstyle{</TT><EM>style-name</EM><TT>}{</TT><EM>commands</EM><TT>}</TT> +<P> +where <I>commands</I> are +the commands needed to modify the citation style. + +<P> +Example: +This new style is based on the `default' style, but +has verses in lower case Roman numerals, and redefines +``Revelation'' as ``Apocalypse''. +<PRE> +\newbiblerefstyle{sample}{% +\biblerefstyle{default}% +\renewcommand{\BRversestyle}[1]{\romannumeral##1}% +\setbooktitle{Revelation}{Apocalypse}% +} +</PRE> +Note the use of <code>##1</code> instead of <code>#1</code>. + +<P> + +<H1><A NAME="SECTION00040000000000000000"> +Indexing Bible References</A> +</H1> + +<P> + +<P> +<TT>\ibibleverse{</TT><EM>book title</EM><TT>}({</TT><EM>chapter</EM><TT>}:</TT><I>verse(s)</I><TT>)</TT> +<P> +This does the same as <TT>\bibleverse</TT> +but also adds an index entry (provided you have used +<TT>\makeindex</TT> in the preamble.) The default page number +format is given by the command +<TT>\bvidxpgformat</TT>. This +is <TT>textrm</TT> by default, but can be redefined. To +override the page number format for a particular entry you can +use the optional argument to <TT>\ibibleverse</TT>. For example: +<PRE> +\ibibleverse[textit]{Exodus} +</PRE> +(Note there is no backslash.) + +<P> + +<H1><A NAME="SECTION00050000000000000000"> +Acknowledgements</A> +</H1> +Many thanks to all the useful comments from comp.text.tex, +especially from Jesse Billett, Brooks Moses and Ulrich M. Schwarz. + +<P> + +<P> +<BR><HR> +<ADDRESS> +<A href=http://theoval.cmp.uea.ac.uk/~nlct/>Nicola L. C. Talbot</A>. +<A HREF=http://www.cmp.uea.ac.uk/>School of Computing Sciences</A>. +<A HREF=http://www.uea.ac.uk/>University of East Anglia.</A> +Last Modified: 2007-08-20 +</ADDRESS> +</BODY> +</HTML> |