diff options
Diffstat (limited to 'Master/texmf-doc/doc/english/FAQ-en/html/FAQ-usebibtex.html')
| -rw-r--r-- | Master/texmf-doc/doc/english/FAQ-en/html/FAQ-usebibtex.html | 34 |
1 files changed, 17 insertions, 17 deletions
diff --git a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-usebibtex.html b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-usebibtex.html index 62e7c62c1d0..29f3864ad4c 100644 --- a/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-usebibtex.html +++ b/Master/texmf-doc/doc/english/FAQ-en/html/FAQ-usebibtex.html @@ -2,13 +2,13 @@ <title>UK TeX FAQ -- question label usebibtex</title> </head><body> <h3>“Normal” use of BibTeX from LaTeX</h3> -<p>To create a bibliography for your document, you need to perform a +<p/>To create a bibliography for your document, you need to perform a sequence of steps, some of which seem a bit odd. If you choose to use BibTeX, the sequence is: -<p>First: you need a BibTeX bibliography file (a <code>.bib</code> file) — see +<p/>First: you need a BibTeX bibliography file (a <code>.bib</code> file) — see “<a href="FAQ-buildbib.html">creating a BibTeX file</a>”. -<p>Second: you must write your LaTeX document to include a declaration +<p/>Second: you must write your LaTeX document to include a declaration of the ‘style’ of bibliography, citations, and a reference to the bibliography file mentioned in the step 1. So we may have a LaTeX file containing: @@ -27,24 +27,24 @@ Note: we have bibliography style <i>plain</i>, above, which is nearly the simplest of the lot: a sample text, showing the sorts of style choices available, can be found on Ken Turner’s web site: <a href="http://www.cs.stir.ac.uk/~kjt/software/latex/showbst.html">http://www.cs.stir.ac.uk/~kjt/software/latex/showbst.html</a> -<p>Third: you must process the file. +<p/>Third: you must process the file. <blockquote> <pre> latex myfile </pre> </blockquote><p> As LaTeX processes the file, the <code>\</code><code>bibliographystyle</code> command -writes a note of the style to the <code>.aux</code> file; each <code>\</code><code>cite</code> command -writes a note of the citation to the <code>.aux</code> file, and the -<code>\</code><code>bibliography</code> command writes a note of which <code>.bib</code> file is to be -used, to the <code>.aux</code> file. -<p>Note that, at this stage, LaTeX isn’t “resolving” any of the +writes a note of the style to the <code>.aux</code> file; each +<code>\</code><code>cite</code> command writes a note of the citation to the +<code>.aux</code> file, and the <code>\</code><code>bibliography</code> command writes a note +of which <code>.bib</code> file is to be used, to the <code>.aux</code> file. +<p/>Note that, at this stage, LaTeX isn’t “resolving” any of the citations: at every <code>\</code><code>cite</code> command, LaTeX will warn you of the undefined citation, and when the document finishes, there will be a further warning of undefined references. -<p> +<p/> -<p>Fourth: you must run BibTeX: +<p/>Fourth: you must run BibTeX: <blockquote> <pre> bibtex myfile @@ -54,28 +54,28 @@ Don’t try to tell BibTeX anything but the file name: say <code>bibtex myfile.aux</code> (because you know it’s going to read the <code>.aux</code> file) and BibTeX will blindly attempt to process <code>myfile.aux.aux</code>. -<p>BibTeX will scan the <code>.aux</code> file; it will find which bibliography +<p/>BibTeX will scan the <code>.aux</code> file; it will find which bibliography style it needs to use, and will “compile” that style; it will note the citations; it will find which bibliography files it needs, and will run through them matching citations to entries in the bibliography; and finally it will sort the entries that have been cited (if the bibliography style specifies that they should be sorted), and outputs the resulting details to a <code>.bbl</code> file. -<p>Fifth: you run LaTeX again. It warns, again, that each citation is +<p/>Fifth: you run LaTeX again. It warns, again, that each citation is (still) undefined, but when it gets to the <code>\</code><code>bibliography</code> command, it finds a <code>.bbl</code> file, and reads it. As it encounters each <code>\</code><code>bibitem</code> command in the file, it notes a definition of the citation. -<p>Sixth: you run LaTeX yet again. This time, it finds values for all +<p/>Sixth: you run LaTeX yet again. This time, it finds values for all the citations, in its <code>.aux</code> file. Other things being equal, you’re done... until you change the file. -<p>If, while editing, you change any of the citations, or add new ones, +<p/>If, while editing, you change any of the citations, or add new ones, you need to go through the process above from steps 3 (first run of LaTeX) to 6, again, before the document is once again stable. These four mandatory runs of LaTeX make processing a document with a bibliography even more tiresome than the normal two runs required to resolve labels. -<p>To summarise: processing to resolve citations requires: LaTeX; +<p/>To summarise: processing to resolve citations requires: LaTeX; BibTeX; LaTeX; LaTeX. -<p><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=usebibtex">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=usebibtex</a> +<p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=usebibtex">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=usebibtex</a> </body> |