diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/inlinebib')
-rw-r--r-- | Master/texmf-dist/doc/latex/inlinebib/MANIFEST | 7 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/inlinebib/inlinebib.htm | 202 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/inlinebib/inlinebib.txt | 151 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/inlinebib/inlinebib1.gif | bin | 0 -> 3686 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/inlinebib/inlinebib2.gif | bin | 0 -> 12611 bytes |
5 files changed, 360 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/inlinebib/MANIFEST b/Master/texmf-dist/doc/latex/inlinebib/MANIFEST new file mode 100644 index 00000000000..2b956db92e7 --- /dev/null +++ b/Master/texmf-dist/doc/latex/inlinebib/MANIFEST @@ -0,0 +1,7 @@ +inlinebib.bst +inlinebib.htm +inlinebib.sty +inlinebib.txt +inlinebib1.gif +inlinebib2.gif +pageranges.sty diff --git a/Master/texmf-dist/doc/latex/inlinebib/inlinebib.htm b/Master/texmf-dist/doc/latex/inlinebib/inlinebib.htm new file mode 100644 index 00000000000..07619130bd1 --- /dev/null +++ b/Master/texmf-dist/doc/latex/inlinebib/inlinebib.htm @@ -0,0 +1,202 @@ +<!DOCTYPE html public "-//w3c//dtd html 4.0 transitional//en"> +<HTML> +<HEAD> +<TITLE>René Seindal - Software - Inline bibliography style</TITLE> +</HEAD> +<BODY text="#000000" bgcolor="#FFFFFF" link="#0000EE" vlink="#551A8B" alink="#FF0000"> + +<H1 align=center>Inline bibliography style</H1> + +<P>I want to have by BiBTeX generated references inlined in footnotes +rather than the very terse references BiBTeX generates by default, so I +hacked together a BiBTeX style to do that. These macros are not +polished or in the form of a proper distribution, but I have used them +with succes myself.</P> + +<P>The following discription have been made in haste. I will document +it better when I have the time (RSN :-).</P> + +<P>There are two files: <A HREF="inlinebib.sty">inlinebib.sty</A> and <A HREF="inlinebib.bst">indexing.bst</A>.</P> + + +<H2>The idea</H2> + +<P>This works just like any other BiBTeX style. It will still generate +the bibliography at the end of the document, but it will also store all +the entries in the <CODE>.aux</CODE> files, so they can be inlined in +the following <CODE>latex</CODE> run.</P> + +<P>The first time a citation is made using <CODE>\cite</CODE> the +complete bibliography entry is inserted. The following citations to the +same entry will generate a short form, with only authors last name and a +shortened title, followed by a "<I>cit.</I>". If the same bibliography +entry is cited several times in a row, the text will only be +"<I>ibid.</I>".</P> + +<P>Citations of this form are designed to be used in footnotes.</P> + +<P>A little example migth be appropriate (don't we all love +screenshots!).</P> + +<P><TABLE border=2 cellpadding=3> +<TR> +<TD> +<P>Footnotes from page one:</P> +<IMG SRC="inlinebib1.gif" ALT="[Example 1]"> +</TD> +</TR> +<TR> +<TD> +<P>Footnotes from page two:</P> +<IMG SRC="inlinebib2.gif" ALT="[Example 2]"> +</TD> +</TR> +</TABLE> + +<FONT SIZE="-1">(the overstrike problem is courtesy of xdvi(1))</FONT> +</P> + +<P>It is not possible to avoid having the complete bibliography at the +end of the document. The macros simply won't work without it. If you +don't need it, just don't print it.</P> + + + +<H2>Usage</H2> + +<H3>Formalities</H3> + +<P>To use these macros put the file <CODE>inlinebib.sty</CODE> in your +LaTeX search path and <CODE>inlinebib.bst</CODE> in your BiBTeX style +search path and then put the line:</P> + +<BLOCKQUOTE> +<PRE>\usepackage{inlinebib}</PRE> +</BLOCKQUOTE> + +<P>in the preamble of your document.</P> + +<P>Other commands have to be added at the point where you want the +bibliography to appear, usually at the end of the document. To tell +BiBTeX to use the <I>inlinebib</I> style, you have to use +<CODE>bibliographystyle</CODE>: + +<BLOCKQUOTE> +<PRE> +\bibliographystyle{inlinebib} +</PRE> +</BLOCKQUOTE> + +<P>Often I add a leading explanation to the bibliography with the +<CODE>\bibliographycomment</CODE> macro. That is:</P> + +<BLOCKQUOTE> +<PRE> +\bibliographycomment{This bibliography ...} +</PRE> +</BLOCKQUOTE> + +<P>The actual index is produced by the <CODE>\bibliography</CODE> +macro. Here you have to specify which BiBTeX databases you want to use.</P> + +<BLOCKQUOTE> +<PRE> +\bibliography{file ...} +</PRE> +</BLOCKQUOTE> + +<P>These were all the formalities.</P> + + +<H3>Doing citations</H3> + +<P>When writing, just make citations as usual. Remember that these +macros can produce very verbose references, and they are intended for +footnotes.</P> + +<P>The default implementation of <CODE>\cite</CODE> allows several +bibliography entries to be cited. This version allows only one at a +time. It still supports the optional argument, which should be a page +reference within the cited text.</P> + +<P>There are a few additional macros available. <CODE>\fullycite</CODE> +forces a reference in the long form, <CODE>\shortcite</CODE> forces +the short form, and <CODE>\noibid</CODE> disables the generation +"<I>ibid.</I>" references for the next citation (this can for example be +used at the end of each chapter).</P> + +<P>To force later citations for certain entries to be either long or +short, the macros <CODE>\fullcitenext{}</CODE> and +<CODE>\shortcitenext{}</CODE> can be used. The single argument is a +comma separated list of BiBTeX labels that should be either long or +short the next time they are cited. E.g., the code +<CITE>\fullcitenext{book1, book2}</CITE> will cause LaTeX to forget that +the two references might have been seen earlier and they will be handled +as if they haven't be cited yet.</P> + + +<H3>The BiBTeX databases</H3> + +<P>This style does not require special changes to the BiBTeX +databases.</P> + +<P>Sometimes the BiBTeX style doesn't manage to calculate the proper +short forms of the author and the title. In that case the BiBTeX +entries in question can be extended with <CODE>shortauthor = {<I>shorter +author name</I>}</CODE> and <CODE>shorttitle = {<I>short form of +title</I>}</CODE>.</P> + + + +<H2>Tips and tricks</H2> + +<P>I have some macros to format page ranges, that I use with this BiBTeX +style. They should be usable with other styles as well.</P> + +<P>The macros are here: <A HREF="pageranges.sty">pageranges.sty</A></P> + +<P>This file defined one user visible macro: <CODE>\pages{}</CODE>, +which will do the following transformations of the single argument:</P> + +<DL> +<DT><CODE>\pages{N}</CODE> +<DD>becomes: <CODE>p.~N</CODE> +<DT><CODE>\pages{N-}</CODE> +<DD>becomes: <CODE>pp.~N~ff</CODE> +<DT><CODE>\pages{N-M}</CODE> +<DD>becomes: <CODE>pp.~N--M</CODE> +<DT><CODE>\pages{N M}</CODE> +<DD>becomes: <CODE>pp.~N M</CODE> +</DL> + +<P>The last version is for cases like <CODE>\pages{213, 345 +and~654}</CODE> which will become <CODE>pp.~213, 345 and~654</CODE>.</P> + + + +<P>I often have this little definition in a LaTeX style file. It makes +<CODE>\cite</CODE> do page ranges automatically and also puts the author +in the index (see <A HREF="indexing.htm">the indexing macros</A>).</P> + +<BLOCKQUOTE> +<PRE> +%% Automatically fix page ranges in citations and index author +\let\RS@citex\@citex +\def\@citex[#1]#2{\I@indexonly-{#2}\RS@citex[\pages{#1}]{#2}} +</PRE> +</BLOCKQUOTE> + + + + + +<H2>Comments</H2> + + +<P>If you have comments, please <A +HREF="mailto:rene@seindal.dk?Subject=Inlinebib macros">write me</A>.</P> + + + +</BODY> +</HTML> diff --git a/Master/texmf-dist/doc/latex/inlinebib/inlinebib.txt b/Master/texmf-dist/doc/latex/inlinebib/inlinebib.txt new file mode 100644 index 00000000000..cfd51dcee57 --- /dev/null +++ b/Master/texmf-dist/doc/latex/inlinebib/inlinebib.txt @@ -0,0 +1,151 @@ + + Inline bibliography style + + I want to have by BiBTeX generated references inlined in footnotes + rather than the very terse references BiBTeX generates by default, so + I hacked together a BiBTeX style to do that. These macros are not + polished or in the form of a proper distribution, but I have used them + with succes myself. + + The following discription have been made in haste. I will document it + better when I have the time (RSN :-). + + There are two files: [1]inlinebib.sty and [2]indexing.bst. + +The idea + + This works just like any other BiBTeX style. It will still generate + the bibliography at the end of the document, but it will also store + all the entries in the .aux files, so they can be inlined in the + following latex run. + + The first time a citation is made using \cite the complete + bibliography entry is inserted. The following citations to the same + entry will generate a short form, with only authors last name and a + shortened title, followed by a "cit.". If the same bibliography entry + is cited several times in a row, the text will only be "ibid.". + + Citations of this form are designed to be used in footnotes. + + A little example migth be appropriate (don't we all love + screenshots!). + + Footnotes from page one: + [Example 1] + + Footnotes from page two: + [Example 2] + + (the overstrike problem is courtesy of xdvi(1)) + + It is not possible to avoid having the complete bibliography at the + end of the document. The macros simply won't work without it. If you + don't need it, just don't print it. + +Usage + + Formalities + + To use these macros put the file inlinebib.sty in your LaTeX search + path and inlinebib.bst in your BiBTeX style search path and then put + the line: + +\usepackage{inlinebib} + + in the preamble of your document. + + Other commands have to be added at the point where you want the + bibliography to appear, usually at the end of the document. To tell + BiBTeX to use the inlinebib style, you have to use bibliographystyle: + +\bibliographystyle{inlinebib} + + Often I add a leading explanation to the bibliography with the + \bibliographycomment macro. That is: + +\bibliographycomment{This bibliography ...} + + The actual index is produced by the \bibliography macro. Here you have + to specify which BiBTeX databases you want to use. + +\bibliography{file ...} + + These were all the formalities. + + Doing citations + + When writing, just make citations as usual. Remember that these macros + can produce very verbose references, and they are intended for + footnotes. + + The default implementation of \cite allows several bibliography + entries to be cited. This version allows only one at a time. It still + supports the optional argument, which should be a page reference + within the cited text. + + There are a few additional macros available. \fullycite forces a + reference in the long form, \shortcite forces the short form, and + \noibid disables the generation "ibid." references for the next + citation (this can for example be used at the end of each chapter). + + To force later citations for certain entries to be either long or + short, the macros \fullcitenext{} and \shortcitenext{} can be used. + The single argument is a comma separated list of BiBTeX labels that + should be either long or short the next time they are cited. E.g., the + code \fullcitenext{book1, book2} will cause LaTeX to forget that the + two references might have been seen earlier and they will be handled + as if they haven't be cited yet. + + The BiBTeX databases + + This style does not require special changes to the BiBTeX databases. + + Sometimes the BiBTeX style doesn't manage to calculate the proper + short forms of the author and the title. In that case the BiBTeX + entries in question can be extended with shortauthor = {shorter author + name} and shorttitle = {short form of title}. + +Tips and tricks + + I have some macros to format page ranges, that I use with this BiBTeX + style. They should be usable with other styles as well. + + The macros are here: [3]pageranges.sty + + This file defined one user visible macro: \pages{}, which will do the + following transformations of the single argument: + + \pages{N} + becomes: p.~N + + \pages{N-} + becomes: pp.~N~ff + + \pages{N-M} + becomes: pp.~N--M + + \pages{N M} + becomes: pp.~N M + + The last version is for cases like \pages{213, 345 and~654} which will + become pp.~213, 345 and~654. + + I often have this little definition in a LaTeX style file. It makes + \cite do page ranges automatically and also puts the author in the + index (see [4]the indexing macros). + +%% Automatically fix page ranges in citations and index author +\let\RS@citex\@citex +\def\@citex[#1]#2{\I@indexonly-{#2}\RS@citex[\pages{#1}]{#2}} + +Comments + + If you have comments, please [5]write me. + +References + + 1. http://www.seindal.dk/rene/software/TeX/inlinebib.sty + 2. http://www.seindal.dk/rene/software/TeX/inlinebib.bst + 3. http://www.seindal.dk/rene/software/TeX/pageranges.sty + 4. http://www.seindal.dk/rene/software/TeX/indexing.htm + 5. mailto:rene@seindal.dk?Subject=Inlinebibmacros diff --git a/Master/texmf-dist/doc/latex/inlinebib/inlinebib1.gif b/Master/texmf-dist/doc/latex/inlinebib/inlinebib1.gif Binary files differnew file mode 100644 index 00000000000..6bcbbd0c8c3 --- /dev/null +++ b/Master/texmf-dist/doc/latex/inlinebib/inlinebib1.gif diff --git a/Master/texmf-dist/doc/latex/inlinebib/inlinebib2.gif b/Master/texmf-dist/doc/latex/inlinebib/inlinebib2.gif Binary files differnew file mode 100644 index 00000000000..8aaec961c0f --- /dev/null +++ b/Master/texmf-dist/doc/latex/inlinebib/inlinebib2.gif |