summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/bibtex/inlinebib
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-04-07 23:20:16 +0000
committerKarl Berry <karl@freefriends.org>2011-04-07 23:20:16 +0000
commitbeeaf703741d4a46737ccf3c06680c071950a657 (patch)
treefb66cec1c1c356c72f0012ee51a024913dba2f4e /Master/texmf-dist/doc/bibtex/inlinebib
parent91851e5c767571e6cbab9de9dc575a9ef01dc3ba (diff)
inlinebib non-update
git-svn-id: svn://tug.org/texlive/trunk@22018 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/bibtex/inlinebib')
-rw-r--r--Master/texmf-dist/doc/bibtex/inlinebib/MANIFEST7
-rw-r--r--Master/texmf-dist/doc/bibtex/inlinebib/inlinebib.htm202
-rw-r--r--Master/texmf-dist/doc/bibtex/inlinebib/inlinebib.txt151
-rw-r--r--Master/texmf-dist/doc/bibtex/inlinebib/inlinebib1.gifbin0 -> 3686 bytes
-rw-r--r--Master/texmf-dist/doc/bibtex/inlinebib/inlinebib2.gifbin0 -> 12611 bytes
5 files changed, 360 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/bibtex/inlinebib/MANIFEST b/Master/texmf-dist/doc/bibtex/inlinebib/MANIFEST
new file mode 100644
index 00000000000..2b956db92e7
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/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/bibtex/inlinebib/inlinebib.htm b/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib.htm
new file mode 100644
index 00000000000..07619130bd1
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/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/bibtex/inlinebib/inlinebib.txt b/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib.txt
new file mode 100644
index 00000000000..cfd51dcee57
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/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/bibtex/inlinebib/inlinebib1.gif b/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib1.gif
new file mode 100644
index 00000000000..6bcbbd0c8c3
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib1.gif
Binary files differ
diff --git a/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib2.gif b/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib2.gif
new file mode 100644
index 00000000000..8aaec961c0f
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/inlinebib/inlinebib2.gif
Binary files differ