summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/icite
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-03-13 20:57:59 +0000
committerKarl Berry <karl@freefriends.org>2019-03-13 20:57:59 +0000
commitecedbcffe103deeb26a47ffac3990c8eb8a926d7 (patch)
treef8bc69730d0991dbbf4b5c9cbb73d74cd32a59a2 /Master/texmf-dist/doc/latex/icite
parentc949589f88bf58fd53126ff26270f64ac12bb9be (diff)
icite (13mar19)
git-svn-id: svn://tug.org/texlive/trunk@50375 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/icite')
-rw-r--r--Master/texmf-dist/doc/latex/icite/README.md112
-rw-r--r--Master/texmf-dist/doc/latex/icite/icite.pdfbin214799 -> 213292 bytes
-rw-r--r--Master/texmf-dist/doc/latex/icite/samples/bibsample.bib46
-rw-r--r--Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.pdfbin0 -> 59993 bytes
-rw-r--r--Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.tex88
-rw-r--r--Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.pdfbin0 -> 56710 bytes
-rw-r--r--Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.tex85
7 files changed, 219 insertions, 112 deletions
diff --git a/Master/texmf-dist/doc/latex/icite/README.md b/Master/texmf-dist/doc/latex/icite/README.md
deleted file mode 100644
index 667ebcadfcd..00000000000
--- a/Master/texmf-dist/doc/latex/icite/README.md
+++ /dev/null
@@ -1,112 +0,0 @@
----
-author:
-- Robert Alessi
-title: 'The icite package – README file'
----
-
-Overview
-========
-
-`icite` is designed to produce from BibTeX or BibLaTeX bibliographical
-databases the different indices of authors and works cited which are
-called \emph{indices locorum citatorum}. It relies on a specific
-`\icite` command and can operate with either BibTeX or BibLaTeX.
-
-License and disclamer
-=====================
-
-icite – Indices locorum citatorum
-
-Copyright ⓒ 2019 Robert Alessi
-
-Please send error reports and suggestions for improvements to Robert
-Alessi:
-
-- email: <alessi@robertalessi.net>
-
-- website: <http://www.robertalessi.net/icite>
-
-- comments, feature requests, bug reports:
- <https://gitlab.com/ralessi/icite/issues>
-
-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.
-
-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.
-
-You should have received a copy of the GNU General Public License along
-with this program. If not, see &lt;http://www.gnu.org/licenses/&gt;.
-
-This release of icite consists of the following source files:
-
-- `icite.dtx`
-
-- `icite.ins`
-
-- `Makefile`
-
-License applicable to the documentation
----------------------------------------
-
-Copyright ⓒ 2019 Robert Alessi
-
-The documentation file `icite.pdf` that is generated from the
-`icite.dtx` source file is licensed under the Creative Commons
-Attribution-ShareAlike 4.0 International License. To view a copy of this
-license, visit <http://creativecommons.org/licenses/by-sa/4.0/> or send
-a letter to Creative Commons, PO Box 1866, Mountain View, CA 94042, USA.
-
-Installation
-============
-
-1. Run `'latex icite.ins'` to produce the `icite.sty`
- file;
-
-2. To finish the installation you have to move the `icite.sty` file into
- a directory where LaTeX can find them. See the FAQ on `texfaq.org`
- at <https://texfaq.org/FAQ-inst-wlcf> for more on this.
-
-Development, Git Repository
-===========================
-
-Browse the code
----------------
-
-You can browse icite repository on the web:
-<http://git.robertalessi.net/icite>
-
-From this page, you can download all the releases of `icite`. For
-instructions on how to install `icite`, please see above.
-
-Comments, Feature requests, Bug Reports
----------------------------------------
-
-<https://gitlab.com/ralessi/icite/issues>
-
-Download the repository
------------------------
-
-`icite` 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).
-
-Use this command to download the repository
-
- git clone http://git.robertalessi.net/icite
-
-A new directory named icite will have been created, containing
-`icite`.
-
-Git hosting
------------
-
-Make an account on <https://gitlab.com> and navigate (while logged in)
-to <https://gitlab.com/ralessi/icite>. Click *Fork* and you will
-have in your account your own repository of `icite` where you will
-be able to make whatever changes you like to.
-
diff --git a/Master/texmf-dist/doc/latex/icite/icite.pdf b/Master/texmf-dist/doc/latex/icite/icite.pdf
index 0f729e1c7b1..02d254f85fb 100644
--- a/Master/texmf-dist/doc/latex/icite/icite.pdf
+++ b/Master/texmf-dist/doc/latex/icite/icite.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/icite/samples/bibsample.bib b/Master/texmf-dist/doc/latex/icite/samples/bibsample.bib
new file mode 100644
index 00000000000..5a1efb102f5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/icite/samples/bibsample.bib
@@ -0,0 +1,46 @@
+@Book{Aristotle:Politica,
+ title = {Politica},
+ date = 1964,
+ author = {Aristotle},
+ editor = {Ross, W. D.},
+ origdate = 1957,
+ entrysubtype = {ancient},
+ publisher = {Clarendon Press},
+ location = {Oxford}}
+
+@BookInBook{Plato:Laches,
+ title = {Laches},
+ date = 1968,
+ author = {Plato},
+ booktitle = {Platonis opera},
+ editor = {Burnet, J.},
+ origdate = 1903,
+ entrysubtype = {ancient},
+ volume = 3,
+ publisher = {Clarendon Press},
+ location = {Oxford}}
+
+@BookInBook{Plato:Theaetetus,
+ title = {Theaetetus},
+ date = 1967,
+ author = {Plato},
+ booktitle = {Platonis opera},
+ editor = {Burnet, J.},
+ origdate = 1900,
+ entrysubtype = {ancient},
+ volume = 1,
+ publisher = {Clarendon Press},
+ location = {Oxford}}
+
+@Book{Reynolds.Wilson1994,
+ author = {Reynolds, L. D. and Wilson, N. G.},
+ indexauthor = {L. D. Reynolds and N. G. Wilson},
+ title = {Scribes and Scholars},
+ date = 1994,
+ subtitle = {A Guide to the Transmission of Greek and Latin
+ Literature},
+ edition = 3,
+ publisher = {Clarendon Press},
+ location = {Oxford}
+}
+
diff --git a/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.pdf b/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.pdf
new file mode 100644
index 00000000000..3e6300f2959
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.tex b/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.tex
new file mode 100644
index 00000000000..e52cb8b9d6a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.tex
@@ -0,0 +1,88 @@
+% Compile with --shell-escape
+\documentclass{article}
+\usepackage[english]{babel}
+
+\usepackage{hyperref}
+\hypersetup{colorlinks, hidelinks, pdfauthor={Robert
+ Alessi}, pdftitle={icite and BibLaTeX}}
+
+\usepackage{fancyvrb}
+\fvset{numbers=left,obeytabs,frame=lines}
+
+\usepackage{ccicons}
+\usepackage{enumitem}
+\setlist{nosep}
+\setlist[itemize]{label=\textendash}
+\setlist[enumerate,1]{label=(\alph*)}
+\setlist[enumerate,2]{label=\roman*.}
+
+\usepackage[citecmd=autocite, defaultindex=none]{icite}
+\IndexSubtypeAs{ancient}{pr-sources}
+\bibinput{bibsample}
+
+\usepackage[xindy]{imakeidx}
+\makeindex[name=pr-sources, title={Index locorum citatorum}]
+
+\usepackage[style=oxnotes]{biblatex}
+\addbibresource{bibsample.bib}
+
+\begin{document}
+\DefineShortVerb{\|}
+\vspace*{-.5in}
+\noindent
+\textbf{\textsf{icite sample file}} --- \cczero\ This
+file is public domain
+
+\section*{Preamble}
+This file demonstrates how \textsf{icite} can be used to produce an
+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}
+\bibinput{bibsample}
+
+\usepackage[xindy]{imakeidx}
+\makeindex[name=pr-sources, title={Index locorum citatorum}]
+
+\usepackage[style=oxnotes]{biblatex}
+\addbibresource{bibsample.bib}
+\end{Verbatim}
+
+\paragraph{Remarks}
+\begin{enumerate}
+\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.
+\end{enumerate}
+
+\section*{Body text}
+Plato, \emph{Laches}: first
+citation\icite[179a1--4]{Plato:Laches}. And
+another\icite[179c5--180a1]{Plato:Laches}, and
+another\icite[181b5--181c3]{Plato:Laches}.
+
+Plato, \emph{Theaetetus}: first
+citation\icite[142c2--142d3]{Plato:Theaetetus}. And
+another\icite[142d4--5]{Plato:Theaetetus}, and
+another\icite[143b5]{Plato:Theaetetus}.
+
+Aristotle, \emph{Politica}: first
+citation\icite[1252a25--1252.b27]{Aristotle:Politica}. And
+another\icite[1253a5]{Aristotle:Politica}, and
+another\icite[1253a30--39]{Aristotle:Politica}.
+
+This passage should not be indexed\icite[44--78]{Reynolds.Wilson1994}.
+
+\printindex[pr-sources]
+
+\section*{Bibliographical database}
+\VerbatimInput{bibsample.bib}
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.pdf b/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.pdf
new file mode 100644
index 00000000000..8b0bdb72e5e
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.tex b/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.tex
new file mode 100644
index 00000000000..6893247f108
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.tex
@@ -0,0 +1,85 @@
+% Compile with --shell-escape
+\documentclass{article}
+\usepackage[english]{babel}
+
+\usepackage{hyperref}
+\hypersetup{colorlinks, hidelinks, pdfauthor={Robert
+ Alessi}, pdftitle={icite and BibLaTeX}}
+
+\usepackage{fancyvrb}
+\fvset{numbers=left,obeytabs,frame=lines}
+
+\usepackage{ccicons}
+\usepackage{hologo}
+\usepackage{enumitem}
+\setlist{nosep}
+\setlist[itemize]{label=\textendash}
+\setlist[enumerate,1]{label=(\alph*)}
+\setlist[enumerate,2]{label=\roman*.}
+
+\usepackage[defaultindex=none, nobibengine]{icite}
+\IndexSubtypeAs{ancient}{pr-sources}
+\bibinput{bibsample}
+
+\usepackage[xindy]{imakeidx}
+\makeindex[name=pr-sources, title={Index locorum citatorum}]
+
+\begin{document}
+\DefineShortVerb{\|}
+\vspace*{-.5in}
+\noindent
+\textbf{\textsf{icite sample file}} --- \cczero\ This
+file is public domain
+
+\section*{Preamble}
+This file demonstrates how \textsf{icite} can be used to produce an
+index of passages cited without using either \hologo{BibTeX} or
+Bib\LaTeX.
+
+The relevant part of the preamble which is used here follows:
+\begin{Verbatim}
+\usepackage[defaultindex=none, nobibengine]{icite}
+\IndexSubtypeAs{ancient}{pr-sources}
+\bibinput{bibsample}
+
+\usepackage[xindy]{imakeidx}
+\makeindex[name=pr-sources, title={Index locorum citatorum}]
+\end{Verbatim}
+
+\paragraph{Remarks}
+\begin{enumerate}
+\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.
+\end{enumerate}
+
+\section*{Body text}
+Plato, \emph{Laches}: first
+citation.\footnote{\icite[179a1--4]{Plato:Laches}.} And
+another,\footnote{\icite[179c5--180a1]{Plato:Laches}.}
+and another.\footnote{\icite[181b5--c3]{Plato:Laches}.}
+
+Plato, \emph{Theaetetus}: first
+citation.\footnote{\icite[142c2--d3]{Plato:Theaetetus}.}
+And another,\footnote{\icite[142d4--5]{Plato:Theaetetus}.}
+and another.\footnote{\icite[143b5]{Plato:Theaetetus}.}
+
+Aristotle, \emph{Politica}: first citation.\footnote{%
+ \icite[1252a25--b27]{Aristotle:Politica}.} And
+another,\footnote{\icite[1253a5]{Aristotle:Politica}.} and
+another.\footnote{\icite[1253a30--39]{Aristotle:Politica}.}
+
+This passage should not be
+indexed.\footnote{\icite[44--78]{Reynolds.Wilson1994}.}
+
+\printindex[pr-sources]
+
+\section*{Bibliographical database}
+\VerbatimInput{bibsample.bib}
+\end{document}