texlive[50375] Master/texmf-dist: icite (13mar19)
commits+karl at tug.org
commits+karl at tug.org
Wed Mar 13 21:57:59 CET 2019
Revision: 50375
http://tug.org/svn/texlive?view=revision&revision=50375
Author: karl
Date: 2019-03-13 21:57:59 +0100 (Wed, 13 Mar 2019)
Log Message:
-----------
icite (13mar19)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/icite/icite.pdf
trunk/Master/texmf-dist/source/latex/icite/Makefile
trunk/Master/texmf-dist/source/latex/icite/icite.dtx
trunk/Master/texmf-dist/tex/latex/icite/icite.sty
Added Paths:
-----------
trunk/Master/texmf-dist/doc/latex/icite/samples/
trunk/Master/texmf-dist/doc/latex/icite/samples/bibsample.bib
trunk/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.pdf
trunk/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.tex
trunk/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.pdf
trunk/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.tex
trunk/Master/texmf-dist/source/latex/icite/README.md
Removed Paths:
-------------
trunk/Master/texmf-dist/doc/latex/icite/README.md
Deleted: trunk/Master/texmf-dist/doc/latex/icite/README.md
===================================================================
--- trunk/Master/texmf-dist/doc/latex/icite/README.md 2019-03-13 20:57:45 UTC (rev 50374)
+++ trunk/Master/texmf-dist/doc/latex/icite/README.md 2019-03-13 20:57:59 UTC (rev 50375)
@@ -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 at 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 <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 <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.
-
Modified: trunk/Master/texmf-dist/doc/latex/icite/icite.pdf
===================================================================
(Binary files differ)
Added: trunk/Master/texmf-dist/doc/latex/icite/samples/bibsample.bib
===================================================================
--- trunk/Master/texmf-dist/doc/latex/icite/samples/bibsample.bib (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/icite/samples/bibsample.bib 2019-03-13 20:57:59 UTC (rev 50375)
@@ -0,0 +1,46 @@
+ at Book{Aristotle:Politica,
+ title = {Politica},
+ date = 1964,
+ author = {Aristotle},
+ editor = {Ross, W. D.},
+ origdate = 1957,
+ entrysubtype = {ancient},
+ publisher = {Clarendon Press},
+ location = {Oxford}}
+
+ at 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}}
+
+ at 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}}
+
+ at 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}
+}
+
Property changes on: trunk/Master/texmf-dist/doc/latex/icite/samples/bibsample.bib
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.pdf
===================================================================
(Binary files differ)
Index: trunk/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.pdf 2019-03-13 20:57:45 UTC (rev 50374)
+++ trunk/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.pdf 2019-03-13 20:57:59 UTC (rev 50375)
Property changes on: trunk/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.tex (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.tex 2019-03-13 20:57:59 UTC (rev 50375)
@@ -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}
Property changes on: trunk/Master/texmf-dist/doc/latex/icite/samples/icite-biblatex.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.pdf
===================================================================
(Binary files differ)
Index: trunk/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.pdf
===================================================================
--- trunk/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.pdf 2019-03-13 20:57:45 UTC (rev 50374)
+++ trunk/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.pdf 2019-03-13 20:57:59 UTC (rev 50375)
Property changes on: trunk/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.pdf
___________________________________________________________________
Added: svn:mime-type
## -0,0 +1 ##
+application/pdf
\ No newline at end of property
Added: trunk/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.tex (rev 0)
+++ trunk/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.tex 2019-03-13 20:57:59 UTC (rev 50375)
@@ -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}
Property changes on: trunk/Master/texmf-dist/doc/latex/icite/samples/icite-nobiblatex.tex
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/Master/texmf-dist/source/latex/icite/Makefile
===================================================================
--- trunk/Master/texmf-dist/source/latex/icite/Makefile 2019-03-13 20:57:45 UTC (rev 50374)
+++ trunk/Master/texmf-dist/source/latex/icite/Makefile 2019-03-13 20:57:59 UTC (rev 50375)
@@ -4,6 +4,12 @@
VERS = $(shell ltxfileinfo -v $(NAME).dtx|sed -e 's/^v//')
LOCAL = $(shell kpsewhich --var-value TEXMFLOCAL)
UTREE = $(shell kpsewhich --var-value TEXMFHOME)
+
+exts := md bib ins dtx html
+extsi := tex
+findopts := $(foreach ext,$(exts),-or -iname "*.$(ext)")
+findoptsi := $(foreach ext,$(extsi),-or -iname "*.$(ext)")
+
all: $(NAME).pdf
# test -e README.md || exit 0
$(NAME).pdf: $(NAME).dtx
@@ -16,47 +22,91 @@
if [ -f primary.idx ]; then texindy -M icite.xdy primary.idx >/dev/null; fi
lualatex --shell-escape --recorder --interaction=nonstopmode $(NAME).dtx > /dev/null
lualatex --shell-escape --recorder --interaction=nonstopmode $(NAME).dtx > /dev/null
+ if [ ! -d $(PWD)/TMP ]; then mkdir $(PWD)/TMP; fi
+ cp $(PWD)/samples/*.bib $(PWD)/TMP
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-biblatex.tex
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-biblatex.tex
+ texindy $(PWD)/TMP/pr-sources.idx
+ biber $(PWD)/TMP/icite-biblatex
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-biblatex.tex
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-biblatex.tex
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-nobiblatex.tex
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-nobiblatex.tex
+ texindy $(PWD)/TMP/pr-sources.idx
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-nobiblatex.tex
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-nobiblatex.tex
+ mv TMP/*.pdf samples/
+
+samples:
+ if [ ! -d $(PWD)/TMP ]; then mkdir $(PWD)/TMP; fi
+ cp $(PWD)/samples/*.bib $(PWD)/TMP
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-biblatex.tex
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-biblatex.tex
+ texindy $(PWD)/TMP/pr-sources.idx
+ biber $(PWD)/TMP/icite-biblatex
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-biblatex.tex
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-biblatex.tex
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-nobiblatex.tex
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-nobiblatex.tex
+ texindy $(PWD)/TMP/pr-sources.idx
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-nobiblatex.tex
+ lualatex --output-dir=$(PWD)/TMP --shell-escape samples/icite-nobiblatex.tex
+ mv TMP/*.pdf samples/
+
lualatex:
lualatex --shell-escape --recorder --interaction=batchmode $(NAME).dtx >/dev/null
+
clean: lualatex
- rm -f $(NAME).{aux,fls,glo,gls,hd,idx,ilg,ind,log,out,toc,xdy,listing,bcf,bib,bbl,blg,run.xml}
- rm -f loccit.* primary.*
- rm -f *~
- rm -rf auto/
+ rm -f $(NAME).bib $(PWD)/TMP/*.bib
+ rm -rf .backup
+ find -iname "*~" -or -iname "*.pdf" | xargs rm -rf
+ find ./* -type f -iname "Makefile" $(findopts) > ls-R
+ find ./* -type f -iname "samples/*" $(findoptsi) >> ls-R
+ rsync -avPr --files-from=ls-R . .backup
+ rm -rf *
+ cp -p -r .backup/* .
+ rm -rf .backup
+ pandoc -s README.md -o about.html
+
distclean: clean uninst
- rm -rf _minted-*
- rm -f $(NAME).{pdf,sty}
- rm -f *.zip *.tar.gz
- pandoc -s README.md -o about.html
+
inst: uninst all
mkdir -p $(UTREE)/{tex,source,doc}/latex/$(NAME)
cp $(NAME).dtx $(UTREE)/source/latex/$(NAME)
cp $(NAME).sty $(UTREE)/tex/latex/$(NAME)
cp $(NAME).pdf $(UTREE)/doc/latex/$(NAME)
+
local: uninst
lualatex $(NAME).ins
mkdir -p $(UTREE)/{tex,source,doc}/latex/$(NAME)
cp $(NAME).sty $(UTREE)/tex/latex/$(NAME)
+
uninst:
rm -rf $(UTREE)/{tex,source,doc}/latex/$(NAME)
+
install: all
sudo mkdir -p $(LOCAL)/{tex,source,doc}/latex/$(NAME)
sudo cp $(NAME).dtx $(LOCAL)/source/latex/$(NAME)
sudo cp $(NAME).sty $(LOCAL)/tex/latex/$(NAME)
sudo cp $(NAME).pdf $(LOCAL)/doc/latex/$(NAME)
+
uninstall:
rm -rf $(LOCAL)/{tex,source,doc}/latex/$(NAME)
+
zip: all
ln -sf . $(NAME)
- zip -Drq $(PWD)/$(NAME)-$(VERS).zip $(NAME)/{README.md,$(NAME).{pdf,dtx,ins}}
+ zip -Drq $(PWD)/$(NAME)-$(VERS).zip $(NAME)/{samples,README.md,$(NAME).{pdf,dtx,ins}}
rm $(NAME)
+
package: distclean all
mkdir $(NAME)/
cp Makefile README.md $(NAME).{dtx,ins,pdf} $(NAME)/
+ cp -r samples/ $(NAME)/
mkdir -p tex/latex/$(NAME)/
cp $(NAME).sty tex/latex/$(NAME)/
mkdir -p doc/latex/$(NAME)/
cp $(NAME).pdf doc/latex/$(NAME)/
+ cp -r samples/ doc/latex/$(NAME)/
mkdir -p source/latex/$(NAME)/
cp Makefile README.md $(NAME).{dtx,ins} source/latex/$(NAME)/
zip -r $(NAME).tds.zip tex doc source
@@ -64,4 +114,4 @@
tar czf $(NAME)-$(VERS).tar.gz $(NAME).tds.zip $(NAME)/
rm -rf $(NAME)/
-.PHONY: all lualatex clean distclean inst local uninst install uninstall zip package
+.PHONY: all lualatex clean distclean inst local uninst install uninstall zip package samples
Added: trunk/Master/texmf-dist/source/latex/icite/README.md
===================================================================
--- trunk/Master/texmf-dist/source/latex/icite/README.md (rev 0)
+++ trunk/Master/texmf-dist/source/latex/icite/README.md 2019-03-13 20:57:59 UTC (rev 50375)
@@ -0,0 +1,112 @@
+---
+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 _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 at 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 <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 <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.
+
Property changes on: trunk/Master/texmf-dist/source/latex/icite/README.md
___________________________________________________________________
Added: svn:eol-style
## -0,0 +1 ##
+native
\ No newline at end of property
Modified: trunk/Master/texmf-dist/source/latex/icite/icite.dtx
===================================================================
--- trunk/Master/texmf-dist/source/latex/icite/icite.dtx 2019-03-13 20:57:45 UTC (rev 50374)
+++ trunk/Master/texmf-dist/source/latex/icite/icite.dtx 2019-03-13 20:57:59 UTC (rev 50375)
@@ -15,7 +15,7 @@
`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
+called _indices locorum citatorum_. It relies on a specific
`\icite` command and can operate with either BibTeX or BibLaTeX.
License and disclamer
@@ -46,7 +46,7 @@
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/>.
+with this program. If not, see <http://www.gnu.org/licenses/>.
This release of icite consists of the following source files:
@@ -188,7 +188,7 @@
%<package>\NeedsTeXFormat{LaTeX2e}[1999/12/01]
%<package>\ProvidesPackage{icite}
%<*package>
- [2019/03/07 v1.00 Make Indices locorum citatorum]
+ [2019/03/12 v1.1 Make Indices locorum citatorum]
%</package>
%<*driver>
\documentclass{ltxdoc}
@@ -341,10 +341,11 @@
\IndexSubtypeAs{classical}{primary}
\bibinput{icite}
\usepackage[nonewpage,xindy]{imakeidx}
-\indexsetup{level=\subsubsection*}
+\newcommand{\donothing}[1]{}
+\indexsetup{level=\donothing}
\makeindex
-\makeindex[name=loccit, title=Index of Passages Cited (modern authors)]
-\makeindex[name=primary, title=\emph{Index locorum citatorum}]
+\makeindex[name=loccit]
+\makeindex[name=primary]
\usepackage{tabto}
\usepackage{classics}
\newclassic{iau}{\classicsRoman{#1}|, #1|.#1}
@@ -404,6 +405,7 @@
\begin{document}
\DocInput{\jobname.dtx}
\PrintChanges
+ \section{Index}
\indexprologue{Numbers written in italic refer to the page where the
corresponding entry is described; numbers underlined refer to the
code line of the definition; numbers in roman refer to the code
@@ -414,7 +416,7 @@
%</driver>
% \fi
%
-% \CheckSum{269}
+% \CheckSum{316}
%
% \CharacterTable
% {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
@@ -451,6 +453,10 @@
%
% \GetFileInfo{\jobname.dtx}
% \DoNotIndex{\newcommand,\newenvironment}
+%
+% \newcommand*{\NEWfeature}[1]{%
+% \hskip 1sp \marginpar{\small\sffamily\raggedright
+% New feature\\#1}}
%
% \title{\tcbox[colframe=black, enhanced, tikznode, drop lifted
% shadow, colback=white, boxrule=.25mm]{%
@@ -469,11 +475,11 @@
% \icitetableofcontents
% \normalsize
%
-%\changes{v1.00}{2019/03/07}{First public release}
+% \changes{v1.00}{2019/03/07}{First public release}
%
% \begin{abstract}
% \package{icite} is designed to produce from \hologo{BibTeX} or
-% Bib\LaTeX\ bibliographic databases the different indices of
+% Bib\LaTeX\ bibliographical databases the different indices of
% authors and works cited which are called \emph{indices locorum
% citatorum}. It relies on a specific \cs{icite} command and can
% operate with either \hologo{BibTeX} or Bib\LaTeX.
@@ -553,7 +559,7 @@
% not require Bib\LaTeX. Instead, \hologo{BibTeX} can be used as
% \package{icite} uses the \package{usebib}
% package\footnote{\cite{usebib}} to build the indices by drawing
-% directly from the bibliographic database.
+% directly from the bibliographical database.
%
%
% \section[The \package{icite} package]{The \textsf{icite} package}
@@ -592,7 +598,24 @@
% to |loccit| if it is used alone. This is an easy way to have all
% passages cited indexed in a separate index named |loccit|.
%
-% \paragraph{Bibliographic database}
+% \DescribeOption{nobibengine}\NEWfeature{v1.1}
+% \changes{v1.1}{2019/03/12}{New global option \texttt{nobibengine}}%
+% |nobibengine|$=$|true|\verb+|+|false|\hfill%
+% \tcboxverb{Default: not set}\\
+% This named argument does not need a value as it defaults to |true|
+% if it is used. When this option is activated, \package{icite} does
+% not use \hologo{BibTeX} or Bib\LaTeX\ to insert the citations in the
+% body text---even if either is loaded in the preamble---and pulls the
+% necessary information directly from the bibliographical
+% database. For this reason, \cs{bibinput} described below is of
+% course still required. The citations inserted consist of the
+% elements described below \vref{sec:entry-fields}
+% \vpageref{sec:entry-fields}. However, it must be noted that if the
+% entry field |shorthand| of any author/work be set in the database,
+% it takes precedence over the fields used to define author names and
+% titles.
+%
+% \paragraph{Bibliographical database}
% \DescribeMacro{\bibinput} Once \package{icite} is loaded, it must be
% connected to at least one bibliographic |.bib| file. To that end,
% \package{icite} uses the same \cs{bibinput} command as
@@ -607,7 +630,7 @@
% passages in a separate index named 'loccit':
\usepackage[citecmd=autocite, defaultindex]{icite}
% note that the .bib file must be stripped of its extension:
- \usebib{bibliography} % that is: load bibliography.bib
+ \bibinput{bibliography} % that is: load bibliography.bib
\end{code}
% \iffalse
%</example>
@@ -633,6 +656,7 @@
% command.
%
% \subsection{Entry fields}
+% \label{sec:entry-fields}
% \subsubsection{Author names}
% To process author names, \package{icite} uses the following entry
% fields:
@@ -713,7 +737,7 @@
% passages in a separate index named 'loccit':
\usepackage[citecmd=autocite, defaultindex]{icite}
% load bibliography.bib
- \usebib{bibliography}
+ \bibinput{bibliography}
% load biblatex (with oxnotes, \autocite acts as \footcite)
\usepackage[style=oxnotes]{biblatex}
@@ -958,7 +982,9 @@
%
% \subsection{Indices}
% \label{ref:indices}
+% \subsubsection{Index of Passages Cited (modern authors)}
% \printindex[loccit]
+% \subsubsection{\emph{Index locorum citatorum}}
% \printindex[primary]
%
% \subsection{\texorpdfstring{\hologo{BibTeX}
@@ -990,6 +1016,9 @@
\def\ic at dfltind{#1}
\fi
}
+\newif\ifno at bibengine
+\define at boolkey{icite.sty}[@pkg@]{nobibengine}[true]{%
+ \if at pkg@nobibengine\no at bibenginetrue\else\fi}
\ExecuteOptionsX{citecmd}
\ProcessOptionsX\relax
% \end{macrocode}
@@ -1009,6 +1038,7 @@
\define at reuse@key{indextitle}
\define at reuse@key{indexsorttitle}
\define at reuse@key{entrysubtype}
+\define at reuse@key{shorthand}
% \end{macrocode}
% This is the same as \cs{usebibentry} from \package{ebib}, but it
% does not return an error if the entry field is not found:
@@ -1056,6 +1086,7 @@
% qualified citation lists or so-called \enquote*{multicite} commands.
% \begin{macrocode}
\NewDocumentCommand{\icite}{o o m O{\ic at dfltcit}}{%
+ \edef\@shorthand{\get at bibentry{#3}{shorthand}}%
\edef\@subtype{\get at bibentry{#3}{entrysubtype}}%
\edef\@author{\get at bibentry{#3}{author}}%
\edef\@indexauthor{\get at bibentry{#3}{indexauthor}}%
@@ -1070,10 +1101,10 @@
\def\@useauthor{\@indexauthor}%
\fi
\ifx\@sortname\empty
- \def\@sortedauthor{\@useauthor}%
- \else
- \def\@sortedauthor{{\@sortname}@\@useauthor}%
- \fi
+ \def\@sortedauthor{\@useauthor}%
+ \else
+ \def\@sortedauthor{{\@sortname}@\@useauthor}%
+ \fi
\ifx\@indextitle\empty
\ifx\@shorttitle\empty
\def\@usetitle{\@title}%
@@ -1110,7 +1141,15 @@
\index{\@sortedauthor!\@sortedtitle}%
\fi\fi%
\fi}}
+ \ifno at bibengine
+ \ifx\@shorthand\empty%
+ \@useauthor, \TitleStyle{\@usetitle}%
+ \else%
+ \@shorthand%
+ \fi%
+ \else%
\csname #4\endcsname{#3}%
+ \fi%
}
{\IfNoValueTF{#2}%
{\DTLifdbempty{icite at indices}{%
@@ -1134,7 +1173,16 @@
\index{\@sortedauthor!\@sortedtitle!#1}%
\fi\fi%
\fi}}%
- \csname #4\endcsname[{#1}]{#3}}
+ \ifno at bibengine
+ \ifx\@shorthand\empty%
+ \@useauthor, \TitleStyle{\@usetitle}, {#1}%
+ \else%
+ \@shorthand, {#1}%
+ \fi%
+ \else%
+ \csname #4\endcsname[{#1}]{#3}%
+ \fi%
+ }
{\DTLifdbempty{icite at indices}{%
\ifno at index\else
\ifdefault at index%
@@ -1156,7 +1204,16 @@
\index{\@sortedauthor!\@sortedtitle!#2}%
\fi\fi%
\fi}}%
- \csname #4\endcsname[#1][{#2}]{#3}}%
+ \ifno at bibengine
+ \ifx\@shorthand\empty%
+ #1 \@useauthor, \TitleStyle{\@usetitle}, {#2}%
+ \else%
+ #1 \@shorthand, {#2}%
+ \fi
+ \else%
+ \csname #4\endcsname[#1][{#2}]{#3}%
+ \fi%
+ }%
}%
}
% \end{macrocode}
Modified: trunk/Master/texmf-dist/tex/latex/icite/icite.sty
===================================================================
--- trunk/Master/texmf-dist/tex/latex/icite/icite.sty 2019-03-13 20:57:45 UTC (rev 50374)
+++ trunk/Master/texmf-dist/tex/latex/icite/icite.sty 2019-03-13 20:57:59 UTC (rev 50375)
@@ -32,7 +32,7 @@
%%
\NeedsTeXFormat{LaTeX2e}[1999/12/01]
\ProvidesPackage{icite}
- [2019/03/07 v1.00 Make Indices locorum citatorum]
+ [2019/03/12 v1.1 Make Indices locorum citatorum]
\RequirePackage{xkeyval}
\DeclareOptionX{citecmd}[cite]{\def\ic at dfltcit{#1}}
\newif\ifdefault at index
@@ -47,6 +47,9 @@
\def\ic at dfltind{#1}
\fi
}
+\newif\ifno at bibengine
+\define at boolkey{icite.sty}[@pkg@]{nobibengine}[true]{%
+ \if at pkg@nobibengine\no at bibenginetrue\else\fi}
\ExecuteOptionsX{citecmd}
\ProcessOptionsX\relax
\RequirePackage{xparse}
@@ -60,6 +63,7 @@
\define at reuse@key{indextitle}
\define at reuse@key{indexsorttitle}
\define at reuse@key{entrysubtype}
+\define at reuse@key{shorthand}
\def\get at bibentry#1#2{\@ifundefined{reuse@#1@#2}{}
{\@nameuse{reuse@#1@#2}}}
\DTLnewdb{icite at indices}
@@ -75,6 +79,7 @@
}
\@onlypreamble\SetTitleStyle
\NewDocumentCommand{\icite}{o o m O{\ic at dfltcit}}{%
+ \edef\@shorthand{\get at bibentry{#3}{shorthand}}%
\edef\@subtype{\get at bibentry{#3}{entrysubtype}}%
\edef\@author{\get at bibentry{#3}{author}}%
\edef\@indexauthor{\get at bibentry{#3}{indexauthor}}%
@@ -89,10 +94,10 @@
\def\@useauthor{\@indexauthor}%
\fi
\ifx\@sortname\empty
- \def\@sortedauthor{\@useauthor}%
- \else
- \def\@sortedauthor{{\@sortname}@\@useauthor}%
- \fi
+ \def\@sortedauthor{\@useauthor}%
+ \else
+ \def\@sortedauthor{{\@sortname}@\@useauthor}%
+ \fi
\ifx\@indextitle\empty
\ifx\@shorttitle\empty
\def\@usetitle{\@title}%
@@ -129,7 +134,15 @@
\index{\@sortedauthor!\@sortedtitle}%
\fi\fi%
\fi}}
+ \ifno at bibengine
+ \ifx\@shorthand\empty%
+ \@useauthor, \TitleStyle{\@usetitle}%
+ \else%
+ \@shorthand%
+ \fi%
+ \else%
\csname #4\endcsname{#3}%
+ \fi%
}
{\IfNoValueTF{#2}%
{\DTLifdbempty{icite at indices}{%
@@ -153,7 +166,16 @@
\index{\@sortedauthor!\@sortedtitle!#1}%
\fi\fi%
\fi}}%
- \csname #4\endcsname[{#1}]{#3}}
+ \ifno at bibengine
+ \ifx\@shorthand\empty%
+ \@useauthor, \TitleStyle{\@usetitle}, {#1}%
+ \else%
+ \@shorthand, {#1}%
+ \fi%
+ \else%
+ \csname #4\endcsname[{#1}]{#3}%
+ \fi%
+ }
{\DTLifdbempty{icite at indices}{%
\ifno at index\else
\ifdefault at index%
@@ -175,7 +197,16 @@
\index{\@sortedauthor!\@sortedtitle!#2}%
\fi\fi%
\fi}}%
- \csname #4\endcsname[#1][{#2}]{#3}}%
+ \ifno at bibengine
+ \ifx\@shorthand\empty%
+ #1 \@useauthor, \TitleStyle{\@usetitle}, {#2}%
+ \else%
+ #1 \@shorthand, {#2}%
+ \fi
+ \else%
+ \csname #4\endcsname[#1][{#2}]{#3}%
+ \fi%
+ }%
}%
}
\endinput
More information about the tex-live-commits
mailing list