aboutsummaryrefslogtreecommitdiff
path: root/icite.dtx
diff options
context:
space:
mode:
Diffstat (limited to 'icite.dtx')
-rw-r--r--icite.dtx228
1 files changed, 184 insertions, 44 deletions
diff --git a/icite.dtx b/icite.dtx
index 2b63455..95ec4d1 100644
--- a/icite.dtx
+++ b/icite.dtx
@@ -198,6 +198,17 @@ Running "make install" installs the files in the local TeX tree.
198(markup-locclass-list :open "\tabto{3.5cm}" :sep ", ") 198(markup-locclass-list :open "\tabto{3.5cm}" :sep ", ")
199\end{filecontents*} 199\end{filecontents*}
200\begin{filecontents*}{\jobname.bib} 200\begin{filecontents*}{\jobname.bib}
201@Book{Aristotle:Politica,
202 title = {Politica},
203 date = 1964,
204 author = {Aristotle},
205 editor = {Ross, W. D.},
206 origdate = 1957,
207 entrysubtype = {classical},
208 publisher = {Clarendon Press},
209 location = {Oxford}
210}
211
201@Book{Bürgel2016, 212@Book{Bürgel2016,
202 shorttitle = {Ärztliches Leben\ldots}, 213 shorttitle = {Ärztliches Leben\ldots},
203 editortype = {reviser}, 214 editortype = {reviser},
@@ -212,6 +223,16 @@ Running "make install" installs the files in the local TeX tree.
212 author = {Bürgel, Johann Christoph} 223 author = {Bürgel, Johann Christoph}
213} 224}
214 225
226@Software{classics,
227 title = {The Classics package},
228 subtitle = {Cite classic works},
229 author = {Lourenço de Lima, Eduardo C.},
230 publisher = {CTAN},
231 url = {http://www.ctan.org/pkg/classics},
232 date = {2013-02-02},
233 version = {0.1}
234}
235
215@Article{Dols1987, 236@Article{Dols1987,
216 author = {Dols, Michael W.}, 237 author = {Dols, Michael W.},
217 title = {The Origins of the Islamic Hospital: Myth and 238 title = {The Origins of the Islamic Hospital: Myth and
@@ -223,6 +244,19 @@ Running "make install" installs the files in the local TeX tree.
223 pages = {367--390} 244 pages = {367--390}
224} 245}
225 246
247@InBook{Endress1992,
248 title = {Die Wissenschaftliche Literatur},
249 date = 1992,
250 author = {Endress, Gerhard},
251 booktitle = {Grundriß der arabischen Philologie},
252 editor = {Fisher, Wolfdietrich},
253 volume = 3,
254 note = {Supplement},
255 publisher = {Reichert},
256 location = {Wiesbaden},
257 pages = {3--152}
258}
259
226@Book{IAUMuller, 260@Book{IAUMuller,
227 sortname = {Ibn abi Usaybia}, 261 sortname = {Ibn abi Usaybia},
228 editor = {Müller, August}, 262 editor = {Müller, August},
@@ -239,32 +273,19 @@ Running "make install" installs the files in the local TeX tree.
239 volumes = 2 273 volumes = 2
240} 274}
241 275
242@MVBook{al-Nadim, 276@Software{imakeidx,
243 author = {\prname{ibn al-nadIm}}, 277 title = {The Imakeidx package},
244 title = {\arb[trans]{\uc{f}ihrist}}, 278 subtitle = {A package for producing multiple indexes},
245 sortname = {Ibn al-Nadim}, 279 author = {Gregorio, Enrico and Beccari, Claudio},
246 date = {1871/1872}, 280 publisher = {CTAN},
247 shorthand = {\arb[trans]{\uc{f}ihrist}}, 281 url = {http://www.ctan.org/pkg/imakeidx},
248 editor = {Flügel, Gustav}, 282 date = {2016-10-15},
249 volumes = 2, 283 version = {1.3e}
250 location = {Leipzig},
251 entrysubtype = {classical}
252}
253
254@Book{al-Qifti,
255 sortname = {Ibn al-Qifti},
256 entrysubtype = {classical},
257 shorthand = {\prname{al-qif.tiyy}, \arb[trans]{\uc{t}a'rI_h}},
258 location = {Leipzig},
259 editor = {Lippert, Julius},
260 date = 1903,
261 title = {\arb[trans]{\uc{t}a'rI_h al-.hukamA'}},
262 author = {\prname{ibn al-qif.tiyy}}
263} 284}
264 285
265@Book{RaziShukuk, 286@Book{RaziShukuk,
266 author = {\prname{al-rAziyy}, \prname{mu.hammad 287 author = {\prname{al-rAziyy}, \prname{mu.hammad ibn
267 ibn zakariyyA'}}, 288 zakariyyA'}},
268 title = {\arb[trans]{\uc{k}itAb al-^sukUk `al_A 289 title = {\arb[trans]{\uc{k}itAb al-^sukUk `al_A
269 \uc{^g}AlInUs}}, 290 \uc{^g}AlInUs}},
270 indextitle = {\arb[trans]{\uc{^s}ukUk}}, 291 indextitle = {\arb[trans]{\uc{^s}ukUk}},
@@ -286,27 +307,37 @@ Running "make install" installs the files in the local TeX tree.
286 author = {Ullmann, Manfred}, 307 author = {Ullmann, Manfred},
287} 308}
288 309
289@InBook{Endress1992, 310@MVBook{al-Nadim,
290 title = {Die Wissenschaftliche Literatur}, 311 author = {\prname{ibn al-nadIm}},
291 date = 1992, 312 title = {\arb[trans]{\uc{f}ihrist}},
292 author = {Endress, Gerhard}, 313 sortname = {Ibn al-Nadim},
293 booktitle = {Grundriß der arabischen Philologie}, 314 date = {1871/1872},
294 editor = {Fisher, Wolfdietrich}, 315 shorthand = {\arb[trans]{\uc{f}ihrist}},
295 volume = 3, 316 editor = {Flügel, Gustav},
296 note = {Supplement}, 317 volumes = 2,
297 publisher = {Reichert}, 318 location = {Leipzig},
298 location = {Wiesbaden}, 319 entrysubtype = {classical}
299 pages = {3--152} 320}
321
322@Book{al-Qifti,
323 sortname = {Ibn al-Qifti},
324 entrysubtype = {classical},
325 shorthand = {\prname{al-qif.tiyy}, \arb[trans]{\uc{t}a'rI_h}},
326 location = {Leipzig},
327 editor = {Lippert, Julius},
328 date = 1903,
329 title = {\arb[trans]{\uc{t}a'rI_h al-.hukamA'}},
330 author = {\prname{ibn al-qif.tiyy}}
300} 331}
301 332
302@Software{usebib, 333@Software{usebib,
303 title = {The Usebib package}, 334 title = {The Usebib package},
304 subtitle = {A simple bibliography processor}, 335 subtitle = {A simple bibliography processor},
305 author = {Gregorio, Enrico}, 336 author = {Gregorio, Enrico},
306 publisher = {CTAN}, 337 publisher = {CTAN},
307 url = {http://www.ctan.org/pkg/usebib}, 338 url = {http://www.ctan.org/pkg/usebib},
308 date = {2012-04-13}, 339 date = {2012-04-13},
309 version = {1.0a} 340 version = {1.0a}
310} 341}
311\end{filecontents*} 342\end{filecontents*}
312\usepackage[english]{babel} 343\usepackage[english]{babel}
@@ -347,11 +378,13 @@ Running "make install" installs the files in the local TeX tree.
347\makeindex 378\makeindex
348\makeindex[name=loccit] 379\makeindex[name=loccit]
349\makeindex[name=primary] 380\makeindex[name=primary]
381\usepackage{needspace}
350\usepackage{tabto} 382\usepackage{tabto}
351\usepackage{classics} 383\usepackage{classics}
352\newclassic{iau}{\classicsRoman{#1}|, #1|.#1} 384\newclassic{iau}{\classicsRoman{#1}|, #1|.#1}
353\newclassic{razi}{#1|.#1} 385\newclassic{razi}{#1|.#1}
354\newclassic{nadim}{\classicsRoman{#1}|.#1|, #1} 386\newclassic{nadim}{\classicsRoman{#1}|.#1|, #1}
387\newclassic{aristotle}{#1|\textit{#1}|#1}
355\usepackage[scale=1.5]{ccicons} 388\usepackage[scale=1.5]{ccicons}
356\usepackage{dox} 389\usepackage{dox}
357\doxitem{Option}{option}{options} 390\doxitem{Option}{option}{options}
@@ -874,9 +907,11 @@ Running "make install" installs the files in the local TeX tree.
874% those whose |entrysubtype| field does not match the string 907% those whose |entrysubtype| field does not match the string
875% |classical| should go into the default |loccit| index. As for those 908% |classical| should go into the default |loccit| index. As for those
876% whose |entrysubtype| matches |classical|, they should to into an 909% whose |entrysubtype| matches |classical|, they should to into an
877% index named |primary|. Furthermore, the \package{classics} package 910% index named |primary|. \label{ref:classics-pkg}Furthermore, the
878% is used to format references in which a volume number is used. In 911% \package{classics} package is used to format references in which a
879% this way, \package{xindy} only has numbers to handle:--- % 912% volume number is used.\footnote{For more information, see below
913% \vref{sec:classics}.} In this way, \package{xindy} only has numbers
914% to handle:--- %
880% \iffalse 915% \iffalse
881%<*example> 916%<*example>
882% \fi 917% \fi
@@ -965,6 +1000,109 @@ Running "make install" installs the files in the local TeX tree.
965% one can see, \prname{al-rAziyy} has been sorted under the letter R 1000% one can see, \prname{al-rAziyy} has been sorted under the letter R
966% and references to classical works have been formatted properly. 1001% and references to classical works have been formatted properly.
967% 1002%
1003%
1004% \subsection[The \textsf{classics} package]%
1005% {The \package{classics} package} %
1006% \label{sec:classics}
1007% As said above \vpageref{ref:classics-pkg}, it is advisable to use
1008% the \package{classics} package to format volume, page, column, line
1009% numbers and the like which are inserted in the \meta{post} optional
1010% argument of the \cs{icite} command\autocite{classics}. An example of
1011% using \package{classics} to format references to Aristotle according
1012% to Bekker pagination follows:\footnote{See \cite[2]{classics} for
1013% more information.}--- %
1014% \iffalse
1015%<*example>
1016% \fi
1017\begin{code}
1018 % preamble:
1019 \usepackage{classics}
1020 \newclassic{aristotle}{#1|\textit{#1}|#1}
1021\end{code}
1022% \iffalse
1023%</example>
1024% \fi
1025% \iffalse
1026%<*example>
1027% \fi
1028\begin{example}
1029 In \emph{Politics}, Aristotle says that man is by nature a political
1030 animal in the following passages: \aristotle{1253}[a][2--9] (Book~1)
1031 and again in \aristotle{1278}[b][19] (Book~3). The latter passage
1032 shows that one should read the whole section of Book~1 concerning
1033 household management and the control of slaves
1034 (\aristotle*{1253}[b][1]{1253}[b][39]).
1035\end{example}
1036% \iffalse
1037%</example>
1038% \fi
1039% The following prints the same body text while using \package{icite}
1040% to have the passages cited inserted in the \emph{Index locorum
1041% citatorum} (see below \vref{sec:index-loc-cit}):--- %
1042% \iffalse
1043%<*example>
1044% \fi
1045\begin{example}
1046 In \emph{Politics}, Aristotle says that man is by nature a political
1047 animal in the following passages:
1048 \icite[\aristotle{1253}[a][2--9]]{Aristotle:Politica}[notecite]
1049 (Book~1) and again in \icite[\aristotle{1278}[b][19]]%
1050 {Aristotle:Politica}[notecite] (Book~3). The latter passage shows
1051 that one should read the whole section of Book~1 concerning
1052 household management and the control of slaves
1053 \icite[\aristotle*{1253}[b][1]{1253}[b][39]]%
1054 {Aristotle:Politica}[pnotecite].
1055\end{example}
1056% \iffalse
1057%</example>
1058% \fi
1059% As can be seen, the \cs{notecite} and \cs{pnotecite} commands have
1060% been used to insert only the references in the body text.
1061%
1062% It is also advisable to use \package{xindy} to compile indices of
1063% passages cited because \package{xindy}, unlike \package{makeindex}
1064% or \package{xindex}, is able to sort numbers properly: for example,
1065% with \package{xindy}, such a number as 81 will come before 100, but
1066% will be sorted after 100 with the other two engines.
1067% \begin{tcblisting}{text only, title=Caveat}
1068% \package{xindy} (actually |texindy|) is also designed to ignore
1069% \TeX\ commands by default. However, due to a missing line in
1070% |xindy/modules/base/tex.xdy|,\footnote{As the time of writing, in
1071% \package{xindy} v2.5.1.} this does not apply to so-called
1072% \enquote*{starred} \TeX\ commands, such as \cs{aristotle*} from
1073% the example above.
1074% \end{tcblisting}
1075% One easy way to get around this issue is to create a style file with
1076% a single line that instructs \package{xindy} to ignore the asterisk
1077% when processing the index, like so:--- %
1078% \iffalse
1079%<*example>
1080% \fi
1081\begin{tcblisting}{minted language=lisp, listing only, title=icite.xdy}
1082 (merge-rule "\*" "" :eregexp)
1083\end{tcblisting}
1084% \iffalse
1085%</example>
1086% \fi
1087%
1088% The following example shows how this simple rule can be
1089% applied:--- %
1090% \iffalse
1091%<*example>
1092% \fi
1093\begin{code}
1094 % preamble:
1095 \usepackage[xindy]{imakeidx}
1096 \makeindex[name=loccit, options=-M icite.sty]
1097 % document:
1098 \printindex[loccit]
1099\end{code}
1100% \iffalse
1101%</example>
1102% \fi
1103% Of course, the document itself must be compiled with
1104% |--shell-escape|.\footnote{See \cite[2--4]{imakeidx}.}
1105%
968% \section{Appendix} 1106% \section{Appendix}
969% Designing the layout of indices is out of the scope of this 1107% Designing the layout of indices is out of the scope of this
970% documentation. For information, the \package{tabto} package has been 1108% documentation. For information, the \package{tabto} package has been
@@ -985,7 +1123,9 @@ Running "make install" installs the files in the local TeX tree.
985% \label{ref:indices} 1123% \label{ref:indices}
986% \subsubsection{Index of Passages Cited (modern authors)} 1124% \subsubsection{Index of Passages Cited (modern authors)}
987% \printindex[loccit] 1125% \printindex[loccit]
1126% \needspace{8\baselineskip}
988% \subsubsection{\emph{Index locorum citatorum}} 1127% \subsubsection{\emph{Index locorum citatorum}}
1128% \label{sec:index-loc-cit}
989% \printindex[primary] 1129% \printindex[primary]
990% 1130%
991% \subsection{\texorpdfstring{\hologo{BibTeX} 1131% \subsection{\texorpdfstring{\hologo{BibTeX}