done documenting and added a section on icite and classics. new functions \AuthorTitleDelim and \TitlePageDelim

3 files changed, 96 insertions, 22 deletions

diff --git a/samples/icite-biblatex.tex b/samples/icite-biblatex.tex
index 678f9f4..b49bc34 100644
--- a/samples/icite-biblatex.tex
+++ b/samples/icite-biblatex.tex
@@ -22,7 +22,7 @@
 \setlist[enumerate,2]{label=\roman*.}
 
 \usepackage[citecmd=autocite, defaultindex=none]{icite}
-\IndexSubtypeAs{ancient}{pr-sources}
+\IndexSubtypeAs{ancient}{\jobname-primary}
 \bibinput{bibsample}
 
 \usepackage{classics}
@@ -30,7 +30,7 @@
 \newclassic{arist}{#1|\textit{#1}|#1}
 
 \usepackage[xindy,nonewpage]{imakeidx}
-\makeindex[name=pr-sources, title={Index locorum citatorum}]
+\makeindex[name=\jobname-primary, title={Index locorum citatorum}]
 
 \usepackage[style=oxnotes]{biblatex}
 \addbibresource{bibsample.bib}
@@ -49,7 +49,7 @@ index of passages cited in combination with Bib\LaTeX.
 The relevant part of the preamble which is used here follows:
 \begin{Verbatim}
 \usepackage[citecmd=autocite, defaultindex=none]{icite}
-\IndexSubtypeAs{ancient}{pr-sources}
+\IndexSubtypeAs{ancient}{icite-biblatex-primary}
 \bibinput{bibsample}
 
 \usepackage{classics}
@@ -57,7 +57,7 @@ The relevant part of the preamble which is used here follows:
 \newclassic{arist}{#1|\textit{#1}|#1}
 
 \usepackage[xindy]{imakeidx}
-\makeindex[name=pr-sources, title={Index locorum citatorum}]
+\makeindex[name=icite-biblatex-primary, title={Index locorum citatorum}]
 
 \usepackage[style=oxnotes]{biblatex}
 \addbibresource{bibsample.bib}
@@ -68,12 +68,13 @@ The relevant part of the preamble which is used here follows:
 \item |citecmd=autocite| instructs \textsf{icite} to use the
   |\autocite| command to insert the citations in the body text.
 \item |defaultindex=none| disables indexing by default.
-\item |\IndexSubtypeAs{ancient}{pr-sources}| makes an exception for
-  authors whose |entrysubtype| field matches the string |ancient| and
-  instructs \textsf{icite} to have them indexed in an index named
-  |pr-sources|.
-\item To actually produce the index, |\printindex[pr-sources]| is needed
-  at the end of the document.
+\item |\IndexSubtypeAs{ancient}{icite-biblatex-primary}| makes an
+  exception for authors whose |entrysubtype| field matches the string
+  |ancient| and instructs \textsf{icite} to have them indexed in an
+  index named\\ |icite-biblatex-primary|.
+\item To actually produce the index,
+  |\printindex[icite-biblatex-primary]| is needed at the end of the
+  document.
 \end{enumerate}
 
 \section*{Body text}
@@ -94,7 +95,7 @@ another\icite[\arist{1253}[a][30--39]]{Aristotle:Politica}.
 
 This passage should not be indexed\icite[44--78]{Reynolds.Wilson1994}.
 
-\printindex[pr-sources]
+\printindex[\jobname-primary]
 
 \section*{Bibliographical database}
 \VerbatimInput{bibsample.bib}
diff --git a/samples/icite-minimal.tex b/samples/icite-minimal.tex
new file mode 100644
index 0000000..32bb4a2
--- /dev/null
+++ b/samples/icite-minimal.tex
@@ -0,0 +1,72 @@
+\documentclass{article}
+\usepackage[english]{babel}
+
+\usepackage[small]{titlesec}
+
+\usepackage{latexcolors}
+\usepackage[outputdir=TMP/]{minted}
+\setminted{bgcolor=lavendermist}
+
+\usepackage{ccicons}
+\usepackage{enumitem}
+\setlist{nosep}
+\setlist[itemize]{label=\textendash}
+\setlist[enumerate,1]{label=(\alph*)}
+\setlist[enumerate,2]{label=\roman*.}
+
+\usepackage{xurl}
+\usepackage[colorlinks]{hyperref}
+
+\begin{document}
+\vspace*{-.5in}
+\noindent
+\textbf{\textsf{icite sample file}} --- \cczero\ This
+file is public domain
+
+\section*{Instructions}
+\begin{enumerate}
+\item Start a new document, copy and paste the code that follows.
+\item The default citation command used by \textsf{icite} has been set
+  to \verb|autocite|. Adapt.
+\item The \textsf{biblatex} style file selected is
+  \verb|oxnotes|. Adapt.
+\item Insert the citations in the body text with
+  \mint{latex}|\icite[<pre>][<post>]{<key>}|
+\item Compile the document with \verb|--shell-escape|.\footnote{More
+    information on how to do this: \url{https://texfaq.org/FAQ-spawnprog}}
+\end{enumerate}
+
+\begin{minted}{latex}
+\RequirePackage{filecontents}
+\begin{filecontents*}{\jobname.xdy}
+(merge-rule "\*" "" :eregexp)
+\end{filecontents*}
+%
+\documentclass{article}
+\usepackage[english]{babel}
+
+% load icite
+\usepackage[citecmd=autocite, defaultindex=loccit]{icite}
+\bibinput{bibliography}
+
+% prepare the index
+\usepackage[xindy]{imakeidx}
+\makeindex[%
+  name=loccit,
+  title={Index locorum citatorum},
+  options=-M \jobname.xdy]
+
+% load biblatex
+\usepackage[style=oxnotes]{biblatex}
+\addbibresource{bibliography.bib}
+
+\begin{document}
+
+Your document goes here.
+
+\printindex[loccit]
+\printbibliography
+\end{document}
+\end{minted}
+
+\end{document}
diff --git a/samples/icite-nobiblatex.tex b/samples/icite-nobiblatex.tex
index baf2973..d6f824d 100644
--- a/samples/icite-nobiblatex.tex
+++ b/samples/icite-nobiblatex.tex
@@ -23,7 +23,7 @@
 \setlist[enumerate,2]{label=\roman*.}
 
 \usepackage[defaultindex=none, nobibengine]{icite}
-\IndexSubtypeAs{ancient}{pr-sources}
+\IndexSubtypeAs{ancient}{\jobname-primary}
 \bibinput{bibsample}
 
 \usepackage{classics}
@@ -31,7 +31,7 @@
 \newclassic{arist}{#1|\textit{#1}|#1}
 
 \usepackage[xindy,nonewpage]{imakeidx}
-\makeindex[name=pr-sources, title={Index locorum citatorum}]
+\makeindex[name=\jobname-primary, title={Index locorum citatorum}]
 
 \begin{document}
 \DefineShortVerb{\|}
@@ -48,7 +48,7 @@ Bib\LaTeX.
 The relevant part of the preamble which is used here follows:
 \begin{Verbatim}
 \usepackage[defaultindex=none, nobibengine]{icite}
-\IndexSubtypeAs{ancient}{pr-sources}
+\IndexSubtypeAs{ancient}{icite-nobiblatex-primary}
 \bibinput{bibsample}
 
 \usepackage{classics}
@@ -56,7 +56,7 @@ The relevant part of the preamble which is used here follows:
 \newclassic{arist}{#1|\textit{#1}|#1}
 
 \usepackage[xindy]{imakeidx}
-\makeindex[name=pr-sources, title={Index locorum citatorum}]
+\makeindex[name=icite-nobiblatex-primary, title={Index locorum citatorum}]
 \end{Verbatim}
 
 \paragraph{Remarks}
@@ -64,12 +64,13 @@ The relevant part of the preamble which is used here follows:
 \item |defaultindex=none| disables indexing by default.
 \item |nobibengine| instructs \textsf{icite} to insert the citations
   in the body text without using either \hologo{BibTeX} or Bib\LaTeX.
-\item |\IndexSubtypeAs{ancient}{pr-sources}| makes an exception for
-  authors whose |entrysubtype| field matches the string |ancient| and
-  instructs \textsf{icite} to have them indexed in an index named
-  |pr-sources|.
-\item To actually produce the index, |\printindex[pr-sources]| is
-  needed at the end of the document.
+\item |\IndexSubtypeAs{ancient}{icite-nobiblatex-primary}| makes an
+  exception for authors whose |entrysubtype| field matches the string
+  |ancient| and instructs \textsf{icite} to have them indexed in an
+  index named\\ |icite-nobiblatex-primary|.
+\item To actually produce the index,
+  |\printindex[icite-nobiblatex-primary]| is needed at the end of the
+  document.
 \end{enumerate}
 
 \section*{Body text}
@@ -92,7 +93,7 @@ and another.\footnote{%
 This passage should not be
 indexed.\footnote{\icite[44--78]{Reynolds.Wilson1994}.}
 
-\printindex[pr-sources]
+\printindex[\jobname-primary]
 
 \section*{Bibliographical database}
 \VerbatimInput{bibsample.bib}