diff options
Diffstat (limited to 'Master/texmf-dist/doc/bibtex/urlbst/urlbst.html')
-rw-r--r-- | Master/texmf-dist/doc/bibtex/urlbst/urlbst.html | 57 |
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> |