aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md19
-rw-r--r--about.html253
-rw-r--r--icite.dtx983
3 files changed, 1051 insertions, 204 deletions
diff --git a/README.md b/README.md
index c70816e..d0f059f 100644
--- a/README.md
+++ b/README.md
@@ -17,7 +17,7 @@ License and disclamer
17 17
18icite – Indices locorum citatorum 18icite – Indices locorum citatorum
19 19
20Copyright ⓒ 2019--2020 Robert Alessi 20Copyright ⓒ 2019--2021 Robert Alessi
21 21
22Please send error reports and suggestions for improvements to Robert 22Please send error reports and suggestions for improvements to Robert
23Alessi: 23Alessi:
@@ -50,16 +50,21 @@ This release of icite consists of the following source files:
50 50
51- `Makefile` 51- `Makefile`
52 52
53License applicable to the documentation 53License Applicable to the Documentation
54--------------------------------------- 54---------------------------------------
55 55
56Copyright ⓒ 2019--2020 Robert Alessi 56Copyright ⓒ 2020--2021 Robert Alessi
57 57
58The documentation file `icite.pdf` that is generated from the 58The documentation file `icite.pdf` that is generated from the
59`icite.dtx` source file is licensed under the Creative Commons 59`icite.dtx` source file is licensed under the GNU Free Documentation
60Attribution-ShareAlike 4.0 International License. To view a copy of this 60License, as follows:---
61license, visit <http://creativecommons.org/licenses/by-sa/4.0/> or send 61
62a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA. 62Permission is granted to copy, distribute and/or modify this document
63 under the terms of the GNU Free Documentation License, Version 1.3
64 or any later version published by the Free Software Foundation; with
65 no Invariant Sections, no Front-Cover Texts, and no Back-Cover
66 Texts. A copy of the license is included in the section entitled
67 “GNU Free Documentation License”.
63 68
64Installation 69Installation
65============ 70============
diff --git a/about.html b/about.html
index dea134d..8667f4a 100644
--- a/about.html
+++ b/about.html
@@ -6,58 +6,257 @@
6 <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" /> 6 <meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
7 <meta name="author" content="Robert Alessi" /> 7 <meta name="author" content="Robert Alessi" />
8 <title>The icite package – README file</title> 8 <title>The icite package – README file</title>
9 <style type="text/css"> 9 <style>
10 code{white-space: pre-wrap;} 10 html {
11 span.smallcaps{font-variant: small-caps;} 11 line-height: 1.5;
12 span.underline{text-decoration: underline;} 12 font-family: Georgia, serif;
13 div.column{display: inline-block; vertical-align: top; width: 50%;} 13 font-size: 20px;
14 color: #1a1a1a;
15 background-color: #fdfdfd;
16 }
17 body {
18 margin: 0 auto;
19 max-width: 36em;
20 padding-left: 50px;
21 padding-right: 50px;
22 padding-top: 50px;
23 padding-bottom: 50px;
24 hyphens: auto;
25 overflow-wrap: break-word;
26 text-rendering: optimizeLegibility;
27 font-kerning: normal;
28 }
29 @media (max-width: 600px) {
30 body {
31 font-size: 0.9em;
32 padding: 1em;
33 }
34 h1 {
35 font-size: 1.8em;
36 }
37 }
38 @media print {
39 body {
40 background-color: transparent;
41 color: black;
42 font-size: 12pt;
43 }
44 p, h2, h3 {
45 orphans: 3;
46 widows: 3;
47 }
48 h2, h3, h4 {
49 page-break-after: avoid;
50 }
51 }
52 p {
53 margin: 1em 0;
54 }
55 a {
56 color: #1a1a1a;
57 }
58 a:visited {
59 color: #1a1a1a;
60 }
61 img {
62 max-width: 100%;
63 }
64 h1, h2, h3, h4, h5, h6 {
65 margin-top: 1.4em;
66 }
67 h5, h6 {
68 font-size: 1em;
69 font-style: italic;
70 }
71 h6 {
72 font-weight: normal;
73 }
74 ol, ul {
75 padding-left: 1.7em;
76 margin-top: 1em;
77 }
78 li > ol, li > ul {
79 margin-top: 0;
80 }
81 blockquote {
82 margin: 1em 0 1em 1.7em;
83 padding-left: 1em;
84 border-left: 2px solid #e6e6e6;
85 color: #606060;
86 }
87 code {
88 font-family: Menlo, Monaco, 'Lucida Console', Consolas, monospace;
89 font-size: 85%;
90 margin: 0;
91 }
92 pre {
93 margin: 1em 0;
94 overflow: auto;
95 }
96 pre code {
97 padding: 0;
98 overflow: visible;
99 overflow-wrap: normal;
100 }
101 .sourceCode {
102 background-color: transparent;
103 overflow: visible;
104 }
105 hr {
106 background-color: #1a1a1a;
107 border: none;
108 height: 1px;
109 margin: 1em 0;
110 }
111 table {
112 margin: 1em 0;
113 border-collapse: collapse;
114 width: 100%;
115 overflow-x: auto;
116 display: block;
117 font-variant-numeric: lining-nums tabular-nums;
118 }
119 table caption {
120 margin-bottom: 0.75em;
121 }
122 tbody {
123 margin-top: 0.5em;
124 border-top: 1px solid #1a1a1a;
125 border-bottom: 1px solid #1a1a1a;
126 }
127 th {
128 border-top: 1px solid #1a1a1a;
129 padding: 0.25em 0.5em 0.25em 0.5em;
130 }
131 td {
132 padding: 0.125em 0.5em 0.25em 0.5em;
133 }
134 header {
135 margin-bottom: 4em;
136 text-align: center;
137 }
138 #TOC li {
139 list-style: none;
140 }
141 #TOC ul {
142 padding-left: 1.3em;
143 }
144 #TOC > ul {
145 padding-left: 0;
146 }
147 #TOC a:not(:hover) {
148 text-decoration: none;
149 }
150 code{white-space: pre-wrap;}
151 span.smallcaps{font-variant: small-caps;}
152 div.columns{display: flex; gap: min(4vw, 1.5em);}
153 div.column{flex: auto; overflow-x: auto;}
154 div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
155 ul.task-list{list-style: none;}
156 ul.task-list li input[type="checkbox"] {
157 width: 0.8em;
158 margin: 0 0.8em 0.2em -1.6em;
159 vertical-align: middle;
160 }
161 .display.math{display: block; text-align: center; margin: 0.5rem auto;}
14 </style> 162 </style>
163 <!--[if lt IE 9]>
164 <script src="//cdnjs.cloudflare.com/ajax/libs/html5shiv/3.7.3/html5shiv-printshiv.min.js"></script>
165 <![endif]-->
15</head> 166</head>
16<body> 167<body>
17<header> 168<header id="title-block-header">
18<h1 class="title">The icite package – README file</h1> 169<h1 class="title">The icite package – README file</h1>
19<p class="author">Robert Alessi</p> 170<p class="author">Robert Alessi</p>
20</header> 171</header>
21<h1 id="overview">Overview</h1> 172<h1 id="overview">Overview</h1>
22<p><code>icite</code> is designed to produce from BibTeX or BibLaTeX bibliographical databases the different indices of authors and works cited which are called <em>indices locorum citatorum</em>. It relies on a specific <code>\icite</code> command and can operate with either BibTeX or BibLaTeX.</p> 173<p><code>icite</code> is designed to produce from BibTeX or BibLaTeX
174bibliographical databases the different indices of authors and works
175cited which are called <em>indices locorum citatorum</em>. It relies on
176a specific <code>\icite</code> command and can operate with either
177BibTeX or BibLaTeX.</p>
23<h1 id="license-and-disclamer">License and disclamer</h1> 178<h1 id="license-and-disclamer">License and disclamer</h1>
24<p>icite – Indices locorum citatorum</p> 179<p>icite – Indices locorum citatorum</p>
25<p>Copyright ⓒ 2019–2020 Robert Alessi</p> 180<p>Copyright ⓒ 2019–2021 Robert Alessi</p>
26<p>Please send error reports and suggestions for improvements to Robert Alessi:</p> 181<p>Please send error reports and suggestions for improvements to Robert
182Alessi:</p>
27<ul> 183<ul>
28<li><p>email: <a href="mailto:alessi@robertalessi.net">alessi@robertalessi.net</a></p></li> 184<li><p>email: <a href="mailto:alessi@robertalessi.net"
29<li><p>website: <a href="http://www.robertalessi.net/icite" class="uri">http://www.robertalessi.net/icite</a></p></li> 185class="email">alessi@robertalessi.net</a></p></li>
30<li><p>comments, feature requests, bug reports: <a href="https://gitlab.com/ralessi/icite/issues" class="uri">https://gitlab.com/ralessi/icite/issues</a></p></li> 186<li><p>website: <a href="http://www.robertalessi.net/icite"
187class="uri">http://www.robertalessi.net/icite</a></p></li>
188<li><p>comments, feature requests, bug reports: <a
189href="https://gitlab.com/ralessi/icite/issues"
190class="uri">https://gitlab.com/ralessi/icite/issues</a></p></li>
31</ul> 191</ul>
32<p>This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.</p> 192<p>This program is free software: you can redistribute it and/or modify
33<p>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.</p> 193it under the terms of the GNU General Public License as published by the
34<p>You should have received a copy of the GNU General Public License along with this program. If not, see <a href="http://www.gnu.org/licenses/" class="uri">http://www.gnu.org/licenses/</a>.</p> 194Free Software Foundation, either version 3 of the License, or (at your
195option) any later version.</p>
196<p>This program is distributed in the hope that it will be useful, but
197WITHOUT ANY WARRANTY; without even the implied warranty of
198MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
199Public License for more details.</p>
200<p>You should have received a copy of the GNU General Public License
201along with this program. If not, see <a
202href="http://www.gnu.org/licenses/"
203class="uri">http://www.gnu.org/licenses/</a>.</p>
35<p>This release of icite consists of the following source files:</p> 204<p>This release of icite consists of the following source files:</p>
36<ul> 205<ul>
37<li><p><code>icite.dtx</code></p></li> 206<li><p><code>icite.dtx</code></p></li>
38<li><p><code>icite.ins</code></p></li> 207<li><p><code>icite.ins</code></p></li>
39<li><p><code>Makefile</code></p></li> 208<li><p><code>Makefile</code></p></li>
40</ul> 209</ul>
41<h2 id="license-applicable-to-the-documentation">License applicable to the documentation</h2> 210<h2 id="license-applicable-to-the-documentation">License Applicable to
42<p>Copyright ⓒ 2019–2020 Robert Alessi</p> 211the Documentation</h2>
43<p>The documentation file <code>icite.pdf</code> that is generated from the <code>icite.dtx</code> source file is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License. To view a copy of this license, visit <a href="http://creativecommons.org/licenses/by-sa/4.0/" class="uri">http://creativecommons.org/licenses/by-sa/4.0/</a> or send a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.</p> 212<p>Copyright ⓒ 2020–2021 Robert Alessi</p>
213<p>The documentation file <code>icite.pdf</code> that is generated from
214the <code>icite.dtx</code> source file is licensed under the GNU Free
215Documentation License, as follows:—</p>
216<p>Permission is granted to copy, distribute and/or modify this document
217under the terms of the GNU Free Documentation License, Version 1.3 or
218any later version published by the Free Software Foundation; with no
219Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
220copy of the license is included in the section entitled “GNU Free
221Documentation License”.</p>
44<h1 id="installation">Installation</h1> 222<h1 id="installation">Installation</h1>
45<ol type="1"> 223<ol type="1">
46<li><p>Run <code>'latex icite.ins'</code> to produce the <code>icite.sty</code> file.</p></li> 224<li><p>Run <code>'latex icite.ins'</code> to produce the
47<li><p>To finish the installation you have to move the <code>icite.sty</code> file into a directory where LaTeX can find it. See the FAQ on <code>texfaq.org</code> at <a href="https://texfaq.org/FAQ-inst-wlcf" class="uri">https://texfaq.org/FAQ-inst-wlcf</a> for more on this.</p></li> 225<code>icite.sty</code> file.</p></li>
226<li><p>To finish the installation you have to move the
227<code>icite.sty</code> file into a directory where LaTeX can find it.
228See the FAQ on <code>texfaq.org</code> at <a
229href="https://texfaq.org/FAQ-inst-wlcf"
230class="uri">https://texfaq.org/FAQ-inst-wlcf</a> for more on
231this.</p></li>
48</ol> 232</ol>
49<h1 id="development-git-repository">Development, Git Repository</h1> 233<h1 id="development-git-repository">Development, Git Repository</h1>
50<h2 id="browse-the-code">Browse the code</h2> 234<h2 id="browse-the-code">Browse the code</h2>
51<p>You can browse icite repository on the web: <a href="http://git.robertalessi.net/icite" class="uri">http://git.robertalessi.net/icite</a></p> 235<p>You can browse icite repository on the web: <a
52<p>From this page, you can download all the releases of <code>icite</code>. For instructions on how to install <code>icite</code>, please see above.</p> 236href="http://git.robertalessi.net/icite"
53<h2 id="comments-feature-requests-bug-reports">Comments, Feature requests, Bug Reports</h2> 237class="uri">http://git.robertalessi.net/icite</a></p>
54<p><a href="https://gitlab.com/ralessi/icite/issues" class="uri">https://gitlab.com/ralessi/icite/issues</a></p> 238<p>From this page, you can download all the releases of
239<code>icite</code>. For instructions on how to install
240<code>icite</code>, please see above.</p>
241<h2 id="comments-feature-requests-bug-reports">Comments, Feature
242requests, Bug Reports</h2>
243<p><a href="https://gitlab.com/ralessi/icite/issues"
244class="uri">https://gitlab.com/ralessi/icite/issues</a></p>
55<h2 id="download-the-repository">Download the repository</h2> 245<h2 id="download-the-repository">Download the repository</h2>
56<p><code>icite</code> development is facilitated by git, a distributed version control system. You will need to install git (most GNU/Linux distributions package it in their repositories).</p> 246<p><code>icite</code> development is facilitated by git, a distributed
247version control system. You will need to install git (most GNU/Linux
248distributions package it in their repositories).</p>
57<p>Use this command to download the repository</p> 249<p>Use this command to download the repository</p>
58<pre><code>git clone http://git.robertalessi.net/icite</code></pre> 250<pre><code>git clone http://git.robertalessi.net/icite</code></pre>
59<p>A new directory named icite will have been created, containing <code>icite</code>.</p> 251<p>A new directory named icite will have been created, containing
252<code>icite</code>.</p>
60<h2 id="git-hosting">Git hosting</h2> 253<h2 id="git-hosting">Git hosting</h2>
61<p>Make an account on <a href="https://gitlab.com" class="uri">https://gitlab.com</a> and navigate (while logged in) to <a href="https://gitlab.com/ralessi/icite" class="uri">https://gitlab.com/ralessi/icite</a>. Click <em>Fork</em> and you will have in your account your own repository of <code>icite</code> where you will be able to make whatever changes you like to.</p> 254<p>Make an account on <a href="https://gitlab.com"
255class="uri">https://gitlab.com</a> and navigate (while logged in) to <a
256href="https://gitlab.com/ralessi/icite"
257class="uri">https://gitlab.com/ralessi/icite</a>. Click <em>Fork</em>
258and you will have in your account your own repository of
259<code>icite</code> where you will be able to make whatever changes you
260like to.</p>
62</body> 261</body>
63</html> 262</html>
diff --git a/icite.dtx b/icite.dtx
index bcb9121..0cdb8de 100644
--- a/icite.dtx
+++ b/icite.dtx
@@ -1,6 +1,6 @@
1% \iffalse meta-comment 1% \iffalse meta-comment
2% icite -- Indices locorum citatorum 2% icite -- Indices locorum citatorum
3% Copyright (C) 2019--2020 Robert Alesssi 3% Copyright (C) 2019--2021 Robert Alesssi
4% 4%
5% Please send error reports and suggestions for improvements to Robert 5% Please send error reports and suggestions for improvements to Robert
6% Alessi <alessi@robertalessi.net> 6% Alessi <alessi@robertalessi.net>
@@ -27,7 +27,7 @@
27%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01] 27%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
28%<package>\ProvidesPackage{icite} 28%<package>\ProvidesPackage{icite}
29%<*package> 29%<*package>
30 [2020/03/05 v1.3a Make Indices locorum citatorum] 30 [2021/07/07 v1.4-dev Make Indices locorum citatorum]
31%</package> 31%</package>
32%<*driver> 32%<*driver>
33\documentclass{ltxdoc} 33\documentclass{ltxdoc}
@@ -180,33 +180,80 @@
180} 180}
181\end{filecontents*} 181\end{filecontents*}
182\usepackage{fontspec} 182\usepackage{fontspec}
183\usepackage[default]{fontsetup} 183\usepackage[american]{babel}
184\usepackage[english]{babel}
185\usepackage[letterpaper,margin=25mm,left=50mm,nohead]{geometry} 184\usepackage[letterpaper,margin=25mm,left=50mm,nohead]{geometry}
186\babelfont{rm}{Old Standard} 185\babelfont{rm}{Old Standard}
186\babelfont{sf}{NewComputerModernSans10}
187\babelfont{tt}{NewComputerModernMono10}
187\usepackage{arabluatex} 188\usepackage{arabluatex}
188\SetTranslitConvention{loc} 189\SetTranslitConvention{loc}
189\usepackage{xurl} 190\usepackage[obeyspaces]{url}
190\usepackage{uri} 191\usepackage[nospace,american]{varioref}
191\usepackage{hyperxmp} 192\labelformat{section}{sect.~#1}
192\usepackage{varioref} 193\labelformat{subsection}{sect.~#1}
194\labelformat{subsubsection}{sect.~#1}
195\labelformat{figure}{fig.~#1}
196\newcommand\phts{\phantomsection}
193\usepackage{latexcolors} 197\usepackage{latexcolors}
194\usepackage[numbered]{hypdoc} 198\usepackage[numbered]{hypdoc}
195\hypersetup{unicode=true, colorlinks, allcolors=cinnamon, keeppdfinfo, 199\usepackage[loadlang=en]{metastr}
196 linktocpage=true, pdfauthor={Robert Alessi}, pdftitle={The icite 200\hypersetup{
197 package}, pdfcontactemail={alessi@robertalessi.net}, 201 colorlinks,
198 pdfcontacturl={http://www.robertalessi.net/icite}, 202 allcolors=cinnamon,
199 pdfcopyright={Copyright (C) 2019--2020 Robert Alessi 203 linktocpage=true,
200 <alessi@robertalessi.net>. This document is licensed under the 204 pdftype={Text}
201 Creative Commons Attribution-ShareAlike 4.0 International 205}
202 License. To view a copy of this license, visit 206\metaset{titletext}{%
203 http://creativecommons.org/licenses/by-sa/4.0/ or send a letter to 207 \metapick[#1]{title}%
204 Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.}, 208 \metacompose[#1]{subtitle}{\metaget[sep]{subtitle}}{}{}}
205 pdflicenseurl={https://creativecommons.org/licenses/by-sa/4.0/legalcode}, 209\metaset[print]{titletext}{%
206 pdfmetalang={en-US}, pdftype={Text}, pdfkeywords={bibtex, biblatex, 210 \metatitleline[print]{title}%
207 indexing}} 211 \metatitleline[print]{subtitle}%
208\usepackage{amsmath} 212 \metatitleline[print]{author}%
209\usepackage{cleveref} 213 \metatitleline[print]{contactemail}%
214 \metatitlelinetwo[print]{date}[print]{draft}}
215\metaset[skip]{subtitle}{\vspace{1ex}}
216\metaset[skip]{author}{\vspace{2ex}}
217\metaset[skip]{date}{\vspace{1ex}}
218\metaset[style]{title}{\LARGE}
219\metaset[style]{author}{\large}
220\metaset[sep]{draft}{ -- }
221\metasetlang{en-US}
222\metaset{title}{icite}
223\metaset[print]{title}{\textsf{icite}}
224\metaset{date}{\filedate}
225\metaset{draft}{\fileversion}
226\metaset{subject}{Indices locorum citatorum}
227\metaset{subtitle}{Indices locorum citatorum}
228\metaset[print]{subtitle}{\emph{Indices locorum citatorum}}
229\metaset{author}{Robert Alessi}
230\metaset{keywords}{LaTeX, Lua, bibliography, index}
231\metaset{contactemail}{alessi@roberalessi.net}
232\metaset[print]{contactemail}{\mailto[icite]{alessi@robertalessi.net}}
233\metaset{contacturl}{http://www.roberalessi.net}
234\metaset{partof}{The icite Package}
235\metaset[print]{partof}{The \textsf{icite} Package}
236\metaset{copyrightowner}{\metapick[#1]{author}}
237\metaset{copyrightdate}{2019--2021}
238\metaset{licensemessage}{Permission is granted to copy, distribute
239 and/or modify this document under the terms of the GNU Free
240 Documentation License, Version 1.3 or any later version published by
241 the Free Software Foundation; with no Invariant Sections, no
242 Front-Cover Texts, and no Back-Cover Texts. A copy of the license
243 is included in the section entitled ``GNU Free Documentation
244 License''.}
245\metaset{licenseurl}{https://www.gnu.org/licenses/fdl-1.3.html}
246\metaset[print]{licenseurl}{%
247 \url{https://www.gnu.org/licenses/fdl-1.3.html}}
248\metaset[cmd]{licenselogo}{\includegraphics[scale=0.75]{#1}}
249\metawritepdfinfo
250\metawritepdfaux
251\metawritepdfpreamble
252\metawritepdfcontact
253\metawritepdfrights
254
255\usepackage{uri}
256
210\CodelineIndex 257\CodelineIndex
211\usepackage[citecmd=autocite,defaultindex]{\jobname} 258\usepackage[citecmd=autocite,defaultindex]{\jobname}
212\IndexSubtypeAs{classical}{primary} 259\IndexSubtypeAs{classical}{primary}
@@ -225,13 +272,19 @@
225\newclassic{nadim}{\classicsRoman{#1}|.#1|, #1} 272\newclassic{nadim}{\classicsRoman{#1}|.#1|, #1}
226\newclassic{aristotle}{#1|\textit{#1}|#1} 273\newclassic{aristotle}{#1|\textit{#1}|#1}
227\usepackage[scale=1.5]{ccicons} 274\usepackage[scale=1.5]{ccicons}
228\usepackage{dox} 275%^^A dox does not work with the latest latex-dev:
229\doxitem{Option}{option}{options} 276\ifdefined\SpecialMacroIndex
277 \NewDocElement{Option}{option}
278\else
279 \usepackage{dox}
280 \doxitem{Option}{option}{options}
281\fi
230\usepackage{enumitem} 282\usepackage{enumitem}
231\setlist{nosep} 283\setlist{nosep}
232\setlist[itemize]{label=\textendash} 284\setlist[itemize]{label=\textendash}
233\setlist[enumerate,1]{label=(\alph*)} 285\setlist[enumerate,1]{label=(\alph*)}
234\setlist[enumerate,2]{label=\roman*.} 286\setlist[enumerate,2]{label=\roman*.}
287\usepackage[shortcuts, nospacearound]{extdash}
235\usepackage[lot]{multitoc} 288\usepackage[lot]{multitoc}
236\usepackage{nameref} 289\usepackage{nameref}
237\usepackage{csquotes} 290\usepackage{csquotes}
@@ -243,14 +296,21 @@
243\usepackage{units} 296\usepackage{units}
244\usepackage{minted} 297\usepackage{minted}
245\usepackage[contents]{colordoc} 298\usepackage[contents]{colordoc}
246\newcommand{\package}[1]{\textsf{#1}\index{#1=#1 (package)}} 299\newcommand{\pkg}[1]{\textsf{#1}\index{#1=#1 (package)}}
247\usepackage{tikz} 300\usepackage{tikz}
248\usepackage[breakable, skins, xparse, minted]{tcolorbox} 301\usepackage[breakable, skins, xparse, minted]{tcolorbox}
249\tcbset{colback=white, boxrule=.15mm, colframe=cinnamon, 302\tcbset{colback=white, boxrule=.15mm, colframe=cinnamon,
250 breakable} 303 breakable}
251\newtcblisting{example}{minted options={linenos, numbersep=0mm}} 304\newtcblisting{example}{minted options={linenos, numbersep=0mm}}
252\newtcblisting{code}{minted options={linenos, numbersep=0mm}, listing 305\newtcblisting{pkgcode}{minted options={linenos, numbersep=0mm}, listing
253 only} 306 only}
307\NewDocumentCommand{\newfeature}{o}{%
308 \leavevmode
309 \IfNoValueTF{#1}
310 {\marginpar{\hfill\emph{New feature}}}
311 {\marginpar{\hfill\emph{New feature} #1}}%
312 \ignorespaces
313}
254\usepackage{etoc} 314\usepackage{etoc}
255\etocsettocdepth{paragraph} 315\etocsettocdepth{paragraph}
256\newcommand{\icitetableofcontents}{% 316\newcommand{\icitetableofcontents}{%
@@ -289,7 +349,7 @@
289%</driver> 349%</driver>
290% \fi 350% \fi
291% 351%
292% \CheckSum{360} 352% \CheckSum{0}
293% 353%
294% \CharacterTable 354% \CharacterTable
295% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z 355% {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
@@ -327,23 +387,19 @@
327% \GetFileInfo{\jobname.dtx} 387% \GetFileInfo{\jobname.dtx}
328% \DoNotIndex{\newcommand,\newenvironment} 388% \DoNotIndex{\newcommand,\newenvironment}
329% 389%
330% \newcommand*{\NEWfeature}[1]{% 390% \pdfbookmark[1]{\metaterm{title}}{title}
331% \hskip 1sp \marginpar{\small\sffamily\raggedright 391% \begin{tcolorbox}[
332% New feature\\#1}} 392% colframe=black,
393% enhanced,
394% drop lifted shadow,
395% colback=white,
396% boxrule=.25mm,
397% halign=center,
398% center
399% ]
400% \metapick[print]{titletext}
401% \end{tcolorbox}
333% 402%
334% \title{\tcbox[colframe=black, enhanced, tikznode, drop lifted
335% shadow, colback=white, boxrule=.25mm]{%
336% The \textsf{icite} package\\
337% \emph{Indices locorum citatorum}\\
338% \fileversion\ --- \filedate}}
339%
340% \author{Robert Alessi \\
341% \href{mailto:alessi@robertalessi.net?Subject=icite package}%
342% {\texttt{alessi@robertalessi.net}}}
343%
344% \date{}
345%
346% \maketitle
347% \footnotesize 403% \footnotesize
348% \icitetableofcontents 404% \icitetableofcontents
349% \normalsize 405% \normalsize
@@ -351,32 +407,38 @@
351% \changes{v1.00}{2019/03/07}{First public release} 407% \changes{v1.00}{2019/03/07}{First public release}
352% 408%
353% \begin{abstract} 409% \begin{abstract}
354% \package{icite} is designed to produce from \hologo{BibTeX} or 410% \pkg{icite} is designed to produce from \hologo{BibTeX} or
355% Bib\LaTeX\ bibliographical databases the different indices of 411% Bib\LaTeX\ bibliographical databases the different indices of
356% authors and works cited which are called \emph{indices locorum 412% authors and works cited which are called \emph{indices locorum
357% citatorum}. It relies on a specific \cs{icite} command and can 413% citatorum}. It relies on a specific \cs{icite} command and can
358% operate with either \hologo{BibTeX} or Bib\LaTeX. 414% operate with either \hologo{BibTeX} or Bib\LaTeX.
359% \end{abstract} 415% \end{abstract}
360% 416%
361% \section*{License and disclamer} 417% \section*{License and Disclaimer}
362% \addcontentsline{toc}{section}{License and disclamer} 418% \addcontentsline{toc}{section}{License and disclamer}
363% \subsection*{License applicable to the software} 419% \subsection*{License Applicable to this Document}
420% \pdfbookmark[2]{Licence applicable to this document}{copyright-doc}
421% \leavevmode\marginpar{\hfill\texttt{fdl1.3}}
422% \metapick[print]{rightstext} (See below \vref{sec:fdl}.)
423%
424% \subsection*{License Applicable to the Software}
425% \pdfbookmark[2]{Licence applicable to the software}{copyright-soft}
364% \label{sec:license-software} 426% \label{sec:license-software}
365% 427%
366% \package{icite} --- \emph{Indices locorum citatorum}\\ 428% \pkg{icite} --- \metapick[print]{subtitle}
367% Copyright \textcopyright\ 2019--2020 Robert Alessi 429% \metapick[print]{copyrightstatement}
368% 430%
369% Please send error reports and suggestions for improvements to Robert 431% Please send error reports and suggestions for improvements to Robert
370% Alessi: 432% Alessi:
371% \begin{itemize} 433% \begin{itemize}
372% \item email: \mailto[icite package]{alessi@roberalessi.net} 434% \item email: \mailto[icite package]{Robert Alessi <alessi@roberalessi.net>}
373% \item website: \url{http://www.robertalessi.net/icite} 435% \item website: \url{http://www.robertalessi.net/icite}
374% \item development: \url{http://git.robertalessi.net/icite} 436% \item development: \url{http://git.robertalessi.net/icite}
375% \item comments, feature requests, bug reports: 437% \item comments, feature requests, bug reports:
376% \url{https://gitlab.com/ralessi/icite/issues} 438% \url{https://gitlab.com/ralessi/icite/issues}
377% \end{itemize} 439% \end{itemize}
378% 440%
379% \marginpar{\texttt{gpl3+}} 441% \leavevmode\marginpar{\hfill\texttt{gpl3+}}
380% This program is free software: you can redistribute it and/or modify 442% This program is free software: you can redistribute it and/or modify
381% it under the terms of the GNU General Public License as published by 443% it under the terms of the GNU General Public License as published by
382% the Free Software Foundation, either version 3 of the License, or 444% the Free Software Foundation, either version 3 of the License, or
@@ -389,9 +451,10 @@
389% 451%
390% You should have received a copy of the GNU General Public License 452% You should have received a copy of the GNU General Public License
391% along with this program. If not, see 453% along with this program. If not, see
392% <http://www.gnu.org/licenses/>. 454% \href{http://www.gnu.org/licenses}%
455% {\texttt{<http://www.gnu.org/licenses/>}}.
393% 456%
394% This release of \package{icite} consists of the following 457% This release of \pkg{icite} consists of the following
395% source files: 458% source files:
396% \begin{itemize} 459% \begin{itemize}
397% \item |icite.dtx| 460% \item |icite.dtx|
@@ -399,18 +462,6 @@
399% \item |Makefile| 462% \item |Makefile|
400% \end{itemize} 463% \end{itemize}
401% 464%
402% \subsection*{License applicable to this document}
403% \label{sec:documentation-license}
404% Copyright \textcopyright\ 2019--2020 Robert Alessi
405%
406% \ccbysa\marginpar{\texttt{CC BY-SA 4.0}}
407% This document is licensed under the Creative Commons
408% Attribution-ShareAlike 4.0 International License. To view a copy of
409% this license, visit
410% \url{http://creativecommons.org/licenses/by-sa/4.0/} or send a
411% letter to Creative Commons, PO Box 1866, Mountain View, CA 94042,
412% USA.
413%
414% \section{Introduction} 465% \section{Introduction}
415% \label{sec:introduction} 466% \label{sec:introduction}
416% Bib\LaTeX\ features a very powerful internal mechanism which 467% Bib\LaTeX\ features a very powerful internal mechanism which
@@ -427,27 +478,27 @@
427% intricate business and requires knowing how to redefine and/or patch 478% intricate business and requires knowing how to redefine and/or patch
428% standard and internal Bib\LaTeX\ commands. 479% standard and internal Bib\LaTeX\ commands.
429% 480%
430% The \package{icite} package is but a modest piece of software which 481% The \pkg{icite} package is but a modest piece of software which
431% addresses this situation. It relies on citation commands, but does 482% addresses this situation. It relies on citation commands, but does
432% not require Bib\LaTeX. Instead, \hologo{BibTeX} can be used as 483% not require Bib\LaTeX. Instead, \hologo{BibTeX}, or even no
433% \package{icite} uses the \package{usebib} 484% bibliographic engine, can be used as \pkg{icite} uses the
434% package\footnote{\cite{usebib}} to build the indices by drawing 485% \pkg{usebib} package\footnote{\cite{usebib}} to build the indices by
435% directly from the bibliographical database. 486% drawing directly from the bibliographical database.
436% 487%
437% 488%
438% \section[The \package{icite} package]{The \textsf{icite} package} 489% \section[The \pkg{icite} package]{The \textsf{icite} Package}
439% The \package{icite} package is loaded as usual like so:--- 490% The \pkg{icite} package is loaded as usual like so:---
440% \iffalse 491% \iffalse
441%<*example> 492%<*example>
442% \fi 493% \fi
443\begin{code} 494\begin{pkgcode}
444 \usepackage[<options>]{icite} 495 \usepackage[<options>]{icite}
445\end{code} 496\end{pkgcode}
446% \iffalse 497% \iffalse
447%</example> 498%</example>
448% \fi 499% \fi
449% 500%
450% \package{icite} may be loaded with three optional \enquote*{named 501% \pkg{icite} may be loaded with three optional \enquote*{named
451% arguments} either of which is set using the syntax 502% arguments} either of which is set using the syntax
452% \meta{key}$=$\meta{value}. The description of the optional arguments 503% \meta{key}$=$\meta{value}. The description of the optional arguments
453% follows:--- 504% follows:---
@@ -468,17 +519,17 @@
468% passages in the default general index, unless |defaultindex| is set 519% passages in the default general index, unless |defaultindex| is set
469% to the value |none|, in which case indexing is disabled. It must be 520% to the value |none|, in which case indexing is disabled. It must be
470% noted that this named argument does not need a value as it defaults 521% noted that this named argument does not need a value as it defaults
471% to |loccit| if it is used alone. This is an easy way to have all 522% to |loccit| if used alone. This is an easy way to have all passages
472% passages cited indexed in a separate index named |loccit|. 523% cited indexed in a separate index named |loccit|.
473% 524%
474% \DescribeOption{nobibengine}\NEWfeature{v1.1} 525% \DescribeOption{nobibengine}\newfeature[v1.1]
475% \changes{v1.1}{2019/03/12}{New global option \texttt{nobibengine}}% 526% \changes{v1.1}{2019/03/12}{New global option \texttt{nobibengine}}%
476% |nobibengine|$=$|true|\verb+|+|false|\hfill% 527% |nobibengine|$=$|true|\verb+|+|false|\hfill%
477% \tcboxverb{Default: not set}\\ 528% \tcboxverb{Default: not set}\\
478% This named argument does not need a value as it defaults to |true| 529% This named argument does not need a value as it defaults to |true|
479% if it is used. When this option is activated, \package{icite} does 530% if used. When this option is activated, \pkg{icite} does not use
480% not use \hologo{BibTeX} or Bib\LaTeX\ to insert the citations in the 531% \hologo{BibTeX} or Bib\LaTeX\ to insert the citations in the body
481% body text---even if either is loaded in the preamble---and pulls the 532% text\---even if either be loaded in the preamble\---and pulls the
482% necessary information directly from the bibliographical 533% necessary information directly from the bibliographical
483% database. For this reason, \cs{bibinput} described below is of 534% database. For this reason, \cs{bibinput} described below is of
484% course still required. The citations inserted consist of the 535% course still required. The citations inserted consist of the
@@ -488,31 +539,31 @@
488% it takes precedence over the fields used to define author names and 539% it takes precedence over the fields used to define author names and
489% titles. 540% titles.
490% 541%
491% \paragraph{Bibliographical database} 542% \paragraph{Bibliographical Database}
492% \DescribeMacro{\bibinput} Once \package{icite} is loaded, it must be 543% \DescribeMacro{\bibinput} Once \pkg{icite} is loaded, it must be
493% connected to at least one bibliographic |.bib| file. To that end, 544% connected to at least one bibliographic |.bib| file. To that end,
494% \package{icite} uses the same \cs{bibinput} command as 545% \pkg{icite} uses the same \cs{bibinput} command as
495% \package{usebib}.\footnote{Please refer to \cite[1]{usebib} for 546% \pkg{usebib}.\footnote{Please refer to \cite[1]{usebib} for
496% more detailed information on how to use this command.} An example 547% more detailed information on how to use this command.} An example
497% follows:--- % 548% follows:--- %
498% \iffalse 549% \iffalse
499%<*example> 550%<*example>
500% \fi 551% \fi
501\begin{code} 552\begin{pkgcode}
502 % load icite, have \icite use \autocite by default, and insert cited 553 % load icite, have \icite use \autocite by default, and insert cited
503 % passages in a separate index named 'loccit': 554 % passages in a separate index named 'loccit':
504 \usepackage[citecmd=autocite, defaultindex]{icite} 555 \usepackage[citecmd=autocite, defaultindex]{icite}
505 % note that the .bib file must be stripped of its extension: 556 % note that the .bib file must be stripped of its extension:
506 \bibinput{bibliography} % that is: load bibliography.bib 557 \bibinput{bibliography} % that is: load bibliography.bib
507\end{code} 558\end{pkgcode}
508% \iffalse 559% \iffalse
509%</example> 560%</example>
510% \fi 561% \fi
511% 562%
512% \subsection{Preamble-only commands} 563% \subsection{Preamble-only Commands}
513% The following commands may be found in the preamble only. 564% The following commands may be found in the preamble only.
514% \paragraph{Styling the titles} 565% \paragraph{Styling the Titles}
515% \DescribeMacro{\SetTitleStyle} By default, \package{icite} prints 566% \DescribeMacro{\SetTitleStyle} By default, \pkg{icite} prints
516% the titles of the works cited in italics.\\ 567% the titles of the works cited in italics.\\
517% \cs{SetTitleStyle}\marg{formatting directives} can be used in the 568% \cs{SetTitleStyle}\marg{formatting directives} can be used in the
518% preamble only to customize the way titles are displayed in the 569% preamble only to customize the way titles are displayed in the
@@ -520,9 +571,9 @@
520% \iffalse 571% \iffalse
521%<*example> 572%<*example>
522% \fi 573% \fi
523\begin{code} 574\begin{pkgcode}
524 \SetTitleStyle{\textbf{#1}} 575 \SetTitleStyle{\textbf{#1}}
525\end{code} 576\end{pkgcode}
526% \iffalse 577% \iffalse
527%</example> 578%</example>
528% \fi 579% \fi
@@ -531,7 +582,7 @@
531% command. 582% command.
532% 583%
533% \paragraph{Delimiters} 584% \paragraph{Delimiters}
534% \NEWfeature{v1.2}\DescribeMacro{\AuthorTitleDelim} 585% \DescribeMacro{\AuthorTitleDelim}\newfeature[v1.2]
535% \cs{AuthorTitleDelim}\marg{delimiter} sets the delimiter between 586% \cs{AuthorTitleDelim}\marg{delimiter} sets the delimiter between
536% authors and titles in the body text when the |nobibengine| option is 587% authors and titles in the body text when the |nobibengine| option is
537% set to |true|. The default delimiter is a comma and a space. 588% set to |true|. The default delimiter is a comma and a space.
@@ -542,13 +593,13 @@
542% set to |true|. The default delimiter is a comma and a space. 593% set to |true|. The default delimiter is a comma and a space.
543% 594%
544% \subsection[\textsf{icite} for the Impatient]% 595% \subsection[\textsf{icite} for the Impatient]%
545% {\package{icite} for the Impatient} 596% {\pkg{icite} for the Impatient}
546% Read \href{samples/icite-minimal.pdf}{\texttt{icite-minimal.pdf}}. 597% Read \href{samples/icite-minimal.pdf}{\texttt{icite-minimal.pdf}}.
547% 598%
548% \subsection{Entry fields} 599% \subsection{Entry Fields}
549% \label{sec:entry-fields} 600% \label{sec:entry-fields}
550% \subsubsection{Author names} 601% \subsubsection{Author Names}
551% To process author names, \package{icite} uses the following entry 602% To process author names, \pkg{icite} uses the following entry
552% fields: 603% fields:
553% \begin{description} 604% \begin{description}
554% \item[author] As for example in |author = {Ullmann, Manfred}|, which 605% \item[author] As for example in |author = {Ullmann, Manfred}|, which
@@ -575,10 +626,10 @@
575% |sortname = {{|Hunayn ibn Ishaq|}}| 626% |sortname = {{|Hunayn ibn Ishaq|}}|
576% 627%
577% \subsection{Titles} 628% \subsection{Titles}
578% To process titles, \package{icite} uses the following entry fields: 629% To process titles, \pkg{icite} uses the following entry fields:
579% \begin{description} 630% \begin{description}
580% \item[title] The full title of the work. 631% \item[title] The full title of the work.
581% \item[shorttitle] The title in an abriged form. If this entry is 632% \item[shorttitle] The title in an abriged form. If this entry be
582% set, it takes precedence over the |title| field in the printed index. 633% set, it takes precedence over the |title| field in the printed index.
583% \item[indextitle] This field may be used to have a title such as 634% \item[indextitle] This field may be used to have a title such as
584% \emph{The {\TeX}Book} printed in the index as \emph{{\TeX}Book, The}. 635% \emph{The {\TeX}Book} printed in the index as \emph{{\TeX}Book, The}.
@@ -588,8 +639,8 @@
588% |indexsorttitle = {TEXBook}| 639% |indexsorttitle = {TEXBook}|
589% \end{description} 640% \end{description}
590% 641%
591% \section{Basic use} 642% \section{Basic Use}
592% \DescribeMacro{\icite} \package{icite} provides the \cs{icite} 643% \DescribeMacro{\icite} \pkg{icite} provides the \cs{icite}
593% command which both inserts a formatted citation in the body text and 644% command which both inserts a formatted citation in the body text and
594% an entry corresponding to the passage cited in the index. This 645% an entry corresponding to the passage cited in the index. This
595% command is to be used in place of any \hologo{BibTeX} or Bib\LaTeX\ 646% command is to be used in place of any \hologo{BibTeX} or Bib\LaTeX\
@@ -602,9 +653,9 @@
602% \iffalse 653% \iffalse
603%<*example> 654%<*example>
604% \fi 655% \fi
605\begin{code} 656\begin{pkgcode}
606 \icite[<pre>][<post>]{<key>}[<command>] 657 \icite[<pre>][<post>]{<key>}[<command>]
607\end{code} 658\end{pkgcode}
608% \iffalse 659% \iffalse
609%</example> 660%</example>
610% \fi 661% \fi
@@ -614,15 +665,24 @@
614% default in the preamble by means of the |citecmd| global 665% default in the preamble by means of the |citecmd| global
615% option.\footnote{See above, \vref{ref:citecmd}.} 666% option.\footnote{See above, \vref{ref:citecmd}.}
616% 667%
668% \paragraph{List of References} \newfeature[v1.4]
669% \changes{v1.4}{2021/07/07}{\textsf{icite} now indexes separately
670% lists of references} The references inserted in the \meta{post}
671% argument of \cs{icite} may consist of single numbers\---as in |25|,
672% |vii| or |XIV|\---ranges of numbers\---as in |34--38| or
673% |iv--x|\---or lists of numbers. In the latter case, references must
674% be separated from one another by semicolons (|;|), like so: |12;|
675% |21;| |34--38|.
676%
617% \paragraph{Example} The following example illustrates how 677% \paragraph{Example} The following example illustrates how
618% \package{icite} can be used in combination with Bib\LaTeX\ and the 678% \pkg{icite} can be used in combination with Bib\LaTeX\ and the
619% \package{imakeidx} package to have the passages cited sorted and 679% \pkg{imakeidx} package to have the passages cited sorted and
620% printed in a separate, specific \enquote*{Index of Passages 680% printed in a separate, specific \enquote*{Index of Passages
621% Cited}:--- % 681% Cited}:--- %
622% \iffalse 682% \iffalse
623%<*example> 683%<*example>
624% \fi 684% \fi
625\begin{code} 685\begin{pkgcode}
626 % preamble 686 % preamble
627 % load icite, have \icite use \autocite by default, and insert cited 687 % load icite, have \icite use \autocite by default, and insert cited
628 % passages in a separate index named 'loccit': 688 % passages in a separate index named 'loccit':
@@ -637,7 +697,7 @@
637 % load imakeidx and use xindy to have the numbers sorted properly 697 % load imakeidx and use xindy to have the numbers sorted properly
638 \usepackage[xindy]{imakeidx} 698 \usepackage[xindy]{imakeidx}
639 \makeindex[name=loccit, title=Index of Passages Cited (modern authors)] 699 \makeindex[name=loccit, title=Index of Passages Cited (modern authors)]
640\end{code} 700\end{pkgcode}
641% \iffalse 701% \iffalse
642%</example> 702%</example>
643% \fi 703% \fi
@@ -646,11 +706,11 @@
646% \iffalse 706% \iffalse
647%<*example> 707%<*example>
648% \fi 708% \fi
649\begin{code} 709\begin{pkgcode}
650 \section*{\cs{icite} in action} 710 \section*{\cs{icite} in Action}
651 Let us start with four citations of the same reference, to make sure 711 Let us start with four citations of the same reference, to make sure
652 that they are all indexed and sorted properly: 712 that they are all indexed and sorted properly: one\icite[123;
653 one\icite[123]{Ullmann1970}, two\icite[231]{Ullmann1970}, 713 141--148; 245]{Ullmann1970}, two\icite[231]{Ullmann1970},
654 three\icite[81]{Ullmann1970} and four\icite[18]{Ullmann1970}. 714 three\icite[81]{Ullmann1970} and four\icite[18]{Ullmann1970}.
655 715
656 Let us continue with four other citations out of two other 716 Let us continue with four other citations out of two other
@@ -660,16 +720,16 @@
660 Finally, let us have \cs{icite} use \cs{textcite} to cite 720 Finally, let us have \cs{icite} use \cs{textcite} to cite
661 \icite[123]{Endress1992}[textcite], and again, this time in a 721 \icite[123]{Endress1992}[textcite], and again, this time in a
662 footnote\icite[86]{Endress1992}. 722 footnote\icite[86]{Endress1992}.
663\end{code} 723\end{pkgcode}
664% \iffalse 724% \iffalse
665%</example> 725%</example>
666% \fi 726% \fi
667% 727%
668% \begin{tcblisting}{text only} 728% \begin{tcblisting}{text only}
669% \section*{\cs{icite} in action} 729% \section*{\cs{icite} in Action}
670% Let us start with four citations of the same reference, to make 730% Let us start with four citations of the same reference, to make
671% sure that they are all indexed and sorted properly: 731% sure that they are all indexed and sorted properly: one\icite[123;
672% one\icite[123]{Ullmann1970}, two\icite[231]{Ullmann1970}, 732% 141--148; 245]{Ullmann1970}, two\icite[231]{Ullmann1970},
673% three\icite[81]{Ullmann1970} and four\icite[18]{Ullmann1970}. 733% three\icite[81]{Ullmann1970} and four\icite[18]{Ullmann1970}.
674% 734%
675% Let us continue with four other citations out of two other 735% Let us continue with four other citations out of two other
@@ -685,23 +745,23 @@
685% been used can be found below in the appendix 745% been used can be found below in the appendix
686% (\vrefrange{ref:indices}{ref:icite-bib} respectively). As can be 746% (\vrefrange{ref:indices}{ref:icite-bib} respectively). As can be
687% seen by comparing the bibliography generated in the footnotes with 747% seen by comparing the bibliography generated in the footnotes with
688% the text printed in the index, \package{icite} prints as expected 748% the text printed in the index, \pkg{icite} prints as expected
689% the abridged forms of the titles when they are 749% the abridged forms of the titles when they are
690% available. Furthermore, as a default citation command set in the 750% available. Furthermore, as a default citation command set in the
691% preamble, the \enquote*{oxnotes} Bib\LaTeX\ option of 751% preamble, the \enquote*{oxnotes} Bib\LaTeX\ option of
692% \package{biblatex-oxref} style package makes \cs{autocite} behave 752% \pkg{biblatex-oxref} style package makes \cs{autocite} behave
693% like \cs{footcite}. Finally, the page numbers in the index are 753% like \cs{footcite}. Finally, the page numbers in the index are
694% sorted properly: for example, two-digit numbers, like 81, are listed 754% sorted properly: for example, two-digit numbers, like 81, are listed
695% before 123. 755% before 123.
696% 756%
697% \section{Refined use} 757% \section{Refined Use}
698% When references are made not only to modern authors but also to 758% When references are made not only to modern authors but also to
699% authors and works from classical antiquity or from the Middle Ages, 759% authors and works from classical antiquity or from the Middle Ages,
700% it is commonly agreed that at least two separate indices of passages 760% it is commonly agreed that at least two separate indices of passages
701% cited should be made. Another option is not to index passages cited 761% cited should be made. Another option is not to index passages cited
702% from modern authors at all. 762% from modern authors at all.
703% 763%
704% \DescribeMacro{\IndexSubtypeAs} \package{icite} is able to 764% \DescribeMacro{\IndexSubtypeAs} \pkg{icite} is able to
705% differentiate between sources by drawing from the bibliographical 765% differentiate between sources by drawing from the bibliographical
706% database the exact string that may be found in the |entrysubtype| 766% database the exact string that may be found in the |entrysubtype|
707% entry field. To that end, the \cs{IndexSubtypeAs} command is 767% entry field. To that end, the \cs{IndexSubtypeAs} command is
@@ -709,9 +769,9 @@
709% \iffalse 769% \iffalse
710%<*example> 770%<*example>
711% \fi 771% \fi
712\begin{code} 772\begin{pkgcode}
713 \IndexSubtypeAs{<subtype>}{<index_name>} 773 \IndexSubtypeAs{<subtype>}{<index_name>}
714\end{code} 774\end{pkgcode}
715% \iffalse 775% \iffalse
716%</example> 776%</example>
717% \fi 777% \fi
@@ -728,7 +788,7 @@
728% \iffalse 788% \iffalse
729%<*example> 789%<*example>
730% \fi 790% \fi
731\begin{code} 791\begin{pkgcode}
732 % load icite, and have cited authors indexed in an index named 792 % load icite, and have cited authors indexed in an index named
733 % 'secondary': 793 % 'secondary':
734 \usepackage[defaultindex=secondary]{icite} 794 \usepackage[defaultindex=secondary]{icite}
@@ -738,7 +798,7 @@
738 % authors whose 'entrysubtype' field matches the string 'medieval' 798 % authors whose 'entrysubtype' field matches the string 'medieval'
739 % should go into the same index: 799 % should go into the same index:
740 \IndexSubtypeAs{medieval}{primary} 800 \IndexSubtypeAs{medieval}{primary}
741\end{code} 801\end{pkgcode}
742% \iffalse 802% \iffalse
743%</example> 803%</example>
744% \fi 804% \fi
@@ -746,7 +806,7 @@
746% \iffalse 806% \iffalse
747%<*example> 807%<*example>
748% \fi 808% \fi
749\begin{code} 809\begin{pkgcode}
750 % load icite, but do not index passages cited with \icite: 810 % load icite, but do not index passages cited with \icite:
751 \usepackage[defaultindex=none]{icite} 811 \usepackage[defaultindex=none]{icite}
752 % except for authors whose 'entrysubtype' field matches the string 812 % except for authors whose 'entrysubtype' field matches the string
@@ -755,7 +815,7 @@
755 % authors whose 'entrysubtype' field matches the string 'medieval' 815 % authors whose 'entrysubtype' field matches the string 'medieval'
756 % should go into the same index: 816 % should go into the same index:
757 \IndexSubtypeAs{medieval}{primary} 817 \IndexSubtypeAs{medieval}{primary}
758\end{code} 818\end{pkgcode}
759% \iffalse 819% \iffalse
760%</example> 820%</example>
761% \fi 821% \fi
@@ -765,14 +825,14 @@
765% |classical| should go into the default |loccit| index. As for those 825% |classical| should go into the default |loccit| index. As for those
766% whose |entrysubtype| matches |classical|, they should to into an 826% whose |entrysubtype| matches |classical|, they should to into an
767% index named |primary|. \label{ref:classics-pkg}Furthermore, the 827% index named |primary|. \label{ref:classics-pkg}Furthermore, the
768% \package{classics} package is used to format references in which a 828% \pkg{classics} package is used to format references in which a
769% volume number is used.\footnote{For more information, see below 829% volume number is used.\footnote{For more information, see below
770% \vref{sec:classics-usage}.} In this way, \package{xindy} only has 830% \vref{sec:classics-usage}.} In this way, \pkg{xindy} only has
771% numbers to handle:--- % 831% numbers to handle:--- %
772% \iffalse 832% \iffalse
773%<*example> 833%<*example>
774% \fi 834% \fi
775\begin{code} 835\begin{pkgcode}
776 % preamble 836 % preamble
777 \usepackage[style=oxnotes]{biblatex} 837 \usepackage[style=oxnotes]{biblatex}
778 \addbibresource{bibliography.bib} 838 \addbibresource{bibliography.bib}
@@ -788,7 +848,7 @@
788 848
789 \usepackage[citecmd=autocite,defaultindex]{icite} 849 \usepackage[citecmd=autocite,defaultindex]{icite}
790 \IndexSubtypeAs{classical}{primary} 850 \IndexSubtypeAs{classical}{primary}
791\end{code} 851\end{pkgcode}
792% \iffalse 852% \iffalse
793%</example> 853%</example>
794% \fi 854% \fi
@@ -797,11 +857,11 @@
797% \iffalse 857% \iffalse
798%<*example> 858%<*example>
799% \fi 859% \fi
800\begin{code} 860\begin{pkgcode}
801 \section*{\cs{icite} in action} 861 \section*{\cs{icite} in Action}
802 Let us start with four citations of the same reference, to make sure 862 Let us start with four citations of the same reference, to make sure
803 that they are all indexed and sorted properly: 863 that they are all indexed and sorted properly: one\icite[123;
804 one\icite[123]{Ullmann1970}, two\icite[231]{Ullmann1970}, 864 141--148; 245]{Ullmann1970}, two\icite[231]{Ullmann1970},
805 three\icite[81]{Ullmann1970} and four\icite[18]{Ullmann1970}. 865 three\icite[81]{Ullmann1970} and four\icite[18]{Ullmann1970}.
806 866
807 Let us continue with four other citations out of two other 867 Let us continue with four other citations out of two other
@@ -820,16 +880,16 @@
820 Finally, let us have \cs{icite} use \cs{textcite} to cite 880 Finally, let us have \cs{icite} use \cs{textcite} to cite
821 \icite[123]{Endress1992}[textcite], and again, this time in a 881 \icite[123]{Endress1992}[textcite], and again, this time in a
822 footnote\icite[86]{Endress1992}. 882 footnote\icite[86]{Endress1992}.
823\end{code} 883\end{pkgcode}
824% \iffalse 884% \iffalse
825%</example> 885%</example>
826% \fi 886% \fi
827% 887%
828% \begin{tcblisting}{text only} 888% \begin{tcblisting}{text only}
829% \section*{\cs{icite} in action} 889% \section*{\cs{icite} in Action}
830% Let us start with four citations of the same reference, to make 890% Let us start with four citations of the same reference, to make
831% sure that they are all indexed and sorted properly: 891% sure that they are all indexed and sorted properly: one\icite[123;
832% one\icite[123]{Ullmann1970}, two\icite[231]{Ullmann1970}, 892% 141--148; 245]{Ullmann1970}, two\icite[231]{Ullmann1970},
833% three\icite[81]{Ullmann1970} and four\icite[18]{Ullmann1970}. 893% three\icite[81]{Ullmann1970} and four\icite[18]{Ullmann1970}.
834% 894%
835% Let us continue with four other citations out of two other 895% Let us continue with four other citations out of two other
@@ -859,23 +919,23 @@
859% 919%
860% 920%
861% \subsection[The \textsf{classics} package]% 921% \subsection[The \textsf{classics} package]%
862% {The \package{classics} package} % 922% {The \pkg{classics} Package} %
863% \label{sec:classics-usage} 923% \label{sec:classics-usage}
864% As said above \vpageref{ref:classics-pkg}, it is advisable to use 924% As said above \vpageref{ref:classics-pkg}, it is advisable to use
865% the \package{classics} package to format volume, page, column, line 925% the \pkg{classics} package to format volume, page, column, line
866% numbers and the like which are inserted in the \meta{post} optional 926% numbers and the like which are inserted in the \meta{post} optional
867% argument of the \cs{icite} command\autocite{classics}. An example of 927% argument of the \cs{icite} command\autocite{classics}. An example of
868% using \package{classics} to format references to Aristotle according 928% using \pkg{classics} to format references to Aristotle according
869% to Bekker pagination follows:\footnote{See \cite[2]{classics} for 929% to Bekker pagination follows:\footnote{See \cite[2]{classics} for
870% more information.}--- % 930% more information.}--- %
871% \iffalse 931% \iffalse
872%<*example> 932%<*example>
873% \fi 933% \fi
874\begin{code} 934\begin{pkgcode}
875 % preamble: 935 % preamble:
876 \usepackage{classics} 936 \usepackage{classics}
877 \newclassic{aristotle}{#1|\textit{#1}|#1} 937 \newclassic{aristotle}{#1|\textit{#1}|#1}
878\end{code} 938\end{pkgcode}
879% \iffalse 939% \iffalse
880%</example> 940%</example>
881% \fi 941% \fi
@@ -893,7 +953,7 @@
893% \iffalse 953% \iffalse
894%</example> 954%</example>
895% \fi 955% \fi
896% The following prints the same body text while using \package{icite} 956% The following prints the same body text while using \pkg{icite}
897% to have the passages cited inserted in the \emph{Index locorum 957% to have the passages cited inserted in the \emph{Index locorum
898% citatorum} (see below \vref{sec:index-loc-cit}):--- % 958% citatorum} (see below \vref{sec:index-loc-cit}):--- %
899% \iffalse 959% \iffalse
@@ -916,21 +976,21 @@
916% As can be seen, the \cs{notecite} and \cs{pnotecite} commands have 976% As can be seen, the \cs{notecite} and \cs{pnotecite} commands have
917% been used to insert only the references in the body text. 977% been used to insert only the references in the body text.
918% 978%
919% It is also advisable to use \package{xindy} to compile indices of 979% It is also advisable to use \pkg{xindy} to compile indices of
920% passages cited because \package{xindy}, unlike \package{makeindex} 980% passages cited because \pkg{xindy}, unlike \pkg{makeindex}
921% or \package{xindex}, is able to sort numbers properly: for example, 981% or \pkg{xindex}, is able to sort numbers properly: for example,
922% with \package{xindy}, such a number as 81 will come before 100, but 982% with \pkg{xindy}, such a number as 81 will come before 100, but
923% will be sorted after 100 with the other two engines. 983% will be sorted after 100 with the other two engines.
924% \begin{tcblisting}{text only, title=Caveat} 984% \begin{tcblisting}{text only, title=Caveat}
925% \package{xindy} (actually |texindy|) is also designed to ignore 985% \pkg{xindy} (actually |texindy|) is also designed to ignore
926% \TeX\ commands by default. However, due to a missing line in 986% \TeX\ commands by default. However, due to a missing line in
927% |xindy/modules/base/tex.xdy|,\footnote{As the time of writing, in 987% |xindy/modules/base/tex.xdy|,\footnote{As the time of writing, in
928% \package{xindy} v2.5.1.} this does not apply to so-called 988% \pkg{xindy} v2.5.1.} this does not apply to so-called
929% \enquote*{starred} \TeX\ commands, such as \cs{aristotle*} from 989% \enquote*{starred} \TeX\ commands, such as \cs{aristotle*} from
930% the example above. 990% the example above.
931% \end{tcblisting} 991% \end{tcblisting}
932% One easy way to get around this issue is to create a style file with 992% One easy way to get around this issue is to create a style file with
933% a single line that instructs \package{xindy} to ignore the asterisk 993% a single line that instructs \pkg{xindy} to ignore the asterisk
934% when processing the index, like so:--- % 994% when processing the index, like so:--- %
935% \iffalse 995% \iffalse
936%<*example> 996%<*example>
@@ -947,13 +1007,13 @@
947% \iffalse 1007% \iffalse
948%<*example> 1008%<*example>
949% \fi 1009% \fi
950\begin{code} 1010\begin{pkgcode}
951 % preamble: 1011 % preamble:
952 \usepackage[xindy]{imakeidx} 1012 \usepackage[xindy]{imakeidx}
953 \makeindex[name=loccit, options=-M icite.xdy] 1013 \makeindex[name=loccit, options=-M icite.xdy]
954 % document: 1014 % document:
955 \printindex[loccit] 1015 \printindex[loccit]
956\end{code} 1016\end{pkgcode}
957% \iffalse 1017% \iffalse
958%</example> 1018%</example>
959% \fi 1019% \fi
@@ -962,7 +1022,7 @@
962% 1022%
963% \section{Appendix} 1023% \section{Appendix}
964% Designing the layout of indices is out of the scope of this 1024% Designing the layout of indices is out of the scope of this
965% documentation. For information, the \package{tabto} package has been 1025% documentation. For information, the \pkg{tabto} package has been
966% used in the preamble in combination with the following |xindy| style 1026% used in the preamble in combination with the following |xindy| style
967% file:--- % 1027% file:--- %
968% \iffalse 1028% \iffalse
@@ -978,7 +1038,7 @@
978% 1038%
979% \subsection{Indices} 1039% \subsection{Indices}
980% \label{ref:indices} 1040% \label{ref:indices}
981% \subsubsection{Index of Passages Cited (modern authors)} 1041% \subsubsection{Index of Passages Cited (Modern Authors)}
982% \printindex[loccit] 1042% \printindex[loccit]
983% \needspace{8\baselineskip} 1043% \needspace{8\baselineskip}
984% \subsubsection{\emph{Index locorum citatorum}} 1044% \subsubsection{\emph{Index locorum citatorum}}
@@ -986,11 +1046,551 @@
986% \printindex[primary] 1046% \printindex[primary]
987% 1047%
988% \subsection{\texorpdfstring{\hologo{BibTeX} 1048% \subsection{\texorpdfstring{\hologo{BibTeX}
989% file used in this document}{BibTeX file used in this document}} 1049% File Used in this Document}{BibTeX File Used in this Document}}
990% \label{ref:icite-bib} 1050% \label{ref:icite-bib}
991% \tcbinputlisting{minted options={linenos, numbersep=1.5mm}, minted 1051% \tcbinputlisting{minted options={linenos, numbersep=1.5mm}, minted
992% language=bibtex, listing file=icite.bib, listing only} 1052% language=bibtex, listing file=icite.bib, listing only}
993% 1053%
1054% \section{GNU Free Documentation License}
1055% \label{sec:fdl}
1056% \textbf{Version 1.3, 3 November 2008}
1057%
1058% \begin{center}
1059% Version 1.3, 3 November 2008
1060%
1061% Copyright \copyright{} 2000, 2001, 2002, 2007, 2008 Free
1062% Software Foundation, Inc.
1063%
1064% \bigskip
1065%
1066% \url{https://fsf.org/}
1067%
1068% \bigskip
1069%
1070% Everyone is permitted to copy and distribute verbatim copies
1071% of this license document, but changing it is not allowed.
1072% \end{center}
1073%
1074% \needspace{3\baselineskip}
1075% \begin{center}
1076% {\bf\large Preamble}
1077% \end{center}
1078%
1079% The purpose of this License is to make a manual, textbook, or other
1080% functional and useful document \enquote{free} in the sense of
1081% freedom: to assure everyone the effective freedom to copy and
1082% redistribute it, with or without modifying it, either commercially
1083% or noncommercially. Secondarily, this License preserves for the
1084% author and publisher a way to get credit for their work, while not
1085% being considered responsible for modifications made by others.
1086%
1087% This License is a kind of \enquote{copyleft}, which means that
1088% derivative works of the document must themselves be free in the same
1089% sense. It complements the GNU General Public License, which is a
1090% copyleft license designed for free software.
1091%
1092% We have designed this License in order to use it for manuals for
1093% free software, because free software needs free documentation: a
1094% free program should come with manuals providing the same freedoms
1095% that the software does. But this License is not limited to software
1096% manuals; it can be used for any textual work, regardless of subject
1097% matter or whether it is published as a printed book. We recommend
1098% this License principally for works whose purpose is instruction or
1099% reference.
1100%
1101% \needspace{3\baselineskip}
1102% \begin{center}
1103% {\large\bf 1. APPLICABILITY AND DEFINITIONS\par}
1104% \end{center}
1105%
1106% This License applies to any manual or other work, in any medium,
1107% that contains a notice placed by the copyright holder saying it can
1108% be distributed under the terms of this License. Such a notice
1109% grants a world-wide, royalty-free license, unlimited in duration, to
1110% use that work under the conditions stated herein. The
1111% \enquote{\textbf{Document}}, below, refers to any such manual or
1112% work. Any member of the public is a licensee, and is addressed as
1113% \enquote{\textbf{you}}. You accept the license if you copy, modify
1114% or distribute the work in a way requiring permission under copyright
1115% law.
1116%
1117% A \enquote{\textbf{Modified Version}} of the Document means any work
1118% containing the Document or a portion of it, either copied verbatim,
1119% or with modifications and/or translated into another language.
1120%
1121% A \enquote{\textbf{Secondary Section}} is a named appendix or a
1122% front-matter section of the Document that deals exclusively with the
1123% relationship of the publishers or authors of the Document to the
1124% Document's overall subject (or to related matters) and contains
1125% nothing that could fall directly within that overall subject.
1126% (Thus, if the Document is in part a textbook of mathematics, a
1127% Secondary Section may not explain any mathematics.) The
1128% relationship could be a matter of historical connection with the
1129% subject or with related matters, or of legal, commercial,
1130% philosophical, ethical or political position regarding them.
1131%
1132% The \enquote{\textbf{Invariant Sections}} are certain Secondary
1133% Sections whose titles are designated, as being those of Invariant
1134% Sections, in the notice that says that the Document is released
1135% under this License. If a section does not fit the above definition
1136% of Secondary then it is not allowed to be designated as Invariant.
1137% The Document may contain zero Invariant Sections. If the Document
1138% does not identify any Invariant Sections then there are none.
1139%
1140% The \enquote{\textbf{Cover Texts}} are certain short passages of
1141% text that are listed, as Front-Cover Texts or Back-Cover Texts, in
1142% the notice that says that the Document is released under this
1143% License. A Front-Cover Text may be at most 5 words, and a
1144% Back-Cover Text may be at most 25 words.
1145%
1146% A \enquote{\textbf{Transparent}} copy of the Document means a
1147% machine-readable copy, represented in a format whose specification
1148% is available to the general public, that is suitable for revising
1149% the document straightforwardly with generic text editors or (for
1150% images composed of pixels) generic paint programs or (for drawings)
1151% some widely available drawing editor, and that is suitable for input
1152% to text formatters or for automatic translation to a variety of
1153% formats suitable for input to text formatters. A copy made in an
1154% otherwise Transparent file format whose markup, or absence of
1155% markup, has been arranged to thwart or discourage subsequent
1156% modification by readers is not Transparent. An image format is not
1157% Transparent if used for any substantial amount of text. A copy that
1158% is not \enquote{Transparent} is called \enquote{\textbf{Opaque}}.
1159%
1160% Examples of suitable formats for Transparent copies include plain
1161% ASCII without markup, Texinfo input format, LaTeX input format, SGML
1162% or XML using a publicly available DTD, and standard-conforming
1163% simple HTML, PostScript or PDF designed for human modification.
1164% Examples of transparent image formats include PNG, XCF and JPG.
1165% Opaque formats include proprietary formats that can be read and
1166% edited only by proprietary word processors, SGML or XML for which
1167% the DTD and/or processing tools are not generally available, and the
1168% machine-generated HTML, PostScript or PDF produced by some word
1169% processors for output purposes only.
1170%
1171% The \enquote{\textbf{Title Page}} means, for a printed book, the
1172% title page itself, plus such following pages as are needed to hold,
1173% legibly, the material this License requires to appear in the title
1174% page. For works in formats which do not have any title page as
1175% such, \enquote{Title Page} means the text near the most prominent
1176% appearance of the work's title, preceding the beginning of the body
1177% of the text.
1178%
1179% The \enquote{\textbf{publisher}} means any person or entity that
1180% distributes copies of the Document to the public.
1181%
1182% A section \enquote{\textbf{Entitled XYZ}} means a named subunit of
1183% the Document whose title either is precisely XYZ or contains XYZ in
1184% parentheses following text that translates XYZ in another language.
1185% (Here XYZ stands for a specific section name mentioned below, such
1186% as \enquote{\textbf{Acknowledgements}},
1187% \enquote{\textbf{Dedications}}, \enquote{\textbf{Endorsements}}, or
1188% \enquote{\textbf{History}}.) To \enquote{\textbf{Preserve the
1189% Title}} of such a section when you modify the Document means that it
1190% remains a section \enquote{Entitled XYZ} according to this
1191% definition.
1192%
1193% The Document may include Warranty Disclaimers next to the notice
1194% which states that this License applies to the Document. These
1195% Warranty Disclaimers are considered to be included by reference in
1196% this License, but only as regards disclaiming warranties: any other
1197% implication that these Warranty Disclaimers may have is void and has
1198% no effect on the meaning of this License.
1199%
1200% \needspace{3\baselineskip}
1201% \begin{center}
1202% {\large\bf 2. VERBATIM COPYING\par}
1203% \end{center}
1204%
1205% You may copy and distribute the Document in any medium, either
1206% commercially or noncommercially, provided that this License, the
1207% copyright notices, and the license notice saying this License
1208% applies to the Document are reproduced in all copies, and that you
1209% add no other conditions whatsoever to those of this License. You
1210% may not use technical measures to obstruct or control the reading or
1211% further copying of the copies you make or distribute. However, you
1212% may accept compensation in exchange for copies. If you distribute a
1213% large enough number of copies you must also follow the conditions in
1214% section~3.
1215%
1216% You may also lend copies, under the same conditions stated above,
1217% and you may publicly display copies.
1218%
1219% \needspace{3\baselineskip}
1220% \begin{center}
1221% {\large\bf 3. COPYING IN QUANTITY\par}
1222% \end{center}
1223%
1224% If you publish printed copies (or copies in media that commonly have
1225% printed covers) of the Document, numbering more than 100, and the
1226% Document's license notice requires Cover Texts, you must enclose the
1227% copies in covers that carry, clearly and legibly, all these Cover
1228% Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
1229% the back cover. Both covers must also clearly and legibly identify
1230% you as the publisher of these copies. The front cover must present
1231% the full title with all words of the title equally prominent and
1232% visible. You may add other material on the covers in addition.
1233% Copying with changes limited to the covers, as long as they preserve
1234% the title of the Document and satisfy these conditions, can be
1235% treated as verbatim copying in other respects.
1236%
1237% If the required texts for either cover are too voluminous to fit
1238% legibly, you should put the first ones listed (as many as fit
1239% reasonably) on the actual cover, and continue the rest onto adjacent
1240% pages.
1241%
1242% If you publish or distribute Opaque copies of the Document numbering
1243% more than 100, you must either include a machine-readable
1244% Transparent copy along with each Opaque copy, or state in or with
1245% each Opaque copy a computer-network location from which the general
1246% network-using public has access to download using public-standard
1247% network protocols a complete Transparent copy of the Document, free
1248% of added material. If you use the latter option, you must take
1249% reasonably prudent steps, when you begin distribution of Opaque
1250% copies in quantity, to ensure that this Transparent copy will remain
1251% thus accessible at the stated location until at least one year after
1252% the last time you distribute an Opaque copy (directly or through
1253% your agents or retailers) of that edition to the public.
1254%
1255% It is requested, but not required, that you contact the authors of
1256% the Document well before redistributing any large number of copies,
1257% to give them a chance to provide you with an updated version of the
1258% Document.
1259%
1260% \needspace{3\baselineskip}
1261% \begin{center}
1262% {\large\bf 4. MODIFICATIONS\par}
1263% \end{center}
1264%
1265% You may copy and distribute a Modified Version of the Document under
1266% the conditions of sections 2 and 3 above, provided that you release
1267% the Modified Version under precisely this License, with the Modified
1268% Version filling the role of the Document, thus licensing
1269% distribution and modification of the Modified Version to whoever
1270% possesses a copy of it. In addition, you must do these things in
1271% the Modified Version:
1272%
1273% \begin{itemize}
1274% \item[A.] Use in the Title Page (and on the covers, if any) a title
1275% distinct from that of the Document, and from those of previous
1276% versions (which should, if there were any, be listed in the
1277% History section of the Document). You may use the same title as a
1278% previous version if the original publisher of that version gives
1279% permission.
1280%
1281% \item[B.] List on the Title Page, as authors, one or more persons
1282% or entities responsible for authorship of the modifications in
1283% the Modified Version, together with at least five of the
1284% principal authors of the Document (all of its principal authors,
1285% if it has fewer than five), unless they release you from this
1286% requirement.
1287%
1288% \item[C.] State on the Title page the name of the publisher of the
1289% Modified Version, as the publisher.
1290%
1291% \item[D.] Preserve all the copyright notices of the Document.
1292%
1293% \item[E.] Add an appropriate copyright notice for your
1294% modifications adjacent to the other copyright notices.
1295%
1296% \item[F.] Include, immediately after the copyright notices, a
1297% license notice giving the public permission to use the Modified
1298% Version under the terms of this License, in the form shown in the
1299% Addendum below.
1300%
1301% \item[G.] Preserve in that license notice the full lists of
1302% Invariant Sections and required Cover Texts given in the
1303% Document's license notice.
1304%
1305% \item[H.] Include an unaltered copy of this License.
1306%
1307% \item[I.] Preserve the section Entitled \enquote{History},
1308% Preserve its Title, and add to it an item stating at least the
1309% title, year, new authors, and publisher of the Modified Version
1310% as given on the Title Page. If there is no section Entitled
1311% \enquote{History} in the Document, create one stating the title,
1312% year, authors, and publisher of the Document as given on its
1313% Title Page, then add an item describing the Modified Version as
1314% stated in the previous sentence.
1315%
1316% \item[J.] Preserve the network location, if any, given in the
1317% Document for public access to a Transparent copy of the Document,
1318% and likewise the network locations given in the Document for
1319% previous versions it was based on. These may be placed in the
1320% \enquote{History} section. You may omit a network location for a
1321% work that was published at least four years before the Document
1322% itself, or if the original publisher of the version it refers to
1323% gives permission.
1324%
1325% \item[K.] For any section Entitled \enquote{Acknowledgements} or
1326% \enquote{Dedications}, Preserve the Title of the section, and
1327% preserve in the section all the substance and tone of each of the
1328% contributor acknowledgements and/or dedications given therein.
1329%
1330% \item[L.] Preserve all the Invariant Sections of the Document,
1331% unaltered in their text and in their titles. Section numbers or
1332% the equivalent are not considered part of the section titles.
1333%
1334% \item[M.] Delete any section Entitled \enquote{Endorsements}.
1335% Such a section may not be included in the Modified Version.
1336%
1337% \item[N.] Do not retitle any existing section to be Entitled
1338% \enquote{Endorsements} or to conflict in title with any Invariant
1339% Section.
1340%
1341% \item[O.] Preserve any Warranty Disclaimers.
1342% \end{itemize}
1343%
1344% If the Modified Version includes new front-matter sections or
1345% appendices that qualify as Secondary Sections and contain no
1346% material copied from the Document, you may at your option designate
1347% some or all of these sections as invariant. To do this, add their
1348% titles to the list of Invariant Sections in the Modified Version's
1349% license notice. These titles must be distinct from any other
1350% section titles.
1351%
1352% You may add a section Entitled \enquote{Endorsements}, provided it
1353% contains nothing but endorsements of your Modified Version by
1354% various parties---for example, statements of peer review or that the
1355% text has been approved by an organization as the authoritative
1356% definition of a standard.
1357%
1358% You may add a passage of up to five words as a Front-Cover Text, and
1359% a passage of up to 25 words as a Back-Cover Text, to the end of the
1360% list of Cover Texts in the Modified Version. Only one passage of
1361% Front-Cover Text and one of Back-Cover Text may be added by (or
1362% through arrangements made by) any one entity. If the Document
1363% already includes a cover text for the same cover, previously added
1364% by you or by arrangement made by the same entity you are acting on
1365% behalf of, you may not add another; but you may replace the old one,
1366% on explicit permission from the previous publisher that added the
1367% old one.
1368%
1369% The author(s) and publisher(s) of the Document do not by this
1370% License give permission to use their names for publicity for or to
1371% assert or imply endorsement of any Modified Version.
1372%
1373% \needspace{3\baselineskip}
1374% \begin{center}
1375% {\large\bf 5. COMBINING DOCUMENTS\par}
1376% \end{center}
1377%
1378% You may combine the Document with other documents released under
1379% this License, under the terms defined in section~4 above for
1380% modified versions, provided that you include in the combination all
1381% of the Invariant Sections of all of the original documents,
1382% unmodified, and list them all as Invariant Sections of your combined
1383% work in its license notice, and that you preserve all their Warranty
1384% Disclaimers.
1385%
1386% The combined work need only contain one copy of this License, and
1387% multiple identical Invariant Sections may be replaced with a single
1388% copy. If there are multiple Invariant Sections with the same name
1389% but different contents, make the title of each such section unique
1390% by adding at the end of it, in parentheses, the name of the original
1391% author or publisher of that section if known, or else a unique
1392% number. Make the same adjustment to the section titles in the list
1393% of Invariant Sections in the license notice of the combined work.
1394%
1395% In the combination, you must combine any sections Entitled
1396% \enquote{History} in the various original documents, forming one
1397% section Entitled \enquote{History}; likewise combine any sections
1398% Entitled \enquote{Acknowledgements}, and any sections Entitled
1399% \enquote{Dedications}. You must delete all sections Entitled
1400% \enquote{Endorsements}.
1401%
1402% \needspace{3\baselineskip}
1403% \begin{center}
1404% {\large\bf 6. COLLECTIONS OF DOCUMENTS\par}
1405% \end{center}
1406%
1407% You may make a collection consisting of the Document and other
1408% documents released under this License, and replace the individual
1409% copies of this License in the various documents with a single copy
1410% that is included in the collection, provided that you follow the
1411% rules of this License for verbatim copying of each of the documents
1412% in all other respects.
1413%
1414% You may extract a single document from such a collection, and
1415% distribute it individually under this License, provided you insert a
1416% copy of this License into the extracted document, and follow this
1417% License in all other respects regarding verbatim copying of that
1418% document.
1419%
1420% \needspace{3\baselineskip}
1421% \begin{center}
1422% {\large\bf 7. AGGREGATION WITH INDEPENDENT WORKS\par}
1423% \end{center}
1424%
1425% A compilation of the Document or its derivatives with other separate
1426% and independent documents or works, in or on a volume of a storage
1427% or distribution medium, is called an \enquote{aggregate} if the
1428% copyright resulting from the compilation is not used to limit the
1429% legal rights of the compilation's users beyond what the individual
1430% works permit. When the Document is included in an aggregate, this
1431% License does not apply to the other works in the aggregate which are
1432% not themselves derivative works of the Document.
1433%
1434% If the Cover Text requirement of section~3 is applicable to these
1435% copies of the Document, then if the Document is less than one half
1436% of the entire aggregate, the Document's Cover Texts may be placed on
1437% covers that bracket the Document within the aggregate, or the
1438% electronic equivalent of covers if the Document is in electronic
1439% form. Otherwise they must appear on printed covers that bracket the
1440% whole aggregate.
1441%
1442% \needspace{3\baselineskip}
1443% \begin{center}
1444% {\large\bf 8. TRANSLATION\par}
1445% \end{center}
1446%
1447% Translation is considered a kind of modification, so you may
1448% distribute translations of the Document under the terms of
1449% section~4. Replacing Invariant Sections with translations requires
1450% special permission from their copyright holders, but you may include
1451% translations of some or all Invariant Sections in addition to the
1452% original versions of these Invariant Sections. You may include a
1453% translation of this License, and all the license notices in the
1454% Document, and any Warranty Disclaimers, provided that you also
1455% include the original English version of this License and the
1456% original versions of those notices and disclaimers. In case of a
1457% disagreement between the translation and the original version of
1458% this License or a notice or disclaimer, the original version will
1459% prevail.
1460%
1461% If a section in the Document is Entitled \enquote{Acknowledgements},
1462% \enquote{Dedications}, or \enquote{History}, the requirement
1463% (section~4) to Preserve its Title (section~1) will typically require
1464% changing the actual title.
1465%
1466% \needspace{3\baselineskip}
1467% \begin{center}
1468% {\large\bf 9. TERMINATION\par}
1469% \end{center}
1470%
1471% You may not copy, modify, sublicense, or distribute the Document
1472% except as expressly provided under this License. Any attempt
1473% otherwise to copy, modify, sublicense, or distribute it is void, and
1474% will automatically terminate your rights under this License.
1475%
1476% However, if you cease all violation of this License, then your
1477% license from a particular copyright holder is reinstated (a)
1478% provisionally, unless and until the copyright holder explicitly and
1479% finally terminates your license, and (b) permanently, if the
1480% copyright holder fails to notify you of the violation by some
1481% reasonable means prior to 60 days after the cessation.
1482%
1483% Moreover, your license from a particular copyright holder is
1484% reinstated permanently if the copyright holder notifies you of the
1485% violation by some reasonable means, this is the first time you have
1486% received notice of violation of this License (for any work) from
1487% that copyright holder, and you cure the violation prior to 30 days
1488% after your receipt of the notice.
1489%
1490% Termination of your rights under this section does not terminate the
1491% licenses of parties who have received copies or rights from you
1492% under this License. If your rights have been terminated and not
1493% permanently reinstated, receipt of a copy of some or all of the same
1494% material does not give you any rights to use it.
1495%
1496% \needspace{3\baselineskip}
1497% \begin{center}
1498% {\large\bf 10. FUTURE REVISIONS OF THIS LICENSE\par}
1499% \end{center}
1500%
1501% The Free Software Foundation may publish new, revised versions of
1502% the GNU Free Documentation License from time to time. Such new
1503% versions will be similar in spirit to the present version, but may
1504% differ in detail to address new problems or concerns. See
1505% \url{https://www.gnu.org/licenses/}.
1506%
1507% Each version of the License is given a distinguishing version
1508% number. If the Document specifies that a particular numbered
1509% version of this License \enquote{or any later version} applies to
1510% it, you have the option of following the terms and conditions either
1511% of that specified version or of any later version that has been
1512% published (not as a draft) by the Free Software Foundation. If the
1513% Document does not specify a version number of this License, you may
1514% choose any version ever published (not as a draft) by the Free
1515% Software Foundation. If the Document specifies that a proxy can
1516% decide which future versions of this License can be used, that
1517% proxy's public statement of acceptance of a version permanently
1518% authorizes you to choose that version for the Document.
1519%
1520% \needspace{3\baselineskip}
1521% \begin{center}
1522% {\large\bf 11. RELICENSING\par}
1523% \end{center}
1524%
1525% \enquote{Massive Multiauthor Collaboration Site} (or \enquote{MMC
1526% Site}) means any World Wide Web server that publishes copyrightable
1527% works and also provides prominent facilities for anybody to edit
1528% those works. A public wiki that anybody can edit is an example of
1529% such a server. A \enquote{Massive Multiauthor Collaboration} (or
1530% \enquote{MMC}) contained in the site means any set of copyrightable
1531% works thus published on the MMC site.
1532%
1533% \enquote{CC-BY-SA} means the Creative Commons Attribution-Share
1534% Alike 3.0 license published by Creative Commons Corporation, a
1535% not-for-profit corporation with a principal place of business in San
1536% Francisco, California, as well as future copyleft versions of that
1537% license published by that same organization.
1538%
1539% \enquote{Incorporate} means to publish or republish a Document, in
1540% whole or in part, as part of another Document.
1541%
1542% An MMC is \enquote{eligible for relicensing} if it is licensed under
1543% this License, and if all works that were first published under this
1544% License somewhere other than this MMC, and subsequently incorporated
1545% in whole or in part into the MMC, (1) had no cover texts or
1546% invariant sections, and (2) were thus incorporated prior to November
1547% 1, 2008.
1548%
1549% The operator of an MMC Site may republish an MMC contained in the
1550% site under CC-BY-SA on the same site at any time before August 1,
1551% 2009, provided the MMC is eligible for relicensing.
1552%
1553% \needspace{3\baselineskip}
1554% \begin{center}
1555% {\large\bf ADDENDUM: How to use this License for your documents\par}
1556% \end{center}
1557%
1558% To use this License in a document you have written, include a copy
1559% of the License in the document and put the following copyright and
1560% license notices just after the title page:
1561%
1562% \bigskip
1563% \begin{quote}
1564% Copyright \copyright{} YEAR YOUR NAME. Permission is granted to
1565% copy, distribute and/or modify this document under the terms of
1566% the GNU Free Documentation License, Version 1.3 or any later
1567% version published by the Free Software Foundation; with no
1568% Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
1569% A copy of the license is included in the section entitled
1570% \enquote{GNU Free Documentation License}.
1571% \end{quote}
1572% \bigskip
1573%
1574% If you have Invariant Sections, Front-Cover Texts and Back-Cover
1575% Texts, replace the \enquote{with \dots\ Texts.}\ line with this:
1576%
1577% \bigskip
1578% \begin{quote}
1579% with the Invariant Sections being LIST THEIR TITLES, with the
1580% Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
1581% \end{quote}
1582% \bigskip
1583%
1584% If you have Invariant Sections without Cover Texts, or some other
1585% combination of the three, merge those two alternatives to suit the
1586% situation.
1587%
1588% If your document contains nontrivial examples of program code, we
1589% recommend releasing these examples in parallel under your choice of
1590% free software license, such as the GNU General Public License,
1591% to permit their use in free software.
1592%
1593%
994%\StopEventually{} 1594%\StopEventually{}
995% 1595%
996% \section{Implementation} 1596% \section{Implementation}
@@ -1020,7 +1620,7 @@
1020\ExecuteOptionsX{citecmd} 1620\ExecuteOptionsX{citecmd}
1021\ProcessOptionsX\relax 1621\ProcessOptionsX\relax
1022% \end{macrocode} 1622% \end{macrocode}
1023% The following packages are required by \package{icite}: 1623% The following packages are required by \pkg{icite}:
1024% \begin{macrocode} 1624% \begin{macrocode}
1025\RequirePackage{xparse} 1625\RequirePackage{xparse}
1026\RequirePackage{datatool} 1626\RequirePackage{datatool}
@@ -1031,7 +1631,7 @@
1031% \begin{macrocode} 1631% \begin{macrocode}
1032\NewDocumentCommand{\ic@nullcmd}{O{}O{}m}{} 1632\NewDocumentCommand{\ic@nullcmd}{O{}O{}m}{}
1033% \end{macrocode} 1633% \end{macrocode}
1034% Define fields to be used by \package{icite}: 1634% Define fields to be used by \pkg{icite}:
1035% \begin{macrocode} 1635% \begin{macrocode}
1036\define@reuse@key{author} 1636\define@reuse@key{author}
1037\define@reuse@key{indexauthor} 1637\define@reuse@key{indexauthor}
@@ -1043,13 +1643,13 @@
1043\define@reuse@key{entrysubtype} 1643\define@reuse@key{entrysubtype}
1044\define@reuse@key{shorthand} 1644\define@reuse@key{shorthand}
1045% \end{macrocode} 1645% \end{macrocode}
1046% This is the same as \cs{usebibentry} from \package{ebib}, but it 1646% This is the same as \cs{usebibentry} from \pkg{ebib}, but it
1047% does not return an error if the entry field is not found: 1647% does not return an error if the entry field is not found:
1048% \begin{macrocode} 1648% \begin{macrocode}
1049\def\get@bibentry#1#2{\@ifundefined{reuse@#1@#2}{} 1649\def\get@bibentry#1#2{\@ifundefined{reuse@#1@#2}{}
1050 {\@nameuse{reuse@#1@#2}}} 1650 {\@nameuse{reuse@#1@#2}}}
1051% \end{macrocode} 1651% \end{macrocode}
1052% Create a new database which \package{icite} will use to connect 1652% Create a new database which \pkg{icite} will use to connect
1053% Bib\LaTeX\ \enquote*{subtypes} to indices. 1653% Bib\LaTeX\ \enquote*{subtypes} to indices.
1054% \begin{macrocode} 1654% \begin{macrocode}
1055\DTLnewdb{icite@indices} 1655\DTLnewdb{icite@indices}
@@ -1111,7 +1711,40 @@
1111% citation command to be used, like so:\\ 1711% citation command to be used, like so:\\
1112% \cs{icite}\oarg{pre}\oarg{post}\marg{key}\oarg{command}\\ 1712% \cs{icite}\oarg{pre}\oarg{post}\marg{key}\oarg{command}\\
1113% Only standard citation commands are accepted, with the exception of 1713% Only standard citation commands are accepted, with the exception of
1114% qualified citation lists or so-called \enquote*{multicite} commands. 1714% qualified citation lists or so-called \enquote*{multicite}
1715% commands. As of v1.4, \pkg{icite} can process separate index entries
1716% from lists of numbers inserted in the \meta{postnote} argument of
1717% \cs{icite}. For this mechanism to work, the indexing commands used
1718% by \cs{icite} must be defined beforehand:---
1719% \begin{macrocode}
1720\NewDocumentCommand{\icite@dflt@index}{m}{%
1721 \index[\ic@dfltind]{\@sortedauthor!\@sortedtitle!#1}}
1722\NewDocumentCommand{\icite@std@index}{m}{%
1723 \index[\icite@index]{\@sortedauthor!\@sortedtitle!#1}}
1724\NewDocumentCommand{\icite@nodflt@index}{m}{%
1725 \index{\@sortedauthor!\@sortedtitle!#1}}
1726% \end{macrocode}
1727% Then \cs{process@index@list} is used to split the argument of
1728% |<postnote>| at each occurrence of the |;| punctuation mark:---
1729% \begin{macrocode}
1730\NewDocumentCommand{\process@index@list}
1731 {m > { \SplitList { ; } } m}{%
1732 \def\@tempa{#1}%
1733 \def\@dflt{dflt}%
1734 \def\@std{std}%
1735 \def\@nodflt{nodflt}%
1736 \ifx\@tempa\@dflt
1737 \ProcessList {#2} { \icite@dflt@index }%
1738 \else
1739 \ifx\@tempa\@std
1740 \ProcessList {#2} { \icite@std@index }%
1741 \else
1742 \ifx\@tempa\@nodflt
1743 \ProcessList {#2} { \icite@nodflt@index }%
1744 \fi\fi\fi
1745}
1746% \end{macrocode}
1747% The definition of \cs{icite} follows:---
1115% \begin{macrocode} 1748% \begin{macrocode}
1116\NewDocumentCommand{\icite}{o o m O{\ic@dfltcit}}{% 1749\NewDocumentCommand{\icite}{o o m O{\ic@dfltcit}}{%
1117 \edef\ic@argiv{#4}% 1750 \edef\ic@argiv{#4}%
@@ -1188,23 +1821,28 @@
1188 {\DTLifdbempty{icite@indices}{% 1821 {\DTLifdbempty{icite@indices}{%
1189 \ifno@index\else 1822 \ifno@index\else
1190 \ifdefault@index% 1823 \ifdefault@index%
1191 \index[\ic@dfltind]{\@sortedauthor!\@sortedtitle!#1}% 1824 \process@index@list{dflt}{#1}%
1825 %\index[\ic@dfltind]{\@sortedauthor!\@sortedtitle!#1}%
1192 \else% 1826 \else%
1193 \index{\@sortedauthor!\@sortedtitle!#1}% 1827 \process@index@list{nodflt}{#1}%
1828 %\index{\@sortedauthor!\@sortedtitle!#1}%
1194 \fi\fi% 1829 \fi\fi%
1195 }{% 1830 }{%
1196 \bgroup% 1831 \bgroup%
1197 \DTLforeach*{icite@indices}{% 1832 \DTLforeach*{icite@indices}{%
1198 \icite@subtype=subtype,\icite@index=index}{% 1833 \icite@subtype=subtype,\icite@index=index}{%
1199 \ifx\@subtype\icite@subtype% 1834 \ifx\@subtype\icite@subtype%
1200 \index[\icite@index]{\@sortedauthor!\@sortedtitle!#1}% 1835 \process@index@list{std}{#1}%
1836 %\index[\icite@index]{\@sortedauthor!\@sortedtitle!#1}%
1201 \dtlbreak% 1837 \dtlbreak%
1202 \else% 1838 \else%
1203 \ifno@index\else 1839 \ifno@index\else
1204 \ifdefault@index% 1840 \ifdefault@index%
1205 \index[\ic@dfltind]{\@sortedauthor!\@sortedtitle!#1}% 1841 \process@index@list{dflt}{#1}%
1842 %\index[\ic@dfltind]{\@sortedauthor!\@sortedtitle!#1}%
1206 \else% 1843 \else%
1207 \index{\@sortedauthor!\@sortedtitle!#1}% 1844 \process@index@list{nodflt}{#1}%
1845 %\index{\@sortedauthor!\@sortedtitle!#1}%
1208 \fi\fi% 1846 \fi\fi%
1209 \fi}% 1847 \fi}%
1210 \egroup}% 1848 \egroup}%
@@ -1222,23 +1860,28 @@
1222 {\DTLifdbempty{icite@indices}{% 1860 {\DTLifdbempty{icite@indices}{%
1223 \ifno@index\else 1861 \ifno@index\else
1224 \ifdefault@index% 1862 \ifdefault@index%
1225 \index[\ic@dfltind]{\@sortedauthor!\@sortedtitle!#2}% 1863 \process@index@list{dflt}{#2}%
1864 %\index[\ic@dfltind]{\@sortedauthor!\@sortedtitle!#2}%
1226 \else% 1865 \else%
1227 \index{\@sortedauthor!\@sortedtitle!#2}% 1866 \process@index@list{nodflt}{#2}%
1867 %\index{\@sortedauthor!\@sortedtitle!#2}%
1228 \fi\fi% 1868 \fi\fi%
1229 }{% 1869 }{%
1230 \bgroup% 1870 \bgroup%
1231 \DTLforeach*{icite@indices}{% 1871 \DTLforeach*{icite@indices}{%
1232 \icite@subtype=subtype,\icite@index=index}{% 1872 \icite@subtype=subtype,\icite@index=index}{%
1233 \ifx\@subtype\icite@subtype% 1873 \ifx\@subtype\icite@subtype%
1234 \index[\icite@index]{\@sortedauthor!\@sortedtitle!#2}% 1874 \process@index@list{std}{#2}%
1875 %\index[\icite@index]{\@sortedauthor!\@sortedtitle!#2}%
1235 \dtlbreak% 1876 \dtlbreak%
1236 \else% 1877 \else%
1237 \ifno@index\else 1878 \ifno@index\else
1238 \ifdefault@index% 1879 \ifdefault@index%
1239 \index[\ic@dfltind]{\@sortedauthor!\@sortedtitle!#2}% 1880 \process@index@list{dflt}{#2}%
1881 %\index[\ic@dfltind]{\@sortedauthor!\@sortedtitle!#2}%
1240 \else% 1882 \else%
1241 \index{\@sortedauthor!\@sortedtitle!#2}% 1883 \process@index@list{nodflt}{#2}%
1884 %\index{\@sortedauthor!\@sortedtitle!#2}%
1242 \fi\fi% 1885 \fi\fi%
1243 \fi}% 1886 \fi}%
1244 \egroup}% 1887 \egroup}%