From 478adaf203776806f691f866da35e243690198a0 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 21 Jul 2011 23:39:10 +0000 Subject: urlbst 0.7 (21jul11) git-svn-id: svn://tug.org/texlive/trunk@23198 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/bibtex/urlbst/README | 53 ++++++++++--- Master/texmf-dist/doc/bibtex/urlbst/VERSION | 2 +- Master/texmf-dist/doc/bibtex/urlbst/urlbst | 87 +++++++++++++++------ Master/texmf-dist/doc/bibtex/urlbst/urlbst.bib | 21 ++--- Master/texmf-dist/doc/bibtex/urlbst/urlbst.html | 57 +++++++++++--- Master/texmf-dist/doc/bibtex/urlbst/urlbst.html.in | 49 ++++++++++-- Master/texmf-dist/doc/bibtex/urlbst/urlbst.in | 85 ++++++++++++++------ Master/texmf-dist/doc/bibtex/urlbst/urlbst.pdf | Bin 184859 -> 210289 bytes Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex | 18 +++-- Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex.in | 16 ++-- 10 files changed, 292 insertions(+), 96 deletions(-) (limited to 'Master/texmf-dist/doc/bibtex/urlbst') diff --git a/Master/texmf-dist/doc/bibtex/urlbst/README b/Master/texmf-dist/doc/bibtex/urlbst/README index a34caec73fe..38dfabd93d0 100644 --- a/Master/texmf-dist/doc/bibtex/urlbst/README +++ b/Master/texmf-dist/doc/bibtex/urlbst/README @@ -22,7 +22,7 @@ The Persistent URL for this page is hhttttpp::////ppuurrll..oorrgg//nnxxgg//ddiisstt//uurrllbbsstt &. - Version 0.6‐5, 2011 March 8. + Version 0.7, 2011 July 20. Contents @@ -59,13 +59,16 @@ and eprint fields. Fuller details are in the manual. 11.. UUssaaggee - uurrllbbsstt [[‐‐‐‐eepprriinntt]] [[‐‐‐‐ddooii]] [[‐‐‐‐ppuubbmmeedd]] [[‐‐‐‐iinnlliinneelliinnkkss]] - [[‐‐‐‐nnoohhyyppeerrlliinnkkss]] [[‐‐‐‐hhyyppeerrtteexx]] [[‐‐‐‐hhyyppeerrrreeff]] [[iinnppuutt‐‐ffiillee - [[oouuttppuutt‐‐ffiillee]]]] + uurrllbbsstt [[‐‐‐‐[[nnoo]]eepprriinntt]] [[‐‐‐‐[[nnoo]]ddooii]] [[‐‐‐‐[[nnoo]]ppuubbmmeedd]] + [[‐‐‐‐iinnlliinneelliinnkkss]] [[‐‐‐‐nnoohhyyppeerrlliinnkkss]] [[‐‐‐‐hhyyppeerrtteexx]] [[‐‐‐‐hhyyppeerr‐‐ + rreeff]] [[‐‐‐‐lliitteerraall kkeeyy==vvaalluuee]] [[iinnppuutt‐‐ffiillee [[oouuttppuutt‐‐ffiillee]]]] - if either the input‐file or the output‐file is omitted, + 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 dis‐ +abled by ‐‐‐‐nnooeepprriinntt , ‐‐‐‐nnooddooii and ‐‐‐‐nnooppuubbmmeedd , respectively. The added fields are: @@ -101,6 +104,21 @@ used with ‐‐‐‐hhyyppeerrrreeff or ‐‐‐‐hhyyppeer text which would be produced as a result of the appropriate option will still appear in this mode. + You may adjust various literal strings, either for the +purposes of internationalisation, or simply because you pre‐ +fer different text. To do this, give the ‐‐‐‐lliitteerraall option, +followed by a kkeeyy==vvaalluuee pair, for example ‐‐‐‐lliitteerraall +oonnlliinnee==""oonn tthh’’iinntteerrtt0000bbss"" , to replace the default UURRLL:: +text. The possible values, and their defaults, are below +(say ‐‐‐‐lliitteerraall hheellpp to get this list printed out): keyword‐ +defaultmeaning citedcitedindicator of citation, or "last +checked", date doiprefixdoi:text printed before DOI eprint‐ +prefixarXiv:text printed before eprint ref link‐ +text[link]fallback link text pubmedprefixPMID:text printed +before PUBMED reference onlineonlineindication that resource +is online urlintroURL:location of online resource (an alter‐ +native is "Available from:") + The distribution includes preconverted versions of the four standard BibTeX .bst style files. @@ -113,10 +131,10 @@ ieeetr.bst, siam.bst, mla.bst Style files which are known to fail: -* Currently (v0.5), there exists a style aacchhiiccaaggoo..bbsstt - which seems to fox uurrllbbsstt ; it turns out that there’s a - simpler but almost equivalent style cchhiiccaaggoo..bbsstt which - works. +* Currently (as of at least v0.5), there exists a style + aacchhiiccaaggoo..bbsstt which seems to fox uurrllbbsstt ; it turns out + that there’s a simpler but almost equivalent style + cchhiiccaaggoo..bbsstt which works. * Some APA‐like styles, including at least aappaaggeerr..bbsstt , seem to be sufficiently different from the most common @@ -129,7 +147,13 @@ ieeetr.bst, siam.bst, mla.bst 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... +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 per‐ +suading to add significant extra functionality to the +script. The natbib and revtex style files already have URL fields. If you have a BibTeX style file which you think @@ -273,6 +297,13 @@ terms of the GNU General Public Licence. 55.. VVeerrssiioonn hhiissttoorryy + _0_._7_, Add ‐‐nodoi, ‐‐noeprints and ‐‐nopubmed options + (which defaulted on, and couldn’t otherwise be turned + off) + + 00..77bb11,, 22001111 MMaarrcchh 1177 Allow parameterisation of literal + strings, with option ‐‐‐‐lliitteerraall &. + 00..66‐‐55,, 22001111 MMaarrcchh 88 Adjust support for inline links (should now work for arXiv, DOI and Pubmed) @@ -348,5 +379,5 @@ Thanks to Jason Eisner for the suggestion, and much testing. _0_._1_, _2_0_0_2 _A_p_r_i_l Initial version - Norman Gray 2011 March 8 + Norman Gray 2011 July 20 diff --git a/Master/texmf-dist/doc/bibtex/urlbst/VERSION b/Master/texmf-dist/doc/bibtex/urlbst/VERSION index 3a3f6d04e37..a404769b324 100644 --- a/Master/texmf-dist/doc/bibtex/urlbst/VERSION +++ b/Master/texmf-dist/doc/bibtex/urlbst/VERSION @@ -1 +1 @@ -urlbst-0.6-5b1 +urlbst-0.7 diff --git a/Master/texmf-dist/doc/bibtex/urlbst/urlbst b/Master/texmf-dist/doc/bibtex/urlbst/urlbst index 4cdae07ce5e..9c3516a5df1 100755 --- a/Master/texmf-dist/doc/bibtex/urlbst/urlbst +++ b/Master/texmf-dist/doc/bibtex/urlbst/urlbst @@ -10,7 +10,7 @@ # # $Id$ -$version = '0.6-5'; +$version = '0.7'; ($progname = $0) =~ s/.*\///; $mymarker = "% $progname"; $mymarkerend = "% ...$progname to here"; @@ -21,24 +21,28 @@ $infile = '-'; $outfile = '-'; $addeprints = 1; # if true (nonzero) we add support for eprints -$eprintprefix = 'arXiv:'; # make these settable with --eprint? syntax? +$literals{eprintprefix} = 'arXiv:'; # make these settable with --eprint? syntax? $eprinturl = 'http://arxiv.org/abs/'; $adddoiresolver = 1; -$doiprefix = 'doi:'; +$literals{doiprefix} = 'doi:'; $doiurl = 'http://dx.doi.org/'; $addpubmedresolver = 1; -$pubmedprefix = 'PMID:'; +$literals{pubmedprefix} = 'PMID:'; $pubmedurl = 'http://www.ncbi.nlm.nih.gov/pubmed/'; $makehref = 0; -$availablestring = "Available from: "; +$literals{urlintro} = "URL: "; $inlinelinks = 0; +$literals{online} = "online"; +$literals{cited} = "cited "; +$literals{linktext} = "[link]"; + $automatic_output_filename = 0; -$Usage = "$progname [--eprint] [--doi] [--pubmed]\n [--nohyperlinks] [--[no]inlinelinks] [--hypertex] [--hyperref]\n [--help] [input-file [output-file]]"; +$Usage = "$progname [--eprint] [--doi] [--pubmed]\n [--nohyperlinks] [--[no]inlinelinks] [--hypertex] [--hyperref]\n [--literal key=value]\n [--help] [input-file [output-file]]"; # Magic environment variable: if this is set, then we're being called from a Platypus wrapper # See http://www.sveinbjorn.org/platypus @@ -49,10 +53,16 @@ if ($ENV{"CALLED_FROM_PLATYPUS"}) { while ($#ARGV >= 0) { if ($ARGV[0] eq '--eprint') { $addeprints = 1; + } elsif ($ARGV[0] eq '--noeprint') { + $addeprints = 0; } elsif ($ARGV[0] eq '--doi') { $adddoiresolver = 1; + } elsif ($ARGV[0] eq '--nodoi') { + $adddoiresolver = 0; } elsif ($ARGV[0] eq '--pubmed') { $addpubmedresolver = 1; + } elsif ($ARGV[0] eq '--nopubmed') { + $addpubmedresolver = 0; } elsif ($ARGV[0] eq '--nohyperlinks') { $makehref = 0; } elsif ($ARGV[0] eq '--hypertex') { @@ -65,21 +75,48 @@ while ($#ARGV >= 0) { $inlinelinks = 0; } elsif ($ARGV[0] eq '--automatic-output') { $automatic_output_filename = 1; + } elsif ($ARGV[0] eq '--literal') { + shift; + my $showstrings = 0; + if ((($k, $v) = ($ARGV[0] =~ /^(\w+)=(.*)/)) && exists $literals{$k}) { + $literals{$k} = $v; + } elsif ($ARGV[0] eq 'help') { + $showstrings = 1; + } else { + print "No literal found in $ARGV[0]; ignoring that\n"; + $showstrings = 1; + } + if ($showstrings) { + print " Possible literal strings (and defaults) are...\n"; + while (($k, $v) = each (%literals)) { + print " $k ($v)\n"; + } + exit(0); + } } elsif ($ARGV[0] eq '--help') { print <

The Persistent URL for this page is http://purl.org/nxg/dist/urlbst.

-

Version 0.6-5, 2011 March 8.

+

Version 0.7, 2011 July 20.

Contents

@@ -52,13 +52,18 @@ eprint fields. Fuller details are in the Usage
-urlbst [--eprint] [--doi] [--pubmed]
+urlbst [--[no]eprint] [--[no]doi] [--[no]pubmed]
            [--inlinelinks] [--nohyperlinks] [--hypertex] [--hyperref]
+           [--literal key=value]
            [input-file [output-file]]
 
-

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.

+

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 --noeprint, --nodoi and +--nopubmed, respectively.

The added fields are: