diff options
author | Karl Berry <karl@freefriends.org> | 2014-06-25 23:35:30 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2014-06-25 23:35:30 +0000 |
commit | da081619283e5fc265b43567b2a1f4d4aa3d6d0a (patch) | |
tree | 55aa83e390d3ce91d1f69f1cae46d26c56c7899b /Master/texmf-dist/doc/latex | |
parent | 8ab1044c7fde2baaaa3103ab3f47585b44c78344 (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')
8 files changed, 175 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-realauthor/README b/Master/texmf-dist/doc/latex/biblatex-realauthor/README new file mode 100644 index 00000000000..b9100dd8aa7 --- /dev/null +++ b/Master/texmf-dist/doc/latex/biblatex-realauthor/README @@ -0,0 +1,4 @@ +biblatex-realauthor +=================== + +Manage real author with biblatex 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 Binary files differnew file mode 100644 index 00000000000..b2c1b43e789 --- /dev/null +++ b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/biblatex-realauthor.pdf 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 Binary files differnew file mode 100644 index 00000000000..96298ca4ee6 --- /dev/null +++ b/Master/texmf-dist/doc/latex/biblatex-realauthor/documentation/example.pdf 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* diff --git a/Master/texmf-dist/doc/latex/biblatex-realauthor/makefile b/Master/texmf-dist/doc/latex/biblatex-realauthor/makefile new file mode 100644 index 00000000000..7a6c294ba29 --- /dev/null +++ b/Master/texmf-dist/doc/latex/biblatex-realauthor/makefile @@ -0,0 +1,19 @@ +FILES = *.bbx *.dbx *.lbx documentation makefile README + + +dist: all + rm -rf biblatex-realauthor + mkdir biblatex-realauthor + cp README *bbx *dbx *makefile biblatex-realauthor + mkdir biblatex-realauthor/documentation + cp documentation/*tex documentation/*bib documentation/*pdf documentation/makefile biblatex-realauthor/documentation + $(RM) ../biblatex-realauthor.zip + zip -r ../biblatex-realauthor.zip biblatex-realauthor + + +clean: + $(MAKE) -C documentation clean + @$(RM) *.pdf *.toc *.aux *.out *.fdb_latexmk *.log *.bbl *.bcf *.blg *run.xml *.synctex.gz* + +all: documentation/example.tex documentation/biblatex-realauthor.tex documentation/example.bib + $(MAKE) -C documentation all
\ No newline at end of file |