summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/biblatex-realauthor.tex
blob: bafc76165ff9a6843caf6bc5ec81b433091cd4cd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
\documentclass{ltxdockit}[2011/03/25]
\usepackage{btxdockit}
\usepackage{fontspec}
\usepackage[mono=false]{libertine}
\usepackage{microtype}
\usepackage[american]{babel}
\usepackage[strict]{csquotes}
\setmonofont[Scale=MatchLowercase]{DejaVu Sans Mono}
\usepackage{shortvrb}
\usepackage{pifont}
\usepackage{minted}
% Usefull commands
\newcommand{\biblatex}{biblatex\xspace}
\pretocmd{\bibfield}{\sloppy}{}{}
\pretocmd{\bibtype}{\sloppy}{}{}
\newcommand{\namebibstyle}[1]{\texttt{#1}}
% Meta-datas
\titlepage{%
	title={Description of real authors with biblatex},
	subtitle={New data field},
	email={maieul <at> maieul <dot> net},
	author={Maïeul Rouquette},
	revision={2.3.0},
	date={03/11/2016},
	url={https://github.com/maieul/biblatex-realauthor}}

% biblatex
\usepackage[bibstyle=realauthor,citestyle=verbose]{biblatex}
\addbibresource{example-realauthor.bib}

\begin{document}

\printtitlepage
\tableofcontents
\section{Introduction}

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.

\section{Basic use}

\subsection{Requirement}

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: 

\inputminted{tex}{example-realauthor.bib}

\subsection{Loading of the \biblatex package}

When loading the \biblatex package, use the \namebibstyle{realauthor}  bibstyle, which is based on the \namebibstyle{verbose} bibstyle:

\begin{minted}{latex}
\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.}.

\subsection{Example of result}

By default, the real author name is printed in brackets, with an equal, between fine nonbreak spaces,  when a pseudonym is also use:
\begin{quotation}
\cite{LeClerc1686}

\cite{Simon1686}
\end{quotation}

\subsection{\bibfield{Labelname} field}\label{field:label} 

This package, since version 2.0.0, declares  the \bibfield{realauthor} name as the \bibfield{labelname}, if a \bibfield{author} name is not defined.

That implies this field is use for:
\begin{itemize}
  \item Sorting.
  \item \emph{ibid} / \emph{op. cit} abreviation.
\end{itemize}

Note that this field is not affected by \verb+useauthor+ option, but it is by \verb+userealauthor+ option \secref{userealauthor}.

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.

\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).
\end{itemize} 
  See the example file to have an illustration.
  
\section{Disable realauthor use}\label{userealauthor}

The package, or rather \biblatex, defines an \verb+userealauthor+ option, which can be settable on a per-entry basis in the \bibfield{options} field, or by entrytype, using \cmd{ExecuteBibliographyOptions}, or globally, when loading \biblatex. 

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}.
\end{itemize}


\section{Customization}

You can redefine the \cmd{mkrealauthor} command to change the way the real author name is printed. Default value is:

\begin{minted}{tex}
\newcommand{\mkrealauthor}[1]{\mkbibbrackets{#1}}
\end{minted}

You can also redefine the \cmd{realauthorequalsign} command to change the sign before the real author name when a pseudonym is also used. Default value is:

\begin{minted}{tex}
\newcommand{\realauthorequalsign}{\addnbthinspace=\addnbthinspace}
\end{minted}

For more customization, you have to redefine the macros defined in \file{realauthor.bbx}.




\section{Use with biblatex-manuscripts-philology}

To use this package with the features of \verb+biblatex-manuscripts-philology+, you must use the package \verb+biblatex-multiple-dm+.

\section{Credits}

This package was created for Maïeul Rouquette's phd dissertation\footnote{\url{http://apocryphes.hypothese.org}.} in 2014. It is licensed on the \emph{\LaTeX\ Project Public License}\footnote{\url{http://latex-project.org/lppl/lppl-1-3c.html}.}.


All issues can be submitted, in French or English, in the GitHub issues page\footnote{\url{https://github.com/maieul/biblatex-realauthor/issues}.}.

\section{Change history}

\begin{changelog}

  \begin{release}{2.3.0}{2016-03-11}
  \item Compatibility with biblatex 3.3.
  \end{release}

  \begin{release}{2.2.1}{2016-02-28}
  \item Correct description of datamodel specification about which entrytype can have a \bibfield{realauthor} field.
  \end{release}


  \begin{release}{2.2.0}{2015-04-26}
  \item Add new \verb|userealauthor| option. Require \biblatex~3.0. \see{userealauthor}
  \item Provides good file version in the \cs{ProvidesFile} command.
  \end{release}

  \begin{release}{2.1.0}{2014-10-30}
  \item Add new \verb|realauthor| scheme. \see{sorting}
  \end{release}


  \begin{release}{2.0.0}{2014-10-27}
  \item Print the realauthor name in bracket when cited in a abreviated form.
  \item Define \bibfield{realauthor} as \bibfield{labelname}. \see{field:label}
  \end{release}

\begin{release}{1.1.0}{2014-10-09}
\item In a bibliographical list, print the last name before the first name of a real author, except if a \bibfield{author} is defined.
\item Add \verb|anonymous+realauthor| sorting scheme.   \see{sorting}
\item Compatibility with \bibtype{article} entry. 
\end{release}

\begin{release}{1.0.0}{2014-06-25}
\item First public release.
\end{release}
\end{changelog}
\end{document}