summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/bibtex/urlbst/urlbst.html
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/bibtex/urlbst/urlbst.html')
-rw-r--r--Master/texmf-dist/doc/bibtex/urlbst/urlbst.html57
1 files changed, 47 insertions, 10 deletions
diff --git a/Master/texmf-dist/doc/bibtex/urlbst/urlbst.html b/Master/texmf-dist/doc/bibtex/urlbst/urlbst.html
index a169d5b1971..c057564bd63 100644
--- a/Master/texmf-dist/doc/bibtex/urlbst/urlbst.html
+++ b/Master/texmf-dist/doc/bibtex/urlbst/urlbst.html
@@ -20,7 +20,7 @@ hypertex/hyperref support.</p>
<p>The Persistent URL for this page is
<code>http://purl.org/nxg/dist/urlbst</code>.</p>
-<p>Version 0.6-5, 2011 March 8.</p>
+<p>Version 0.7, 2011 July 20.</p>
</div>
<p>Contents</p>
@@ -52,13 +52,18 @@ eprint fields. Fuller details are in the <a href="urlbst.pdf"
<h2><a name='usage'>Usage</a></h2>
<pre>
-urlbst [--eprint] [--doi] [--pubmed]
+urlbst [--[no]eprint] [--[no]doi] [--[no]pubmed]
[--inlinelinks] [--nohyperlinks] [--hypertex] [--hyperref]
+ [--literal key=value]
[input-file [output-file]]
</pre>
-<p>if either the input-file or the output-file is omitted, they default
-to stdin and stdout respectively. If the input file already has a URL
-entry type, then the script objects.</p>
+<p>If either the input-file or the output-file is omitted, they
+default to stdin and stdout respectively. If the input file already
+has a URL entry type, then the script objects.
+By default (in the current version), the output
+includes support for eprint, doi and pubmed, but these can be disabled
+by <code>--noeprint</code>, <code>--nodoi</code> and
+<code>--nopubmed</code>, respectively.</p>
<p>The added fields are:</p>
<ul>
@@ -93,6 +98,26 @@ hyperlink may be useful to anyone who reads your document online
produced as a result of the appropriate option will still appear in
this mode.</p>
+<p>You may adjust various literal strings, either for the purposes of
+internationalisation, or simply because you prefer different text. To
+do this, give the <code>--literal</code> option, followed by a
+<code>key=value</code> pair, for example <code>--literal online="on
+th'intert00bs"</code>, to replace the default <code>URL:</code> text.
+The possible values, and their defaults, are below (say
+<code>--literal help</code> to get this list printed out):</p>
+<table>
+<tr><th>keyword</th><th>default</th><th>meaning</th></tr>
+<tr><td>cited</td><td>cited</td><td>indicator of citation, or "last checked", date</td></tr>
+<tr><td>doiprefix</td><td>doi:</td><td>text printed before DOI</td></tr>
+<tr><td>eprintprefix</td><td>arXiv:</td><td>text printed before eprint
+ref</td></tr>
+<tr><td>linktext</td><td>[link]</td><td>fallback link text</td></tr>
+<tr><td>pubmedprefix</td><td>PMID:</td><td>text printed before PUBMED reference</td></tr>
+<tr><td>online</td><td>online</td><td>indication that resource is online</td></tr>
+<tr><td>urlintro</td><td>URL:</td><td>location of online resource (an
+alternative is "Available from:")</td></tr>
+</table>
+
<p>The distribution includes preconverted versions of the four
standard BibTeX .bst style files.</p>
@@ -107,7 +132,7 @@ siam.bst, mla.bst
<p>Style files which are known to fail:</p>
<ul>
-<li>Currently (v0.5), there exists a style <code>achicago.bst</code>
+<li>Currently (as of at least v0.5), there exists a style <code>achicago.bst</code>
which seems to fox <code>urlbst</code>; it turns out that there's a
simpler but almost equivalent style <code>chicago.bst</code> which
works.</li>
@@ -122,7 +147,12 @@ not designed to produce conventional <code>.bbl</code> files, and
</ul>
<p>This might be a good time for me to revisit the rather
convoluted logic within the script, to make it a little more robust in
-the face of variants like these, but don't hold your breath...</p>
+the face of variants like these, but don't hold your breath. The
+logic within the script is pretty hideous (it essentially works by
+spotting patterns in the input style file, and replacing or extending
+bits of BibTeX style-file code. This is a fragile technique, and is
+probably at the limits of its usefulness, therefore I'd take some
+persuading to add significant extra functionality to the script.</p>
<p>The natbib and revtex style files already have URL fields. If you have a
BibTeX style file which you think ought to work, but with which the
@@ -156,9 +186,9 @@ FAQ</a>.</p>
<h2><a name='download'>Download and installation</a></h2>
<p>Download the file as a
-<a href="urlbst-0.6-5.tar.gz" >tarball</a>
+<a href="urlbst-0.7.tar.gz" >tarball</a>
or
-<a href="urlbst-0.6-5.zip" >zip file</a>
+<a href="urlbst-0.7.zip" >zip file</a>
and unpack it. Or you can clone the source repository at
<a href='http://bitbucket.org/nxg/urlbst/'>bitbucket.org</a>.</p>
@@ -284,6 +314,13 @@ General Public Licence.</p>
<h2><a name='history'>Version history</a></h2>
<dl>
+<dt><strong>0.7, </strong></dt>
+<dd>Add --nodoi, --noeprints and --nopubmed options (which defaulted
+on, and couldn't otherwise be turned off)</dd>
+
+<dt>0.7b1, 2011 March 17</dt>
+<dd>Allow parameterisation of literal strings, with option <code>--literal</code>.</dd>
+
<dt>0.6-5, 2011 March 8</dt>
<dd>Adjust support for inline links (should now work for arXiv, DOI and Pubmed)</dd>
@@ -367,7 +404,7 @@ documentation added.</dd>
<div class="signature">
<a href="http://nxg.me.uk"
>Norman Gray</a><br/>
-2011 March 8
+2011 July 20
</div>
</body>