summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/bibtex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/bibtex')
-rw-r--r--Master/texmf-dist/doc/bibtex/bibhtml/README7
-rw-r--r--Master/texmf-dist/doc/bibtex/bibhtml/bibhtml4
-rw-r--r--Master/texmf-dist/doc/bibtex/bibhtml/bibhtml-extract-aux.xslt4
-rw-r--r--Master/texmf-dist/doc/bibtex/bibhtml/bibhtml-insert-bib.xslt4
-rw-r--r--Master/texmf-dist/doc/bibtex/bibhtml/bibhtml.html95
-rw-r--r--Master/texmf-dist/doc/bibtex/bibhtml/detex.sed4
-rw-r--r--Master/texmf-dist/doc/bibtex/bibhtml/style.css166
7 files changed, 232 insertions, 52 deletions
diff --git a/Master/texmf-dist/doc/bibtex/bibhtml/README b/Master/texmf-dist/doc/bibtex/bibhtml/README
index cdd8f9b5dab..3462b1c0452 100644
--- a/Master/texmf-dist/doc/bibtex/bibhtml/README
+++ b/Master/texmf-dist/doc/bibtex/bibhtml/README
@@ -1,14 +1,15 @@
Bibhtml consists of a set of BibTeX style files, which allow you to
use BibTeX to produce bibliographies in HTML. These are modelled
-closely on the standard BibTeX style files.
+closely on the standard BibTeX style files, paired so that
+plainhtml.bst is derived from plain.bst.
To accompany them, this package includes a pair of XSLT scripts which
illustrate how you might integrate these generated bibliographies into
an XML/HTML workflow.
-The long-term URL for this page is http://purl.org/nxg/dist/bibhtml
+The long-term URL for this package is http://purl.org/nxg/dist/bibhtml
-This distribution contains bibhtml version 2.0, released 2009 August 9.
+This distribution contains bibhtml version 2.0.1, released 2009 November 2.
Norman Gray, http://nxg.me.uk
diff --git a/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml b/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml
index a7edf5fc826..250b5e5a109 100644
--- a/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml
+++ b/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml
@@ -32,7 +32,7 @@
use strict;
-my $version = 'Bibhtml, version 2.0, Norman Gray <norman@astro.gla.ac.uk>, 2009 August 9';
+my $version = 'Bibhtml, version 2.0.1, Norman Gray <norman@astro.gla.ac.uk>, 2009 November 2';
# configuration...
@@ -439,7 +439,7 @@ sub readconfig {
sub printhelp {
print STDOUT <<\_EOD;
-This is bibhtml version 2.0, 2009 August 9.
+This is bibhtml version 2.0.1, 2009 November 2.
Usage:
% bibhtml [options...] filename...
diff --git a/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml-extract-aux.xslt b/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml-extract-aux.xslt
index b630d338e7a..2862c56dba4 100644
--- a/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml-extract-aux.xslt
+++ b/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml-extract-aux.xslt
@@ -2,8 +2,8 @@
<!--
! bibhtml-extract-aux.xslt
!
- ! Part of bibhtml, version 2.0, released 2009 August 9
- ! Hg Node 4a5600417b09.
+ ! Part of bibhtml, version 2.0.1, released 2009 November 2
+ ! Hg Node 6ca3807543d6.
! See <http://purl.org/nxg/dist/bibhtml>
!
! This sample script processes an XML file which contains elements like
diff --git a/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml-insert-bib.xslt b/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml-insert-bib.xslt
index fb1d64b319a..57ff5600725 100644
--- a/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml-insert-bib.xslt
+++ b/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml-insert-bib.xslt
@@ -2,8 +2,8 @@
<!--
! bibhtml-extract-aux.xslt
!
- ! Part of bibhtml, version 2.0, released 2009 August 9
- ! Hg node 4a5600417b09.
+ ! Part of bibhtml, version 2.0.1, released 2009 November 2
+ ! Hg node 6ca3807543d6.
! See <http://purl.org/nxg/dist/bibhtml>
!
! This sample script processes an XML file which contains elements like
diff --git a/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml.html b/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml.html
index ae24e497a0c..d68dfd94d81 100644
--- a/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml.html
+++ b/Master/texmf-dist/doc/bibtex/bibhtml/bibhtml.html
@@ -4,7 +4,7 @@
<title>Bibhtml documentation</title>
<meta name="keywords" content="bibhtml, bibtex, HTML" />
<link href="http://nxg.me.uk" rev="author" />
- <link type="text/css" rel="stylesheet" href="http://nxg.me.uk/style/base.css" />
+ <link type="text/css" rel="stylesheet" href="style.css" />
</head>
<body>
@@ -20,10 +20,10 @@ modelled closely on the standard BibTeX style files.</p>
which illustrate how you might integrate these generated
bibliographies into an XML/HTML workflow.</p>
-<p>The long-term URL for this page is <code>http://purl.org/nxg/dist/bibhtml</code></p>
+<p>The long-term URL for this package is <code>http://purl.org/nxg/dist/bibhtml</code></p>
<p>This documentation describes
-bibhtml version 2.0, released 2009 August 9.</p>
+bibhtml version 2.0.1, released 2009 November 2.</p>
</div>
<h3>Contents</h3>
@@ -40,21 +40,22 @@ bibhtml version 2.0, released 2009 August 9.</p>
<p><em>Bibhtml</em> consists of a set of BibTeX style files, which
allow you to use BibTeX to produce bibliographies in HTML. These are
-modelled closely on the standard BibTeX style files.</p>
+modelled closely on the standard BibTeX style files. For sample output,
+see <a href="#refs">the reference section below</a>.</p>
<p>To accompany them, this package includes a pair of XSLT scripts
which illustrate how you might integrate these generated
bibliographies into an XML/HTML workflow.</p>
<p>The output of these style files is usable as-is, but it benefits
-from some post-processing, to remove TeX-isms. There's a <em>sed</em>
+from some post-processing, to remove TeX-isms. There’s a <em>sed</em>
script in the distribution which does exactly that, called
<code>detex.sed</code>. If you want to make a version of that im some
other regexp-supporting language, let me know and I can include it in
the distribution.</p>
<p>As well,
-it includes a Perl script which orchestrates the various steps
+the package includes a Perl script which orchestrates the various steps
required to manage such a bibliography for one or more HTML files.
The references in the text are linked directly to the corresponding
bibliography entry, and if a URL is defined in the entry within the
@@ -78,7 +79,7 @@ XSLT-based workflow. For further details, see the discussion of the
style files <a href="#bst-files">below</a>.</p>
<p>There is also a Perl script, <em>bibhtml</em>, which can orchestrate generating and using
-this <code>.aux</code> file. This script isn't really maintained any
+this <code>.aux</code> file. This script isn’t really maintained any
more, but it is still distributed, and documented <a href="#usage">below</a>.</p>
<p><em>Bibhtml</em> works with a standard BibTeX database -- it is
@@ -93,9 +94,14 @@ archive, this will be of no interest to you.</p>
<h2><a name="bst-files" id="bst-files">BibTeX style files</a></h2>
<p>The package includes several BibTeX style files. As well as the
-ones directly derived from the standard styles, there are also <code>plainhtmldate.bst</code> and
-<code>plainhtmldater.bst</code>, which are derived from the standard
-<code>plain.bst</code> which sort the
+ones directly derived from the standard styles, there are also
+<code>plainhtmldate.bst</code>,
+<code>plainhtmldater.bst</code>,
+<code>alphahtmldate.bst</code> and
+<code>alphahtmldater.bst</code> styles,
+which are derived from the standard
+<code>plain.bst</code> and <code>alpha.bst</code> styles,
+which sort the
output by date and reverse date, rather than by author.</p>
<p>In version 2 of the <em>bibhtml</em> package, the
@@ -191,7 +197,7 @@ reasonably usable without any post-processing. However it is not
ideal, since there are occasionaly TeX-isms such as backslash-escaped
characters and the like, depending on what is in the source
<code>.bib</code> file. Also, without post-processing any DOIs in
-the source file aren't formed into links.</p>
+the source file aren’t formed into links.</p>
<p>The distribution includes a <code>sed</code> file,
<code>detex.sed</code>, which can do appropriate post-processing.
@@ -203,28 +209,31 @@ Thus the normal workflow is:</p>
</pre>
<p>Since it uses <code>sed</code>, this is fairly obviously
unix-specific, but if anyone would like to contribute a script with
-similar functionality (it's just a few moderately tortuous regular
-expressions), I'd be delighted to include it in the distribution.</p>
+similar functionality (it’s just a few moderately tortuous regular
+expressions), I’d be delighted to include it in the distribution.</p>
<h2><a name="install" id="install">Installation</a></h2>
<p>The <code>.bst</code> files have to be installed
-<a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=inst-wlcf">&#x2018;somewhere where LaTeX can find them&#x2019;</a>. If you give the command
+<a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=inst-wlcf">‘somewhere where LaTeX can find them’</a>. If you give the command
<code>kpsepath bst</code> you can see the list of directories that
-BibTeX searches for <code>.bst</code> files &#x2013; on my system, I'd put
+BibTeX searches for <code>.bst</code> files – on my system, I’d put
them into <code>/usr/local/texlive/texmf-local/bibtex/bst</code>,
which is a directory for system-wide local additions.</p>
<p>If you wish, you may change the distributed BibTeX style files (see
<a href="#bst-files">above</a>) to the extent of changing the
-`eprint' mirror site from the master <code>xxx.arxiv.org</code> to a
-more local mirror. If you don't use the LANL preprint archive, this
+‘eprint’ mirror site from the master <code>xxx.arxiv.org</code> to a
+more local mirror. If you don’t use the LANL preprint archive, this
will be of no interest to you.</p>
<h2><a name="usage" id="usage">The <em>bibhtml</em> script</a></h2>
-<p>As noted above, this script should still work and is distributed on
-that basis, but it's no longer maintained, and won't be further developed.</p>
+<p>As noted above, <strong>this script should still work and is distributed on
+that basis, but it’s no longer maintained, and won’t be further developed.</strong>
+The XSLT-based mechanism described above is probably more robust;
+also, the interface described in this section is not the same as the interface
+of the <a href="#xslt">XSLT scripts</a> section above.</p>
<h3>The BibTeX database</h3>
@@ -241,7 +250,7 @@ with these in future versions. </p>
composed of the BibTeX citation key. Thus, you might cite [grendel89]
with</p>
<pre>&lt;a href="bibliography.html#grendel89"&gt;(Grendel, 1989)&lt;/a&gt;</pre>
-<p>(of course, the link text can be anything you like). That's all there is to
+<p>(of course, the link text can be anything you like). That’s all there is to
it. When you run <em>bibhtml</em>, it generates an
<code>.aux</code> file which makes BibTeX produce references for exactly those
keys which appear in this way. </p>
@@ -258,7 +267,7 @@ and
<code>&lt;?bibhtml end ?&gt;</code>
(which should be on lines by themselves) with the formatted
bibliography. It leaves those instructions in place, naturally, so once
-this file is set up, you shouldn't have to touch it again. Older
+this file is set up, you shouldn’t have to touch it again. Older
versions of bibhtml used the magic comments <code>&lt;-- bibhtml start
--&gt;</code> and <code>&lt;-- bibhtml end --&gt;</code>: these are
still supported, but are deprecated and may disappear in a future version.</p>
@@ -275,12 +284,12 @@ example), which will not therefore have to be rescanned in future.</p>
the command line (see <a href="#options">below</a>) or using the
<code>&lt;?bibhtml bibdata </code><em>bibfile</em><code>?&gt;</code>
and <code>&lt;?bibhtml bibstyle</code><em>stylefile</em><code>?&gt;</code> instructions. The
-value of `bibdata' is cumulative, and appends to any value specified
-on the command line. A value of `bibstyle' specified on the command
+value of ‘bibdata’ is cumulative, and appends to any value specified
+on the command line. A value of ‘bibstyle’ specified on the command
line, in contrast, overrides any value in the file.</p>
<p>As a special case, <em>bibhtml</em> also replaces the line <em>after</em> a
-comment <code>&lt;?bibhtml today ?&gt;</code> with today's date.</p>
+comment <code>&lt;?bibhtml today ?&gt;</code> with today’s date.</p>
<p>Summary of processing instructions:</p>
@@ -307,7 +316,7 @@ of <code>\bibliographystyle{</code><em>stylefile</em><code>}</code>
command in a LaTex file; see also the <code>-s</code> command-line option.</dd>
<dt><code>&lt;?bibhtml today?&gt;</code></dt>
-<dd>Replace the <em>following</em> line by today's date.</dd>
+<dd>Replace the <em>following</em> line by today’s date.</dd>
</dl>
<h3><a name="options" id="options">Supported options</a></h3>
@@ -332,17 +341,17 @@ whatever has been specified as the bibliography file name. </p>
<dd>Set this to +3 if you want <code>~</code> translated to
<code>&amp;nbsp;</code>, and <code>--</code> to
<code>&amp;enspace;</code>. Or set it to -3 (the default) if you
-don't.</dd>
+don’t.</dd>
<dt>-a</dt>
-<dd>If this option is set, <em>bibhtml</em> won't bother scanning any
+<dd>If this option is set, <em>bibhtml</em> won’t bother scanning any
files at all, and will generate references for all the entries in your
database. This is equivalent to <code>\nocite{*}</code> in LaTeX.</dd>
<dt>-b bibdata</dt>
<dd>The name of your BibTeX database file, as it would be specified in a
<code>\bibliography{}</code> command in LaTeX. Unless <em>you</em> happen to
-keep all your references in a file called <code>bib.bib</code>, you'll
+keep all your references in a file called <code>bib.bib</code>, you’ll
probably want to change this. Or you can use the <code>&lt;?bibhtml
bibdata xxx?&gt;</code> <a href="#pis">processing instruction</a>.</dd>
@@ -353,7 +362,7 @@ options, which are inserted in the command line at that point.</dd>
<dt><a name="merge" id="merge">--merge</a></dt>
<dd>In this special case, <em>bibhtml</em> takes two arguments, a
<code>.bbl</code> file and an <code>.html</code> file,
-merges the first into the second, and nothing else. It's
+merges the first into the second, and nothing else. It’s
intended to be used when you have generated a
<code>.bbl</code> file by a separate run of BibTeX, and simply
wish to merge the results into your bibliography file. As
@@ -361,15 +370,15 @@ such, it will most likely be useful as part of a script, or
other post-processing system.</dd>
<dt>-r rootname</dt>
-<dd>Specify this and you'll create <code>rootname.html</code>,
+<dd>Specify this and you’ll create <code>rootname.html</code>,
<code>rootname.aux</code> and so on. Why not just stick with the default
-`bibliography'...? </dd>
+‘bibliography’...? </dd>
<dt><a name="opt-s" id="opt-s">-s bibstyle</a></dt>
<dd>The name of the BibTeX bibliography style you want to use, as it
would be specified for the <code>\bibstyle</code> command in
LaTeX. If you want to have a different layout for your HTML
-bibliographies, please don't change the file plainhtml.bst
+bibliographies, please don’t change the file plainhtml.bst
distributed with bibhtml. Instead, make a <em>copy</em> of
plainhtml.bst under a different name, edit it as much as you
like, and use this option of bibhtml to use the modified
@@ -392,8 +401,8 @@ verbose.</dd>
</dl>
<p>The defaults for the various parameters are unlikely to be helpful,
-so you're likely to want to set one or more of them every time you run
-the program. It is for this reason, and because you're likely to want
+so you’re likely to want to set one or more of them every time you run
+the program. It is for this reason, and because you’re likely to want
the same set of options every time you create the bibliography for a
set of files in a directory, that you can put a collection of options
in a configuration file. This can be specified on the command line
@@ -426,9 +435,10 @@ platforms. If so, please get in touch, with suggestions. </p>
<h2><a name="example" id="example">Example</a></h2>
<p>There are multiple sources of advice for how to cite electronic
-documents. The most formal are an ISO standard <a href="#url:iso690"><span class="cite">url:iso690</span></a>, and the American Psychological
-Association's guidance in Sect. 6.31 of <a href="#apastyle"><span class="cite">apastyle</span></a>. As well, there are older, but still
-useful discussions in <a href="#walker06"><span class="cite">walker06</span></a> and <a href="#emory95"><span class="cite">emory95</span></a>.</p>
+documents. The most formal are an ISO standard <h:a xmlns:h="http://www.w3.org/1999/xhtml" href="#url:iso690"><span class="cite">url:iso690</span></h:a>, and the American Psychological
+Association’s guidance in Sect. 6.31 of <h:a xmlns:h="http://www.w3.org/1999/xhtml" href="#apastyle"><span class="cite">apastyle</span></h:a>. As well, there are older but still
+useful discussions in <h:a xmlns:h="http://www.w3.org/1999/xhtml" href="#walker06"><span class="cite">walker06</span></h:a> and
+<h:a xmlns:h="http://www.w3.org/1999/xhtml" href="#emory95"><span class="cite">emory95</span></h:a>.</p>
<h2><a name="refs" id="refs">References</a></h2>
@@ -474,11 +484,11 @@ and at
<a href="http://purl.org/nxg/dist/bibhtml"><code>http://purl.org/nxg/dist/bibhtml</code></a>.</p>
<p>Download the distribution:
-<a href="bibhtml-2.0.tar.gz">bibhtml-2.0.tar.gz</a> or
-<a href="bibhtml-2.0.zip">bibhtml-2.0.zip</a>.</p>
+<a href="bibhtml-2.0.1.tar.gz">bibhtml-2.0.1.tar.gz</a> or
+<a href="bibhtml-2.0.1.zip">bibhtml-2.0.1.zip</a>.</p>
<p>Do <a href="mailto:norman@astro.gla.ac.uk">let me know</a> if
-you use this stuff. I'd be grateful for any bug reports,
+you use this stuff. I’d be grateful for any bug reports,
and bug fixes, and also for any comments on the clarity or
otherwise of this documentation.</p>
@@ -501,6 +511,9 @@ online copy of the GPL at <code><a href="http://www.gnu.org/copyleft/gpl.html">h
<dl>
+<dt>2.0.1, 2009 November 2</dt>
+<dd>The *date.bst and *dater.bst styles now work again.</dd>
+
<dt>2.0, 2009 August 9</dt>
<dd>First real release of v2.0, after mild use elsewhere.</dd>
@@ -555,7 +568,7 @@ inserts the bibliography in-place.</li>
<div class="signature">
<a href="http://nxg.me.uk">Norman</a><br />
-2009 August 9
+2009 November 2
</div>
</body>
diff --git a/Master/texmf-dist/doc/bibtex/bibhtml/detex.sed b/Master/texmf-dist/doc/bibtex/bibhtml/detex.sed
index 24034434203..795901bdf94 100644
--- a/Master/texmf-dist/doc/bibtex/bibhtml/detex.sed
+++ b/Master/texmf-dist/doc/bibtex/bibhtml/detex.sed
@@ -1,6 +1,6 @@
# Edit TeXisms in the .bbl output, to make it HTML-ready
-# From bibhtml release 2.0, of 2009 August 9.
-# Hg node 4a5600417b09.
+# From bibhtml release 2.0.1, of 2009 November 2.
+# Hg node 6ca3807543d6.
# See http://purl.org/nxg/dist/bibhtml
# Remove %\n line-breaks added by BibTeX
diff --git a/Master/texmf-dist/doc/bibtex/bibhtml/style.css b/Master/texmf-dist/doc/bibtex/bibhtml/style.css
new file mode 100644
index 00000000000..0f464d2b9ed
--- /dev/null
+++ b/Master/texmf-dist/doc/bibtex/bibhtml/style.css
@@ -0,0 +1,166 @@
+body {
+ color: #333;
+ background: white;
+ margin-left: +30%;
+ margin-right: +20%;
+ padding: 0.5em; /* this will make a difference if I decide to
+ have the background a different colour */
+ /* I can't decide on font: Optima's always nice, but Gill looks
+ agreeably intense. Helvetica's a decent fallback. */
+ font-family: "Helvetica Neue", "Gill Sans", gill, Helvetica, sans-serif;
+ /* font-family: Optima, "Gill Sans", gill, Helvetica, sans-serif; */
+ /* font-family: "Gill Sans", gill, Helvetica, sans-serif; */
+ font-size: 11pt;
+ line-height: 150%;
+}
+
+code, pre {
+ font-family: Monaco, fixed;
+ font-size: 9pt;
+}
+
+a { text-decoration: none; }
+a:link { color: #66C; }
+a:visited { color: #669; }
+a[href]:hover { background: #EEE; }
+
+div.abstract {
+ font-style: oblique;
+ text-align: left;
+}
+div.abstract em { font-style: normal; }
+div.abstract code {
+ font-style: normal;
+ font-size: 80%;
+}
+
+h1, h2, h3, h4, h5, h6 {
+ color: #822;
+ font-weight: 100; /* few fonts have ultra-light weights */
+ line-height: 100%; /* no need to spread out titles */
+}
+h1 {
+ margin-left: -40%;
+ margin-right: -5%;
+ padding: 0.5em;
+ border: solid #666;
+ text-align: right;
+}
+h2 {
+ margin-left: -40%;
+ margin-right: -5%;
+ padding: 0.2em;
+ border-top: solid thin #666;
+ clear: both;
+}
+h3 {
+ margin-left: -30%;
+ float: left;
+ width: 25%;
+ display: block;
+ text-align: right;
+ vertical-align: bottom;
+ padding-top: 0pt;
+ padding-right: 0.5em;
+ margin-top: 0pt;
+ line-height: 120%;
+}
+
+/*
+h4 {
+ color: #C66;
+}
+*/
+
+pre, table { background: #dde; }
+
+pre {
+ padding: 1em;
+ line-height: 130%;
+}
+
+table {
+ font-size: smaller;
+}
+td {
+ padding: 0.5ex;
+}
+
+Q:before { content: "“"; }
+Q:after { content: "”"; }
+
+img.smallimage {
+ float: right;
+ margin: 24pt;
+ margin-right: -30%;
+}
+
+div.signature {
+ margin-left: -40%;
+ margin-right: -5%;
+ text-align: right;
+ border: solid #666;
+ padding: 0.3em;
+ clear: both;
+}
+
+/* ============================================================
+ * Some other curiosities of my one-time formatting for web pages
+ */
+pre.doc-history {
+ font-size: xx-small;
+ background #eee;
+ line-height: 100%;
+}
+
+div.subtoc, div.subsubtoc { display: none; }
+
+/* ============================================================
+ * Special formatting for ToC
+ */
+
+/*
+ If there's significant amount of text in front of the first subsection,
+ then the following are good to put in the per-document stylesheet:
+ width: 25%;
+ float: right;
+*/
+div#toc {
+ color: #888;
+ padding: 0;
+ font-size: smaller;
+ text-align: right;
+}
+div#toc a:link { color: #888; }
+div#toc > ul {
+ padding: 0pt;
+ margin: 0pt;
+ list-style: none;
+}
+div#toc li {
+ padding: 0pt;
+ display: inline-block;
+}
+div#toc li:before {
+ content: "§ ";
+ margin-left: 1em;
+}
+/* the following elements aren't currently generated by structure.lx */
+div#toc li ul {
+ padding-left: 1em;
+ margin-left: 0;
+ font-style: italic;
+ display: inline;
+}
+div#toc li ul:before {
+ content: "( ";
+}
+div#toc li ul:after {
+ content: " ) ";
+}
+div#toc li li {
+ padding-left: 0pt;
+}
+div#toc li li:after {
+ content: "; ";
+}