summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-ext
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-01-04 21:49:07 +0000
committerKarl Berry <karl@freefriends.org>2019-01-04 21:49:07 +0000
commit39eaa60079c4839f8ed7bcdcf907c6ce0e5e75ab (patch)
tree469f887f40d00b37bd475cd7daa4ca566905ace0 /Master/texmf-dist/doc/latex/biblatex-ext
parent0034d54351819457808cf0c8c3d6811269ad264f (diff)
biblatex-ext (4jan19)
git-svn-id: svn://tug.org/texlive/trunk@49597 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-ext')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md9
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-ext/README.md2
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdfbin622830 -> 624884 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex63
4 files changed, 53 insertions, 21 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md b/Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md
index 6ce20e69573..2336f09ec23 100644
--- a/Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md
+++ b/Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md
@@ -1,5 +1,12 @@
+# Version 0.6a (2019-01-04)
+See https://github.com/moewew/biblatex-ext/compare/v0.6...v0.6a
+- Only patch bibmacros in `biblatex-ext-oa`. This avoids redefinitions,
+ which could clear out custom definitions.
+- Use socket.url's URL escape/encode function in blxextdoiapi.lua.
+- Fix bug in deprecation handling.
+
# Version 0.6 (2018-11-23)
-See https://github.com/moewew/biblatex-ext/compare/v0.5a..v0.6
+See https://github.com/moewew/biblatex-ext/compare/v0.5a...v0.6
- Sync `mergedate` code with `biblatex` 3.12
(https://github.com/plk/biblatex/pull/810
https://github.com/plk/biblatex/issues/752).
diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/README.md b/Master/texmf-dist/doc/latex/biblatex-ext/README.md
index 8d2a26d2181..3b30f870068 100644
--- a/Master/texmf-dist/doc/latex/biblatex-ext/README.md
+++ b/Master/texmf-dist/doc/latex/biblatex-ext/README.md
@@ -73,7 +73,7 @@ standard styles. The bundle consists of the following files
## Licence
-Copyright 2017-2018 Moritz Wemheuer
+Copyright 2017-2019 Moritz Wemheuer
This work consists of the `.bbx`, `.cbx`, `.def`, `.sty` and `.lua` files
mentioned above.
diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf
index 2cca9afc1c5..bff09eebdcf 100644
--- a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf
+++ b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
index 92496b811be..fabe0af91e1 100644
--- a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
@@ -415,7 +415,7 @@
\newcommand*{\ctan}{\mkbibacro{CTAN}}
\newcommand*{\gitbaseurl}{https://github.com/moewew/biblatex-ext}
-\newcommand*{\extblxversion}{0.6}
+\newcommand*{\extblxversion}{0.6a}
\newcommand*{\biber}{Biber}
\newcommand*{\gitissuelink}[1]{%
\href{\gitbaseurl/issues/#1}{issue \##1 on github}}
@@ -463,7 +463,7 @@
author = {Moritz Wemheuer},
link = {mwemheu@gmail.com},%
revision = {\extblxversion},
- date = {\DTMDate{2018-11-23}},
+ date = {\DTMDate{2019-01-04}},
}
\hypersetup{%
@@ -609,7 +609,8 @@ If at all possible you should install this bundle via your \tex{} distribution
(using \miktex{} Console\fnurl{https://miktex.org/howto/miktex-console} or
\sty{tlmgr} for \texlive\fnurl{https://www.tug.org/texlive/pkginstall.html}).
If you must install this package manually, get the files from \ctan{}
-and install the \sty{.bbx}, \sty{.cbx} and \sty{.def} files preferably to
+and install the \sty{.bbx}, \sty{.cbx}, \sty{.def}, \sty{.sty} and \sty{.lua}
+files preferably to
\path{tex/latex/biblatex-ext} of your local or home \TeX{} tree%
\fnurl{https://texfaq.org/FAQ-inst-wlcf}, the other
files (\path{CHANGES.md}, \path{README.md}, \path{biblatex-ext.tex},
@@ -623,7 +624,7 @@ under the terms of the \lppl, version 1.3c%
\fnurl{https://www.latex-project.org/lppl/lppl-1-3c.txt}
or (at your option) any later version%
\fnurl{https://www.latex-project.org/lppl.txt}.
-This bundle is maintained by Moritz Wemheuer (\textcopyright 2017--2018).
+This bundle is maintained by Moritz Wemheuer (\textcopyright 2017--2019).
\subsection{Feedback}\label{sec:feedback}
@@ -671,8 +672,8 @@ available on \ctan\fnurl{https://ctan.org/pkg/latex-sciences-humaines}.
If you read German you may be interested in Dominik Waßenhoven's two-part
series \foreignlanguage{ngerman}{\emph{Bibliographien erstellen mit
\sty{biblatex}}} in \foreignlanguage{ngerman}{\emph{Die \TeX nische Komödie}}
-2/2008\fnurl{http://www.dante.de/DTK/Ausgaben/2008-2.pdf} (pp.~53--75)
-and 4/2008\fnurl{http://www.dante.de/DTK/Ausgaben/2008-4.pdf} (pp.~31--51).
+2/2008\fnurl{https://www.dante.de/DTK/Ausgaben/2008-2.pdf} (pp.~53--75)
+and 4/2008\fnurl{https://www.dante.de/DTK/Ausgaben/dtk08-4.pdf} (pp.~31--51).
Please keep in mind that some of these texts were written a while ago and
that \sty{biblatex} is actively developed: technical details may have changed
and new features make some things easier.
@@ -2375,9 +2376,16 @@ by pluton\fnurl{https://tex.stackexchange.com/users/371/pluton} on TeX.SX
about promoting open access works by adding a small open access symbol into
the margin.
-The package must be loaded after \sty{biblatex}
-and is not tied to use with styles of this bundle, though it can not be
-guaranteed that everything will work out of the box with other styles.
+The package must be loaded after \sty{biblatex}.
+It is not tied to use with styles of this bundle, though it can not be
+guaranteed that everything will work out of the box with all other styles.
+The package works as expected with the standard styles and
+should work with most contributed styles at least to some extent.
+For the actual typesetting of the symbol \sty{biblatex-ext-oa}
+patches the bibliography macro \bibmacro{begentry} to include a call to the
+bibliography macro \bibmacro{oamark}.
+That means that you have to keep in mind this behaviour should you want to
+redefine \bibmacro{begentry} yourself.
\begin{biblatexcode}
\usepackage[(*@\prm{\sty{biblatex} options}@*)]{biblatex}
(*@\dots @*)
@@ -2409,10 +2417,10 @@ If the package is loaded with \opt{enable} set to \opt{false} the global
bibliography option \opt{openaccess} will be set to \opt{false} and no sensible
defaults are defined for the semi-automatic open access detection.
-\optitem[false]{tikzsymbol}{\opt{true}, \opt{false}, \prm{string}}
+\optitem[false]{tikzsymbol}{\opt{true}, \opt{false}, \prm{symbol identifier}}
Load the support package \sty{biblatex-ext-oa-tikzsymbols} with its load-time
-option \opt{symbol} set to \prm{string}.
+option \opt{symbol} set to \prm{symbol identifier}.
The values \opt{true} and \opt{false} are provided for convenience.
\opt{false} does not load the package at all, \opt{true} is like giving the
value \opt{plos}.
@@ -2422,7 +2430,7 @@ as well as a short note on their respective licenses.
\marginwarn Note that \sty{biblatex-ext-oa-tikzsymbols} will load \pgftikz
\fnurl{https://ctan.org/pkg/pgf} to draw the open access symbols.
-If you prefer a more light-weight solution you can define a symbol yourself
+If you prefer a more light-weight solution, you can define a symbol yourself
with an external graphics file.
\marginwarn
@@ -2501,12 +2509,15 @@ open access URL may not be amongst the fields that are already displayed
in the entry.
\end{keymarglistbook}
-With \opt{enable} set to \opt{true} the package will furtermore redefine the
-bibliography macro \bibmacro{begentry} to execute the bibliography macro
+\marginwarn
+With \opt{enable} set to \opt{true} the package will furtermore patch
+the bibliography macro \bibmacro{begentry} to execute the bibliography macro
\bibmacro{oamark}.
-If additionally \opt{doiapi} is \opt{true} the bibliography macro
-\bibmacro{doi+eprint+url} will be redefined to include a call to
+If additionally \opt{doiapi} is \opt{true}, the bibliography macro
+\bibmacro{doi+eprint+url} will be patched to include a call to
\bibmacro{api:bestoaurl}.
+Please keep that in mind should you need to redefine \bibmacro{begentry}
+or \bibmacro{doi+eprint+url}.
\subsection{Open access detection}\label{sec:oa:detect}
The heart of the package \sty{biblatex-ext-oa} is the bibliography option
@@ -2758,7 +2769,7 @@ If the package is loaded and no email was provided until the
beginning of the document (as tested in an \cmd{AtBeginDocument} hook)
you will recieve a warning.
A fatal error will be thrown if you try to query the Unpaywall database
-without an email.
+without an email address.
\cmditem{SetDOIAPICacheExpiration}{days}
@@ -2803,8 +2814,10 @@ for \cmd{oasymbol}.
\item[plos] Use the open access symbol by PLOS | Public Library of Science%
\fnurl{https://www.plos.org/} \csuse{extblx@oasymbol@plos}.
- The drawing is based on a CC0 work by PLoS, modified by Wikipedia users
- Nina, Beao, and JakobVoss%
+ The drawing is based on a CC0%
+ \fnurl{https://creativecommons.org/publicdomain/zero/1.0/deed.en}
+ work by PLoS (now PLOS | Public Library of Science),
+ modified by Wikipedia users Nina, Beao, and JakobVoss%
\fnurl{https://commons.wikimedia.org/wiki/File:Open_Access_logo_PLoS_white.svg}.
\item[oanet] Use the open access symbol by open-access.net%
@@ -2839,6 +2852,15 @@ for \cmd{oasymbol}.
\fnurl{https://open-access.net/DE-EN/about-us/}.
While the German version leaves some leeway as to whether or not a link is
required as attribution, the English version seems more explicit.
+
+ That means that if you do not follow Wikimedia in considering the symbol
+ not protected by copyright in your~-- and all other relevant jurisdictions%
+ ~-- due to its failure to cross the threshold of originality,
+ you should probably treat it as CC BY 4.0 and treat the link to
+ \url{https://open-access.net} as attribution requested by the Licensor
+ according to Section 3(a)(1)(A) of the license.
+ If you can't reasonably meet the requirements of the license in your work,
+ you may want to consider using the PLOS logo, which is licensed under CC0.
\end{valuelist}
\end{optionlist}
@@ -2858,6 +2880,9 @@ See also \sty{CHANGES.md}.
The numbers on the right indicate the relevant section of the manual.
\begin{changelog}
+\begin{release}{0.6a}{2019-01-04}
+ \item Minor improvements for \sty{biblatex-ext-oa}\see{sec:oasymb}
+\end{release}
\begin{release}{0.6}{2018-11-23}
\item Require \sty{biblatex} 3.12
\item Make \opt{dashed} and \opt{introcite} options available on a per-entry