Debian Codegraph @

texmf-dist/source/bibtex/bibtools/demo.html

raw
1
2 <HTML>
3 <HEAD><TITLE> bib2html demo </TITLE></HEAD>
4 <BODY>
5
6 <H1> bib2html demo </H1>
7
8 <P>
9
10 <B>bib2html</B> is a combination of a shell script and two
11 BibTeX-style files. bib2html takes the name of a style and a list of
12 .bib file names, and runs BibTeX to produce an output file bib.html.
13 This demo page assumes that you have run either
14 <CODE> bib2html alpha demo.bib </CODE>
15 or
16 <CODE> bib2html abstract demo.bib, </CODE>
17 and that the output
18 <A HREF="bib.html"> bib.html </A>
19 remains in the same directory as this
20 file. (Note: the abstracting style will often produce some warning
21 messages from bibtex if the abstracts or comments are too long, but
22 the resulting HTML is still usable.)
23 </P>
24
25 <P>
26
27 One of the neat things about bib2html is that you can put a <EM> URL
28 </EM> field in your bib entries, and that URL will be used to make the
29 entry's label into a Web link. Usually, the URL would point to the
30 paper itself (e.g., compressed postscript in an ftp archive, or
31 perhaps even an HTML-format paper), but it could of course point to
32 anything. Thus you can expand your idea of what bib entries might
33 reference....
34
35 </P>
36
37 <P>
38
39 One of the other neat things about bib2html is that you can put
40 citations to the bibliography in other pages, much like you can in
41 LaTeX. The difference is that the citations are <EM>links</EM> to the
42 bibliography page. For example, I can refer one of my recent papers
43 in the demo bibliography
44
45 <A HREF="bib.html#kotz:addrtrace"> [KC94b]. </A>
46 (View the source of this page to see how it's done). That one has the
47 paper's text on-line. My PhD thesis is
48 <A HREF="bib.html#kotz:thesis"> [Kot91]. </A>
49 Another paper does not have any on-line version
50 <A HREF="bib.html#kotz:pools"> [KE89]. </A>
51
52 </P>
53
54 <P>
55
56 Notice that I use the cite key for the anchor label, rather than the
57 label chosen by BibTeX. This has two main benefits: it makes the
58 citation (URL) more like that in LaTeX, and it makes the citation
59 independent of the format of the bibliography page (and the way it
60 chooses labels).
61
62 </P>
63
64 <P>
65
66 One disadvantage is that there is no way to automatically generate the
67 citation labels at the point of reference, like BibTeX's
68 cross-referencing capability. Another disadvantage is that bib2html
69 doesn't understand arbitrary LaTeX commands. Although it converts
70 most accents, \bf, \em, etc to HTML,
71 any fancier embedded LaTeX or TeX commands are just
72 passed through. If you need a pretty bibliography,
73 you'll have to edit those by hand.
74
75 </P>
76
77 <A HREF="http://www.ctan.org/tex-archive/biblio/bibtex/utils/bibtools/">bib2html source</A>.
78
79 <HR>
80
81 -- David Kotz
82 </BODY>
83 </HTML>