summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-true-citepages-omit/biblatex-true-citepages-omit.tex
blob: 97bcf53983f0c4c19322092bdff7f5ca8b776ad0 (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
\documentclass{ltxdockit}[2011/03/25]
\usepackage{btxdockit}
\usepackage[main=english,french,latin]{babel}
\usepackage[bibstyle=verbose,citestyle=verbose,citepages=omit]{biblatex}
\addbibresource{biblatex-true-citepages-omit.bib}
\usepackage{biblatex-true-citepages-omit}
\savebibmacro{real-citepages-omit}
\renewbibmacro{real-citepages-omit}{}
\usepackage{fontspec}
\usepackage[mono=false]{libertine}
\usepackage{microtype}
\usepackage[strict]{csquotes}
\setmonofont[Scale=MatchLowercase]{DejaVu Sans Mono}
\usepackage{shortvrb}
\usepackage{minted}
\usepackage{pifont}

% Usefull commands
\newcommand{\biblatex}{biblatex\xspace}
\pretocmd{\bibfield}{\sloppy}{}{}
\pretocmd{\bibtype}{\sloppy}{}{}
\newcommand{\bibkey}[1]{\texttt #1}
% Meta-datas
\titlepage{%
	title={Correcting a limitation of citepages=omit option of \biblatex styles},
	email={maieul <at> maieul <dot> net},
	author={Maïeul Rouquette},
	subtitle={},
	revision={1.0.1},
	date={16/06/2014},
	url={https://github.com/maieul/biblatex-true-citepages-omit}}
% Hyphen
\hyphenation{Ma-de-lei-ne}

\begin{document}

\printtitlepage
\tableofcontents

\section{Documentation}

\subsection{Goal}
The citation styles of the family \emph{verbose} of the \biblatex package offer an \emph{citepages=omit} option.
\begin{minted}{tex}
\usepackage[bibstyle=verbose,citestyle=verbose,citepages=omit]{biblatex}
\end{minted}

This option is very useful: it omits the \bibfield{pages} field when a citation is made with a pages' number. For example, the following entry

\inputminted{tex}{biblatex-true-citepages-omit.bib}

called with:

\begin{minted}{tex}
\cite[112]{Kaestli1993}
\end{minted} 

will be printed as:

\begin{quotation}
\cite[112]{Kaestli1993}
\end{quotation}

and not as:
\citereset

\begin{quotation}
\cite{Kaestli1993}, p.~112
\end{quotation}

This option works perfectly, except if you add a text after page's number, as you can see in the following example.

\begin{minted}{tex}
\cite[\pno~112, on this point etc.]{Kaestli1993}
\end{minted}

\citereset
\begin{quotation}
\cite[\pno~112, on this point etc.]{Kaestli1993}
\end{quotation}

It seems this problem won't be solved in the \biblatex core\footnote{See: \url{https://github.com/plk/biblatex/issues/151\#issuecomment-22879677}.}.

So, if you simply load the \emph{biblatex-true-citepages-omit} footcite package the problem will be solved.

\begin{minted}{tex}
\usepackage[bibstyle=verbose,citestyle=verbose,citepages=omit]{biblatex}
\usepackage{biblatex-true-citepages-omit}
...
\cite[\pno~112, on this point etc.]{Kaestli1993}
\end{minted}


\citereset
\restorebibmacro{real-citepages-omit}{}
\begin{quotation}
\cite[\pno~112, on this point etc.]{Kaestli1993}
\end{quotation}
\subsection{Declare commands to be used in \prm{postnote} argument}

If you use some commands in the \prm{postnote} arguments, it could kill \LaTeX. To prevent that, use the \cmd{realcitepagesomit}, which the name of the command as argument. For example, the \emph{polyglossia} switching commands are problematic. So you can do:
\begin{minted}{tex}
\realcitepagesomitcmd{textlatin}
\realcitepagesomitcmd{textgreek}
\end{minted}
\subsection{Limitations}

\begin{itemize}
	\item This package works only if you start the  \prm{postnote}  argument by the \cmd{pno} or \cmd{ppno} commands.
	\item This package must be loaded after the \emph{biblatex-source-division} package.
\end{itemize}
\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-source-division/issues}.}.



\section{Revision History}
\begin{changelog}

\begin{release}{1.1.0}{2014-06-16}
\item Better implementation of  \cs{realcitepagesomitcmd}.
\end{release}

\begin{release}{1.0.1}{2014-06-16}
\item Compatibility with the \cs{bibleverse} of bibleref package.
\end{release}

\begin{release}{1.0.0}{2014-03-25}
\item First public release.
\end{release}

\end{changelog}
\end{document}