diff options
author | Robert Alessi <alessi@robertalessi.net> | 2019-03-16 00:15:30 +0100 |
---|---|---|
committer | Robert Alessi <alessi@robertalessi.net> | 2019-03-16 00:15:30 +0100 |
commit | 34a2417a3e75dacf668bfe199867073450e1096d (patch) | |
tree | 2846f70eca78607bc1f3b830377293e129356b0a | |
parent | 0e9519fa29b1c9c5abe2fe50bd53e253b65684fe (diff) | |
download | icite-34a2417a3e75dacf668bfe199867073450e1096d.tar.gz |
added a section on how to use the classics package with icite
-rw-r--r-- | icite.dtx | 228 |
1 files changed, 184 insertions, 44 deletions
@@ -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} |