summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-true-citepages-omit/biblatex-true-citepages-omit.tex
blob: a0dd3687fb5caafeef2b9cd4d9b1bef1ee8ff6dd (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
\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{%
	subtitle={Correcting a limitation of citepages=omit option of \biblatex styles},
	email={maieul <at> maieul <dot> net},
	author={Maïeul Rouquette},
	title={The biblatex-true-citepages-omit package},
	revision={2.0.0},
	date={20/06/20167},
	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} package the problem will be solved.

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

Notes that the \emph{citepages=omit} option is automatically loaded.

\citereset
\restorebibmacro{real-citepages-omit}{}
\begin{quotation}
\cite[\pno~112, on this point etc.]{Kaestli1993}
\end{quotation}
\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}{2.0.0}{2017-06-20}
  \item The \emph{citepages=omit} option is automatically loaded
\end{release}

\begin{release}{1.3.0}{2015-09-21}
 \item As in the standard citepages=omit, also clear the \bibfield{pagetotal} field.
\end{release}

\begin{release}{1.2.0}{2014-08-16}
\item No more \cs{realcitepagesomitcmd} command.
\item Internal macros with more consistent name.
\end{release}

\begin{release}{1.1.1}{2014-06-17}
\item Compatibility with the \cs{xspace} of xspace package.
\end{release}


\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}