From ecedbcffe103deeb26a47ffac3990c8eb8a926d7 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 13 Mar 2019 20:57:59 +0000 Subject: icite (13mar19) git-svn-id: svn://tug.org/texlive/trunk@50375 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/icite/README.md | 112 --------------------- Master/texmf-dist/doc/latex/icite/icite.pdf | Bin 214799 -> 213292 bytes .../doc/latex/icite/samples/bibsample.bib | 46 +++++++++ .../doc/latex/icite/samples/icite-biblatex.pdf | Bin 0 -> 59993 bytes .../doc/latex/icite/samples/icite-biblatex.tex | 88 ++++++++++++++++ .../doc/latex/icite/samples/icite-nobiblatex.pdf | Bin 0 -> 56710 bytes .../doc/latex/icite/samples/icite-nobiblatex.tex | 85 ++++++++++++++++ 7 files changed, 219 insertions(+), 112 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/icite/README.md create mode 100644 Master/texmf-dist/doc/latex/icite/samples/bibsample.bib create mode 100644 Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.pdf create mode 100644 Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.tex create mode 100644 Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.pdf create mode 100644 Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.tex (limited to 'Master/texmf-dist/doc/latex/icite') 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: - -- website: - -- comments, feature requests, bug reports: - - -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 <http://www.gnu.org/licenses/>. - -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 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 for more on this. - -Development, Git Repository -=========================== - -Browse the code ---------------- - -You can browse icite repository on the web: - - -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 ---------------------------------------- - - - -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 and navigate (while logged in) -to . 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 Binary files a/Master/texmf-dist/doc/latex/icite/icite.pdf and b/Master/texmf-dist/doc/latex/icite/icite.pdf 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.pdf 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.pdf 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} -- cgit v1.2.3