diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/biblatex-realauthor.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/biblatex-realauthor.tex | 39 |
1 files changed, 32 insertions, 7 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/biblatex-realauthor.tex b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/biblatex-realauthor.tex index bafc76165ff..d6cf3363a70 100644 --- a/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/biblatex-realauthor.tex +++ b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/biblatex-realauthor.tex @@ -20,8 +20,8 @@ subtitle={New data field}, email={maieul <at> maieul <dot> net}, author={Maïeul Rouquette}, - revision={2.3.0}, - date={03/11/2016}, + revision={2.4.0}, + date={06/05/2016}, url={https://github.com/maieul/biblatex-realauthor}} % biblatex @@ -36,6 +36,8 @@ The standard biblatex fields allow to describe the author of a work, with the so called \bibfield{authors} field. However, some works are published without name, or with pseudonyme, but the scholars know the real author. This package adds a new field \bibfield{realauthor}, to specify the knew real author. +It also add a new field \bibfield{realeditor}, to specify the knew real editor. + \section{Basic use} \subsection{Requirement} @@ -43,7 +45,7 @@ The standard biblatex fields allow to describe the author of a work, with the so The packages require \biblatex~3.3 or later. \subsection{The .bib file} -Basically, you just have to add the real author name in the field \bibfield{realauthor}, like in the two following examples: +Basically, you just have to add the real author / editor name in the field \bibfield{realauthor} / \bibfield{realdeditor}, like in the following examples: \inputminted{tex}{example-realauthor.bib} @@ -55,7 +57,19 @@ When loading the \biblatex package, use the \namebibstyle{realauthor} bibstyle, \usepackage[citestyle=verbose,bibstyle=realauthor]{biblatex} \end{minted} -Not that the package patches \verb+author+ and \verb+author/editor+others/translator+others+ macro. If you redefine them, don't forget the patches\footnote{We suppose that, if you redefine them, you could understand the packages.}. +Not that the package patches some bibmacro. +If you redefine them, don't forget the patches\footnote{We suppose that, if you redefine them, you could understand the packages.}. +Here the list of macro patched: +\begin{itemize} + \item author; + \item author/editor+others; + \item author/translator+others; + \item author/editor+others/translator+others; + \item bbx:editor; + \item byeditor; + \item byeditor+others; + \item cite:name (patched at the beginning of the document); +\end{itemize} \subsection{Example of result} @@ -80,13 +94,15 @@ Note that this field is not affected by \verb+useauthor+ option, but it is by \v Used in a bibliography macro or driver, \cmd{ifuserealauthor}\mprm{true}\mprm{false} expands to \prm{true} if the \opt{userealauthor} option is enabled (either globally or for the current entry), and \prm{false} otherwise. +There is also a \verb+userealeditor+ option and a \cmd{ifuserealeditor} field, similar, but for \bibfield{realeditor} field. + \subsection{Sorting}\label{sorting} The default sorting schemes \verb+nty+ is problematic, because it doesn't consider the \bibfield{realauthor} field as a name. That is why the package provides two sorting scheme: \begin{itemize} - \item \verb|anonymous|, which but considers the \bibfield{realauthor} field to sort list by authors' name. If an entry has both \bibfield{realauthor} and \bibfield{author}, only the \bibfield{author} field we be used. - \item \verb|anonymous+realauthor|, which push the anonymous texts at the begininng of the list (as the \verb+anonymous+ sorting of the \emph{biblatex-anonymous+} package), but considers the \bibfield{realauthor} field to sort list by authors' name (as the \verb+realauthor+ sorting). + \item \verb|realauthor|, which but considers the \bibfield{realauthor} and \bibfield{realeditor} fields to sort list by authors' name. If an entry has both \bibfield{realauthor} and \bibfield{author}, only the \bibfield{author} field will be used. + \item \verb|anonymous+realauthor|, which push the anonymous texts at the beginning of the list (as the \verb+anonymous+ sorting of the \emph{biblatex-anonymous+} package), but considers the \bibfield{realauthor} and \bibfield{realeditor} fields to sort list by authors' name (as the \verb+realauthor+ sorting). \end{itemize} See the example file to have an illustration. @@ -98,9 +114,10 @@ This option, when set to false: \begin{itemize} \item Disable use of \bibfield{realauthor} as label name. \item Disable use of \bibfield{realauthor} for sorting. - \item With the default style, and contrary to the \verb+useauthor+ option, also disable printing of \bibfield{realauthor}. + \item Before the version 2.4.0. with the default style, and contrary to the \verb+useauthor+ option, also disabled printing of \bibfield{realauthor}. From version 2.4.0, if you don't want to print the field, don't use the package\ldots. \end{itemize} +The same is true for \opt{realeditor} option for the \bibfield{realeditor}. \section{Customization} @@ -116,6 +133,8 @@ You can also redefine the \cmd{realauthorequalsign} command to change the sign b \newcommand{\realauthorequalsign}{\addnbthinspace=\addnbthinspace} \end{minted} +There are also \cmd{mkrealeditor}, which by default calls \cmd{mkrealauthor}, and \cmd{realeditorequalsign}, which by default calls \cmd{realauthorequalsign}. + For more customization, you have to redefine the macros defined in \file{realauthor.bbx}. @@ -136,6 +155,12 @@ All issues can be submitted, in French or English, in the GitHub issues page\foo \begin{changelog} + \begin{release}{2.4.0}{2016-06-05} + \item Adds \bibfield{realeditor}. + \item Restores normal behavior of \opt{userealeditor}. + \item Uses \bibfield{realauthor} / \bibfield{realeditor} in the abreviatted form of citation. + \end{release} + \begin{release}{2.3.0}{2016-03-11} \item Compatibility with biblatex 3.3. \end{release} |