summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/bibtex/urlbst/README
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/bibtex/urlbst/README')
-rw-r--r--Master/texmf-dist/doc/bibtex/urlbst/README53
1 files changed, 42 insertions, 11 deletions
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