diff options
Diffstat (limited to 'Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex')
-rw-r--r-- | Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex | 134 |
1 files changed, 125 insertions, 9 deletions
diff --git a/Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex b/Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex index 4cbf3910dd2..7743ce05641 100644 --- a/Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex +++ b/Master/texmf-dist/doc/bibtex/urlbst/urlbst.tex @@ -2,7 +2,7 @@ \title{The \texttt{urlbst} package} \author{Norman Gray\\\texttt{<http://nxg.me.uk>}} -\date{Version 0.7, 2011 July 20} +\date{Version 0.8, 2019 July 1} %\usepackage{times} \usepackage{url} @@ -52,7 +52,7 @@ The added fields are: a reference, along with the date at which the URL was last checked to exist; \item \btfield{doi}, for a reference's DOI - (see \url{http://doi.org}); + (see \url{https://doi.org}); \item \btfield{eprint}, for an arXiv eprint reference (see \url{http://arxiv.org}); and \item \btfield{pubmed} for a reference's PubMed identifier @@ -62,7 +62,7 @@ The added fields are: Usage is simple: \begin{verbatim} % urlbst [--eprint] [--doi] [--pubmed] - [--nohyperlinks] [--inlinelinks] [--hypertex] [--hyperref] + [--nohyperlinks] [--inlinelinks] [--hypertex] [--hyperref] [input-file [output-file]] \end{verbatim} where the |input-file| is an existing |.bst| file, and @@ -134,7 +134,7 @@ output, however, then the script encloses the |\url| command in an appropriate Hyper\TeX\ special. When the style file generates a link for DOIs, it does so by -prepending the string \texttt{http://dx.doi.org/} to the DOI. This is +prepending the string \texttt{https://doi.org/} to the DOI. This is generally reasonable, but some DOIs have characters in them which are illegal in URLs, with the result that the resulting \texttt{dx.doi.org} URL doesn't work. The only real way of resolving @@ -228,7 +228,7 @@ not appear to materially disagree. ISO-690~\cite{url:iso690} is a formal standard for this stuff. Walker and Taylor's \emph{Columbia Guide to Online Style}~\cite{walker06} provides extensive coverage (but is only available on dead trees). -There are two style guides associated with the APA, namely +There are two style guides associated with the APA, namely the published APA style guide~\cite{apastyle} (a paper-only publication, so should be ignored by all, if there's any justice in the world), and what appears @@ -271,10 +271,126 @@ generated bibliographies. See also the URL entry in the UK \TeX\ FAQ~\cite{texfaq}, and references therein. -\textbf{Acknowledgements:} Thanks to Jason Eisner for suggesting -the |--inlinelinks| option, to Pawe\l{} Widera for the -suggestion to use |\path| when formatting DOIs and to Michael Giffin -for the suggestion to include PubMed URLs. +%% \textbf{Acknowledgements:} Thanks +%% to Jason Eisner for suggesting the |--inlinelinks| option; +%% to `ijvm' for code contributions in the |urlbst| script; +%% to Pawe\l{} Widera for the suggestion to use |\path| when formatting DOIs; +%% to Michael Giffin for the suggestion to include PubMed URLs; +%% to Katrin Leinweber for the pull request which fixed the format of DOI +%% references. + +\section{Acknowledgements, and release notes} + +%%% include:release-notes.tex + + +Thanks are due to many people for suggestions and requests: +to Jason Eisner for suggesting the |--inlinelinks| option; +to ‘ijvm’ for code contributions in the |urlbst| script; +to Paweł Widera for the suggestion to use |\path| when formatting DOIs; +to Michael Giffin for the suggestion to include PubMed URLs; +to Katrin Leinweber for the pull request which fixed the format of DOI +references. + +\begin{description} +\item[\textbf{0.8, 2019 July 1}]\relax +\begin{itemize} +\item The presence of a preexisting |format.doi|, +|format.eprint| or |format.pubmed| function is +now detected, and warned about. The resulting |.bst| file +might still require some manual editing. +Resolves issue 8\footnote{\url{https://bitbucket.org/nxg/urlbst/issue/8}}. +\item Clarified licences (I hope). +\item Adjust format of DOI resolver. +Resolves issue 11\footnote{\url{https://bitbucket.org/nxg/urlbst/issue/11}}, +thanks to +code contributed by Katrin Leinweber\footnote{\url{https://bitbucket.org/nxg/urlbst/pull-requests/1/}}. +\end{itemize} + + +\item[0.7, 2011 July 20]\relax +Add |--nodoi|, |--noeprints| and |--nopubmed| options (which defaulted +on, and couldn't otherwise be turned off) + +\item[0.7b1, 2011 March 17]\relax +Allow parameterisation of literal strings, with option |--literal|. + +\item[0.6-5, 2011 March 8]\relax +Adjust support for inline links (should now work for arXiv, DOI and Pubmed) + +\item[0.6-4, 2009 April 28]\relax +Work around BibTeX linebreaking bug (thanks to Andras Salamon for the bug report). + +\item[0.6-3, 2009 April 19]\relax +Fix inline link generation (thanks to Eric Chamberland for the bug report). + +\item[0.6-2, 2008 November 17]\relax +We now turn on inlinelinks when we spot format.vol.num.pages, +which means we include links for those styles which don't include a +title in the citation (common for articles in physical science styles, +such as aip.sty). + +\item[0.6-1, 2008 June 16]\relax +Fixed some broken links to the various citation standards +(I think in this context this should probably \emph{not} be happening, yes?). +The distributed |*url.bst| no longer have the +|--inlinelinks| option turned on by default. + +\item[\textbf{0.6, 2007 March 26}]\relax +\begin{itemize} +\item Added the option |--inlinelinks|, which adds inline hyperlinks +to any bibliography entries which have URLs, but does so inline, rather +than printing the URL explicitly in the bibliography. This is (primarily) +useful if you're preparing a version of a document which will be read +on-screen. Thanks to Jason Eisner for the suggestion, and much testing. + +\item Incorporate hyperref bugfixes from Paweł Widera. + +\item Further reworkings of the inlinelinks support, so that it's now +fired by a |format.title| (or |format.btitle|) line, with a fallback in +|fin.entry|. This should be more robust, and allows me to delete some +of the previous version's gymnastics. + +\item Reworked |inlinelinks| support; should now be more +robust. Incorporate hyperref bugfixes from Paweł Widera. + +\item Added the option |inlinelinks|, which adds inline hyperlinks +to any bibliography entries which have URLs, but does so inline, rather +than printing the URL explicitly in the bibliography. This is (only) +useful if you're preparing a version of a document which will be read +on-screen. +\end{itemize} + + +\item[0.5.2, 2006 September 6]\relax +Another set of documentation-only changes, hopefully clarifying +installation. + +\item[0.5.1, 2006 January 10]\relax +No functionality changes. Documentation and webpage changes only, +hopefully clarifying usage and configuration + +\item[\textbf{0.5, 2005 June 3}]\relax +Added support for Digital Object Identifiers (DOI) fields in +bibliographies. + +\item[0.4-1, 2005 April 12]\relax +Documentation improvements -- there are now examples in the help text! + +\item[\textbf{0.4, 2004 December 1}]\relax +Bug fixes: now compatible with mla.bst and friends. +Now uses |./configure| (optionally). Assorted reorganisation. + +\item[\textbf{0.3, 2003 June 4}]\relax +Added |--eprint|, |--hypertex| and |--hyperref| options. + +\item[\textbf{0.2, 2002 October 23}]\relax +The `editor' field is now supported in the webpage entry type. Basic +documentation added. + +\item[\textbf{0.1, 2002 April}]\relax +Initial version +\end{description} \bibliography{urlbst} \bibliographystyle{plainurl} |