diff options
Diffstat (limited to 'Master/texmf-dist/doc/bibtex')
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">‘somewhere where LaTeX can find them’</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 – 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><a href="bibliography.html#grendel89">(Grendel, 1989)</a></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><?bibhtml end ?></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><-- bibhtml start --></code> and <code><-- bibhtml end --></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><?bibhtml bibdata </code><em>bibfile</em><code>?></code> and <code><?bibhtml bibstyle</code><em>stylefile</em><code>?></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><?bibhtml today ?></code> with today's date.</p> +comment <code><?bibhtml today ?></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><?bibhtml today?></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>&nbsp;</code>, and <code>--</code> to <code>&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><?bibhtml bibdata xxx?></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: "; "; +} |