summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-06-25 23:35:30 +0000
committerKarl Berry <karl@freefriends.org>2014-06-25 23:35:30 +0000
commitda081619283e5fc265b43567b2a1f4d4aa3d6d0a (patch)
tree55aa83e390d3ce91d1f69f1cae46d26c56c7899b /Master/texmf-dist/doc/latex/biblatex-realauthor/documentation
parent8ab1044c7fde2baaaa3103ab3f47585b44c78344 (diff)
biblatex-realauthor (25jun14)
git-svn-id: svn://tug.org/texlive/trunk@34417 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-realauthor/documentation')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/biblatex-realauthor.pdfbin0 -> 59922 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/biblatex-realauthor.tex108
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/example.bib18
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/example.pdfbin0 -> 12903 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/example.tex16
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/makefile10
6 files changed, 152 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/biblatex-realauthor.pdf b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/biblatex-realauthor.pdf
new file mode 100644
index 00000000000..b2c1b43e789
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/biblatex-realauthor.pdf
Binary files differ
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
new file mode 100644
index 00000000000..d80482dcc99
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/biblatex-realauthor.tex
@@ -0,0 +1,108 @@
+\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={1.0.0},
+ date={25/06/2014},
+ url={https://github.com/maieul/biblatex-realauthor}}
+
+% biblatex
+\usepackage[bibstyle=realauthor,citestyle=verbose]{biblatex}
+\addbibresource{example.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{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.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}
+
+\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{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{Change history}
+
+\begin{changelog}
+
+
+
+\begin{release}{1.0.0}{2014-06-25}
+\item First public release.
+\end{release}
+\end{changelog}
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/example.bib b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/example.bib
new file mode 100644
index 00000000000..656db6137ed
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/example.bib
@@ -0,0 +1,18 @@
+@book{LeClerc1686,
+ Publisher = {Henry Desbordes},
+ Realauthor = {Jean le Clerc},
+ Title = {Défense des sentimens
+ De quelques Théologiens de Hollande
+ sur l'histoire critique du Vieux Testament
+ contre la réponse du Prieur de Bolleville},
+ Year = {1686}}
+
+@book{Simon1686,
+ Address = {Rotterdam},
+ Author = {{Prieur de Bolleville}},
+ Publisher = {Reinier Leers},
+ Realauthor = {Richard Simon},
+ Title = {Réponse au livre intitulé
+ sentimens de quelques Theologiens de Hollande
+ sur l'Histoire Critique du Vieux Testament},
+ Year = {1686}}
diff --git a/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/example.pdf b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/example.pdf
new file mode 100644
index 00000000000..96298ca4ee6
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/example.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/example.tex b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/example.tex
new file mode 100644
index 00000000000..3dbeb656ad1
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/example.tex
@@ -0,0 +1,16 @@
+\documentclass{article}
+\usepackage{polyglossia}
+\setmainlanguage{french}
+\usepackage{fontspec,xpatch}
+\usepackage[citestyle=verbose,bibstyle=realauthor]{biblatex}
+\bibliography{example.bib}
+
+\begin{document}
+
+
+\cite{LeClerc1686}
+
+\cite{Simon1686}
+
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/makefile b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/makefile
new file mode 100644
index 00000000000..452e5147638
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/makefile
@@ -0,0 +1,10 @@
+all: *tex *bib
+ xelatex --shell-escape biblatex-realauthor.tex
+ xelatex --shell-escape biblatex-realauthor.tex
+ xelatex --shell-escape example.tex
+ biber example
+ xelatex --shell-escape example.tex
+
+clean:realauthor
+ $(MAKE) -C documentation clean
+ @$(RM) *.pdf *.toc *.aux *.out *.fdb_latexmk *.log *.bbl *.bcf *.blg *run.xml *.synctex.gz*