Next  |  Prev  |  Up  |  Top  |  JOS Index  |  JOS Pubs  |  JOS Home  |  Search

Installing LaTeX and BibTeX Input Files

Since you are presumed to have LaTeX, BibTeX, and LaTeX2HTML already installed, you should already have the environment variables $TEXINPUTS, $BSTINPUTS, $BIBINPUTS defined. In my .tcshrc file, for example, I have the lines

        setenv TEXINPUTS ".:$HOME/texinputs::"
        setenv BSTINPUTS ".:$HOME/texinputs::"
        setenv BIBINPUTS ".:$HOME/texinputs::"
Thus, in all cases, the current directory is searched, followed by my ~/texinputs directory, followed by whatever the ``system directory'' is in each case. (The null entry `::' denotes ``default system directories'' -- try finding that in the documentation.)

Let $<$texinputs$>$, $<$bstinputs$>$, and $<$bibinputs$>$ denote any valid directory you are using for each case. Then, to be able to compile the webpubdemo examples, you need to type, in the webpubdemo directory,

cp cmj.bst $<$bstinputs$>$
cp jos.bib $<$bibinputs$>$
cp index.ist $<$texinputs$>$
Alternatively, you could easily edit the examples to not need these files. However, then you would miss out on some of my suggestions!

For example, I generally prefer cmj.bst, created with natbib, to any of the default bibliography formats in LATEX. (Here, ``cmj'' stands for ``Computer Music Journal.'') For example, references are cited using up to two author-last-names (using ``et al.'' for three or more), followed by the year (using suffixes when there is more than one paper by the same author(s) in the same year, etc.). It also handles multiple citations better than similar styles I've seen. I find it very helpful to see papers cited in the form ``[Morse and Ingard 1967, Kinsler and Frey 1982]'' rather than ``[1,2]'' or ``(Mor1967,Kin1982)'', for example, since, if I've studied the paper at all, I'll usually recognize the citation immediately and save myself a trip to the bibliography to see what it is. Finally, the bibliography generated by cmj.bst is sorted alphabetically by the first-author's last name, so that multiple papers by the same author are conveniently grouped together.

Perhaps the most unconventional feature in my bibliography file, jos.bib, is the use of live hyperlinks to publications which are available online. For example, if you click on [5] to visit the full bibliographic citation, you will see the hyperlink

Available online at http://ccrma.stanford.edu/~jos/kna/
and clicking on that will take you directly to the paper. If online papers ever adopt the convention of placing a full bibliographic citation at the bottom of each page (which these tools do), then it is easily seen that there is no longer any need for the bibliographic citation at all (except in the printed version, of course).

If you are an active researcher in signal processing applied to music and audio, then jos.bib might give you some useful references you didn't already have $(\stackrel{\mbox{.\,.}}{\smile})$.

The index style file, textttindex.ist, is nothing special, but something like it is needed to create a reasonable looking index. Tagging words for the index using LATEX's \index{} macro as you write is a very good habit to get into.


Next  |  Prev  |  Up  |  Top  |  JOS Index  |  JOS Pubs  |  JOS Home  |  Search

Download webpub.pdf
[Report a bug]

``Tools for Publishing LaTeX Documents on the Web'', by Julius O. Smith III.
Copyright © 2009-03-13 by Julius O. Smith III
Center for Computer Research in Music and Acoustics (CCRMA),   Stanford University
CCRMA  [About the Automatic Links]