summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/lualatex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-02-13 21:24:29 +0000
committerKarl Berry <karl@freefriends.org>2022-02-13 21:24:29 +0000
commitbb1788443ceb234c15451f189aa9e6390576a0d6 (patch)
tree59d2c5874ec5d951481b803557d1c1b81d1f081b /Master/texmf-dist/doc/lualatex
parentc792c4fcd935edbc5fb78b4f5d1df84aee0ea1ba (diff)
xindex (13feb22)
git-svn-id: svn://tug.org/texlive/trunk@62002 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/lualatex')
-rw-r--r--Master/texmf-dist/doc/lualatex/xindex/CHANGELOG4
-rw-r--r--Master/texmf-dist/doc/lualatex/xindex/README.md2
-rw-r--r--Master/texmf-dist/doc/lualatex/xindex/tests/HADW.pdfbin18342 -> 18342 bytes
-rw-r--r--Master/texmf-dist/doc/lualatex/xindex/tests/Umlaute.pdfbin15194 -> 15194 bytes
-rw-r--r--Master/texmf-dist/doc/lualatex/xindex/tests/Umlaute2.pdfbin18884 -> 18884 bytes
-rw-r--r--Master/texmf-dist/doc/lualatex/xindex/tests/buch.pdfbin39021 -> 39021 bytes
-rw-r--r--Master/texmf-dist/doc/lualatex/xindex/tests/demo-hyperref.pdfbin28624 -> 28624 bytes
-rw-r--r--Master/texmf-dist/doc/lualatex/xindex/tests/demo.pdfbin34606 -> 34606 bytes
-rw-r--r--Master/texmf-dist/doc/lualatex/xindex/tests/demo2.ind2
-rw-r--r--Master/texmf-dist/doc/lualatex/xindex/tests/demo3.pdfbin9216 -> 9216 bytes
-rw-r--r--Master/texmf-dist/doc/lualatex/xindex/tests/demo4.pdfbin11883 -> 11883 bytes
-rw-r--r--Master/texmf-dist/doc/lualatex/xindex/xindex-doc.pdfbin412615 -> 451406 bytes
-rw-r--r--Master/texmf-dist/doc/lualatex/xindex/xindex-doc.tex499
13 files changed, 325 insertions, 182 deletions
diff --git a/Master/texmf-dist/doc/lualatex/xindex/CHANGELOG b/Master/texmf-dist/doc/lualatex/xindex/CHANGELOG
index 70cae1d3542..ed1039f89a9 100644
--- a/Master/texmf-dist/doc/lualatex/xindex/CHANGELOG
+++ b/Master/texmf-dist/doc/lualatex/xindex/CHANGELOG
@@ -1,3 +1,7 @@
+0.40 2022-02-12 - added -i,--ignoreSpace for sorting
+0.39 2022-02-12 - detect language in aux file
+0.38 2022-02-11 - modified setVersion.sh
+0.37 2022-02-08 - fix for doubled see entries if roman pagenumbers are set
0.36 2022-02-07 - fix for introduced bug
0.35 2022-01-22 - fix for escape character
- added language spain for folium pages and header
diff --git a/Master/texmf-dist/doc/lualatex/xindex/README.md b/Master/texmf-dist/doc/lualatex/xindex/README.md
index 6ddb92f8324..e9710684d01 100644
--- a/Master/texmf-dist/doc/lualatex/xindex/README.md
+++ b/Master/texmf-dist/doc/lualatex/xindex/README.md
@@ -12,6 +12,7 @@ will be included in at least LuaTeX 1.09 (TeXLive 2019)
* xindex-baselib.lua -- base file
* xindex-lib.lua -- functions module
* xindex-lapp.lua -- read parameter
+* xindex-pretty.lua -- pretty printing of tables for debugging
* xindex-unicode.lua -- list of Unicode categories
The syntax of `xindex`
@@ -32,6 +33,7 @@ possible options are (short,long):
-n,--noheadings
-a,--no_casesensitive
-b,--no_labels
+ -i,--ignoreSpace
-o,--output (default "")
-l,--language (default en)
-p,--prefix (default L)
diff --git a/Master/texmf-dist/doc/lualatex/xindex/tests/HADW.pdf b/Master/texmf-dist/doc/lualatex/xindex/tests/HADW.pdf
index 43e7014edcc..c1ddc640f56 100644
--- a/Master/texmf-dist/doc/lualatex/xindex/tests/HADW.pdf
+++ b/Master/texmf-dist/doc/lualatex/xindex/tests/HADW.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/lualatex/xindex/tests/Umlaute.pdf b/Master/texmf-dist/doc/lualatex/xindex/tests/Umlaute.pdf
index 83a38ef56d8..671b16dba8e 100644
--- a/Master/texmf-dist/doc/lualatex/xindex/tests/Umlaute.pdf
+++ b/Master/texmf-dist/doc/lualatex/xindex/tests/Umlaute.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/lualatex/xindex/tests/Umlaute2.pdf b/Master/texmf-dist/doc/lualatex/xindex/tests/Umlaute2.pdf
index 1ae2761ab5f..2b37bbd8899 100644
--- a/Master/texmf-dist/doc/lualatex/xindex/tests/Umlaute2.pdf
+++ b/Master/texmf-dist/doc/lualatex/xindex/tests/Umlaute2.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/lualatex/xindex/tests/buch.pdf b/Master/texmf-dist/doc/lualatex/xindex/tests/buch.pdf
index 8f7695f8035..90ce8da0a77 100644
--- a/Master/texmf-dist/doc/lualatex/xindex/tests/buch.pdf
+++ b/Master/texmf-dist/doc/lualatex/xindex/tests/buch.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/lualatex/xindex/tests/demo-hyperref.pdf b/Master/texmf-dist/doc/lualatex/xindex/tests/demo-hyperref.pdf
index 07b47f5c4b0..5cc99006629 100644
--- a/Master/texmf-dist/doc/lualatex/xindex/tests/demo-hyperref.pdf
+++ b/Master/texmf-dist/doc/lualatex/xindex/tests/demo-hyperref.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/lualatex/xindex/tests/demo.pdf b/Master/texmf-dist/doc/lualatex/xindex/tests/demo.pdf
index bd5bd8371cb..8ee6506f672 100644
--- a/Master/texmf-dist/doc/lualatex/xindex/tests/demo.pdf
+++ b/Master/texmf-dist/doc/lualatex/xindex/tests/demo.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/lualatex/xindex/tests/demo2.ind b/Master/texmf-dist/doc/lualatex/xindex/tests/demo2.ind
index 6bd956f8c66..a2bfb309fc2 100644
--- a/Master/texmf-dist/doc/lualatex/xindex/tests/demo2.ind
+++ b/Master/texmf-dist/doc/lualatex/xindex/tests/demo2.ind
@@ -9,7 +9,7 @@
\indexspace
\textbf{D}\label{L-xindex-D}
\nopagebreak[4]
- \item {Downes}, Michael, {xxxvi}, {xxxvii}
+ \item {Downes}, Michael, {xxxvif}
\indexspace
\textbf{F}\label{L-xindex-F}
diff --git a/Master/texmf-dist/doc/lualatex/xindex/tests/demo3.pdf b/Master/texmf-dist/doc/lualatex/xindex/tests/demo3.pdf
index 28ac172fd15..2d72ee52ebe 100644
--- a/Master/texmf-dist/doc/lualatex/xindex/tests/demo3.pdf
+++ b/Master/texmf-dist/doc/lualatex/xindex/tests/demo3.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/lualatex/xindex/tests/demo4.pdf b/Master/texmf-dist/doc/lualatex/xindex/tests/demo4.pdf
index 06202ce455c..7db4dc7fd29 100644
--- a/Master/texmf-dist/doc/lualatex/xindex/tests/demo4.pdf
+++ b/Master/texmf-dist/doc/lualatex/xindex/tests/demo4.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/lualatex/xindex/xindex-doc.pdf b/Master/texmf-dist/doc/lualatex/xindex/xindex-doc.pdf
index 882997ed02e..4ade479cc9d 100644
--- a/Master/texmf-dist/doc/lualatex/xindex/xindex-doc.pdf
+++ b/Master/texmf-dist/doc/lualatex/xindex/xindex-doc.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/lualatex/xindex/xindex-doc.tex b/Master/texmf-dist/doc/lualatex/xindex/xindex-doc.tex
index 683a9064253..dec79692e71 100644
--- a/Master/texmf-dist/doc/lualatex/xindex/xindex-doc.tex
+++ b/Master/texmf-dist/doc/lualatex/xindex/xindex-doc.tex
@@ -1,4 +1,4 @@
-%% $Id: xindex-doc.tex 20 2022-01-22 10:37:29Z hvoss $
+%% $Id: xindex-doc.tex 22 2022-02-07 12:18:15Z hvoss $
%
\listfiles\setcounter{errorcontextlines}{100}
\documentclass[paper=a4,fontsize=11pt,DIV=14,parskip=half-,
@@ -81,7 +81,7 @@
\def\setVersion#1{\setVVersion#1!!}
\def\setVVersion#1=#2!!{\def\xIndexVersion{#2}}
-\setVersion{version = 0.36}% can be automatically changed by perl
+\setVersion{version = 0.40}% can be automatically changed by perl
\setkeys{dtk}{cleanup=true,force}
@@ -92,7 +92,7 @@
\begin{document}
\maketitle
\thispagestyle{empty}
-\enlargethispage{1cm}
+%\enlargethispage{1cm}
\tableofcontents
\vfill
@@ -102,6 +102,7 @@ Denis Bitouzé;
Brian Dunn;
Gonzalo Pesquero Serrano;
Michal Hoftich;
+Mykel Kochenderfer;
Frank Mittelbach;
Heiko Oberdiek;
Matteo Paolini;
@@ -109,7 +110,6 @@ Stefan Pinnow;
Florent Rougon;
Martin Sievers;
Simon Spiegel
-
\clearpage
\section{Introduction}
@@ -173,7 +173,9 @@ xindex
[-a, --no_casesensitive ] default is false
[-b,--no_labels ] default is false
[-n,--noheadings ] default is false
+ [-i,--ignoreSpace ] default is false
[-o,--output ] default is <input>.ind
+ [-k,--checklang ] default ist false
[-l,--language ] default is en
[-p,--prefix] default L
[-u,--use_UCA ] default is false
@@ -369,19 +371,20 @@ Run \texttt{xindex} with \texttt{xindex -e ">"}\index{<file.idx>}\index{123}
The \Index{language} is only important for the first two headers in the output of the index data.
They are by default \emph{Symbols} followed by \emph{Numbers}. In a new version of \Lprog{xindex}
it will be customizable.
-The predefined language is »en« and currently the following languages are possible:
+The predefined language is »en« and currently the following languages which its alias are possible:
\begin{Verbatim}[commandchars=\\<>]
indexheader = {
- cs = {"Symboly", "Čísla"},
- da = {"Symboler", "Tal"},
- de = {"Symbole", "Zahlen"},
- en = {"Symbols", "Numbers"},
- es = {"Símbolos", "Números"},
- fr = {"Symboles","Nombres"},
- it = {"Simboli", "Numeri"},
- \Japanese jp = {"シンボル","番号"},
- \DejaVuMono no = {"Symboler","Tall"},
+ cs = {"Symboly", "Čísla", "czech"},
+ da = {"Symboler", "Tal", "danish"},
+ de = {"Symbole", "Zahlen", "austrian", "german", "germanb", "ngerman", "naustrian"},
+ en = {"Symbols", "Numbers", "english", "USenglish", "american", "UKenglish", "british", "canadian", "australian", "newzealand"},
+ es = {"Símbolos", "Números", "spanish"},
+ fr = {"Symboles","Nombres", "french", "francais", "canadien", "acadian"},
+ it = {"Simboli", "Numeri", "italian"},
+ \Japanese jp = {"シンボル","番号","japanese"},
+ \DejaVuMono nl = {"Symbolen", "Nummers", "dutch"},
+ no = {"Symboler","Tall", "norsk", "nynorsk"},
}
\end{Verbatim}
@@ -402,6 +405,7 @@ The following example was run with \verb|xindex -l it <file>.idx|:
lstOptions={columns=fixed}]{xindex}
%! lualatex
\documentclass{scrartcl}
+\usepackage[italian]{babel}
\makeatletter
\def\theindex{% only for demonstration
\section*{\indexname}
@@ -428,6 +432,55 @@ Run \texttt{xindex} with \texttt{xindex -l it -e ">"}\index{123}
\end{externalDocument}
+The following example was run with \verb|xindex -l "*" <file>.idx|. Then the language is detected from
+the \Lfile{aux} file. This is only possible if package \Lpack{babel} or \Lpack{polyglossia} are used.
+
+\begin{externalDocument}[
+% grfOptions={width=\dimexpr\linewidth-2\fboxsep-2\fboxrule},
+ pages={1,2},
+ frame,
+ compiler=lualatex,
+ crop,
+ xindex,
+ xindexOptions=-l "*" -e "?",
+ force=true,
+ runs=2,code,docType=latex,
+ showFilename,
+ align=\centering,
+ lstOptions={columns=fixed}]{xindex}
+%! lualatex
+\documentclass{scrartcl}
+\makeatletter
+\def\theindex{% only for demonstration
+ \section*{\indexname}
+ \parskip\z@ \@plus .3\p@\relax \parindent\z@
+ \let\item\@idxitem}
+\makeatother
+%StartVisiblePreamble
+\usepackage[canadien]{babel}
+\usepackage{makeidx}\makeindex
+%StopVisiblePreamble
+\pagestyle{empty}
+\begin{document}
+\section{Escaping characters with ?}
+\begin{itemize}
+\item Exclamation mark ! \index{exclaim (?!)}
+\item Vertical bar| \index{Vertical bar (?|)}
+\item Doublequote \verb|"| \index{?"}
+\item Double doublequote \verb|""| \index{?"?"}
+\item At character @ \index{At (?@)}
+\end{itemize}
+Run \texttt{xindex} with \texttt{xindex -l "*" -e "?"}\index{123}
+\newpage
+\printindex
+\end{document}
+\end{externalDocument}
+
+Instead of using \verb|-l *| one can also use the parameter \verb|-k| or \verb|--checklang|.
+
+
+
+
\section{Sorting}
\subsection{Default sorting by a character table}
The default sorting is unicode aware and uses a translation table for accented characters:
@@ -747,11 +800,205 @@ UCA should be don't in the file \Lfile{xindex-cfg-uca.lua}, which will automatic
by \Lprog{xindex}.
+\subsection{Case sensitive index entries}
+By default \textsf{foo} and \textsf{Foo} are two different entries and will handled differently
+by \Lprog{xindex}: \textsf{Foo} will be as an own entry \emph{before} \textsf{foo}. Let's see
+a more complex example. In the index the entry \verb|xindex-DIN2.lua| is the first one of
+the \verb|xindex-???| series because uppercase letters are sorted before lowercase letters.
+
+\begin{externalDocument}[
+% grfOptions={width=\dimexpr\linewidth-2\fboxsep-2\fboxrule},
+ mpwidth=0.55\linewidth,
+ pages={2},
+ frame=false,
+ compiler=lualatex --shell-escape,
+ crop,
+ xindex,
+% xindexOptions=,
+ force=true,
+ runs=2,code,docType=latex,
+ showFilename,
+ align=\centering,
+ lstOptions={columns=fixed}]{xindex}
+%! lualatex --shell-escape
+\documentclass{scrartcl}
+\usepackage{libertinus-otf}
+\makeatletter
+\def\theindex{% only for demonstration
+ \section*{\indexname}
+ \parskip\z@ \@plus .3\p@\relax \parindent\z@
+ \let\item\@idxitem}
+\makeatother
+\begin{filecontents}[force,noheader]{\jobname.idx}
+\indexentry{xindex package@\texttt {xindex} package|hyperpage}{2}
+\indexentry{xindex program@\texttt {xindex} program|hyperpage}{4}
+\indexentry{xindex-cfg.lua file@\texttt {xindex-cfg.lua} file|hyperpage}{6}
+\indexentry{xindex-newfile.lua file@\texttt {xindex-newfile.lua} file|hyperpage}{6}
+\indexentry{xindex-DIN2.lua file@\texttt {xindex-DIN2.lua} file|hyperpage}{6}
+\indexentry{xindex-cfg-common.cfg file@\texttt {xindex-cfg-common.cfg} file|hyperpage}{9}
+\indexentry{xindex-cfg.lua file@\texttt {xindex-cfg.lua} file|hyperpage}{10}
+\indexentry{xindex-HAdW-eKO.lua file@\texttt {xindex-HAdW-eKO.lua} file|hyperpage}{10}
+\indexentry{xindex-dtk.lua file@\texttt {xindex-dtk.lua} file|hyperpage}{12}
+\indexentry{xindex program@\texttt {xindex} program|hyperpage}{13}
+\indexentry{xindex program@\texttt {xindex} program|hyperpage}{14}
+\indexentry{xindex-cfg-common.lua file@\texttt {xindex-cfg-common.lua} file|hyperpage}{14}
+\indexentry{xindex package@\texttt {xindex} package|hyperpage}{15}
+\end{filecontents}
+%StartVisiblePreamble
+\usepackage{makeidx}
+\usepackage{hyperref}
+%StopVisiblePreamble
+\pagestyle{empty}
+\begin{document}
+foo\newpage
+\printindex
+\end{document}
+\end{externalDocument}
+
+
+
+The same example sorted with the \verb|-a| or \verb|--nocasesensitive| has another output: now
+\verb|xindex-cfg-common.lua| is the first one of the \verb|xindex-???| series.
+
+
+\begin{externalDocument}[
+% grfOptions={width=\dimexpr\linewidth-2\fboxsep-2\fboxrule},
+ mpwidth=0.55\linewidth,
+ pages={2},
+ frame=false,
+ compiler=lualatex --shell-escape,
+ crop,
+ xindex,
+ xindexOptions=-a,
+ force=true,
+ runs=2,code,docType=latex,
+ showFilename,
+ align=\centering,
+ lstOptions={columns=fixed}]{xindex}
+%! lualatex --shell-escape
+\documentclass{scrartcl}
+\usepackage{libertinus-otf}
+\makeatletter
+\def\theindex{% only for demonstration
+ \section*{\indexname}
+ \parskip\z@ \@plus .3\p@\relax \parindent\z@
+ \let\item\@idxitem}
+\makeatother
+\begin{filecontents}[force,noheader]{\jobname.idx}
+\indexentry{xindex package@\texttt {xindex} package|hyperpage}{2}
+\indexentry{xindex program@\texttt {xindex} program|hyperpage}{4}
+\indexentry{xindex-cfg.lua file@\texttt {xindex-cfg.lua} file|hyperpage}{6}
+\indexentry{xindex-newfile.lua file@\texttt {xindex-newfile.lua} file|hyperpage}{6}
+\indexentry{xindex-DIN2.lua file@\texttt {xindex-DIN2.lua} file|hyperpage}{6}
+\indexentry{xindex-cfg-common.cfg file@\texttt {xindex-cfg-common.cfg} file|hyperpage}{9}
+\indexentry{xindex-cfg.lua file@\texttt {xindex-cfg.lua} file|hyperpage}{10}
+\indexentry{xindex-HAdW-eKO.lua file@\texttt {xindex-HAdW-eKO.lua} file|hyperpage}{10}
+\indexentry{xindex-dtk.lua file@\texttt {xindex-dtk.lua} file|hyperpage}{12}
+\indexentry{xindex program@\texttt {xindex} program|hyperpage}{13}
+\indexentry{xindex program@\texttt {xindex} program|hyperpage}{14}
+\indexentry{xindex-cfg-common.lua file@\texttt {xindex-cfg-common.lua} file|hyperpage}{14}
+\indexentry{xindex package@\texttt {xindex} package|hyperpage}{15}
+\end{filecontents}
+%StartVisiblePreamble
+\usepackage{makeidx}
+\usepackage{hyperref}
+%StopVisiblePreamble
+\pagestyle{empty}
+\begin{document}
+foo\newpage
+\printindex
+\end{document}
+\end{externalDocument}
+
+
+
+
+
+
+
+\subsection{Ignore space for sorting}
+By default \textsf{alpha sort} will be sorted \emph{before} \textsf{alphaA}:
+
+\begin{externalDocument}[
+% grfOptions={width=\dimexpr\linewidth-2\fboxsep-2\fboxrule},
+ mpwidth=0.55\linewidth,
+ pages={2},
+ frame=false,
+ compiler=lualatex --shell-escape,
+ crop,
+ xindex,
+% xindexOptions=,
+ force=true,
+ runs=2,code,docType=latex,
+ showFilename,
+ align=\centering,
+ lstOptions={columns=fixed}]{xindex}
+%! lualatex --shell-escape
+\documentclass{scrartcl}
+\usepackage{libertinus-otf}
+\makeatletter
+\def\theindex{% only for demonstration
+ \section*{\indexname}
+ \parskip\z@ \@plus .3\p@\relax \parindent\z@
+ \let\item\@idxitem}
+\makeatother
+%StartVisiblePreamble
+\usepackage{makeidx}\makeindex
+% default sorting
+%StopVisiblePreamble
+\pagestyle{empty}
+\begin{document}
+Test
+\index{alpha sort}\index{alphaA}
+\newpage
+\printindex
+\end{document}
+\end{externalDocument}
+
+
+This can be changed with the optional argument \verb|-i| or \verb|--ignoreSpace|:
+
+\begin{externalDocument}[
+% grfOptions={width=\dimexpr\linewidth-2\fboxsep-2\fboxrule},
+ mpwidth=0.55\linewidth,
+ pages={2},
+ frame=false,
+ compiler=lualatex --shell-escape,
+ crop,
+ xindex,
+ xindexOptions=-i,
+ force=true,
+ runs=2,code,docType=latex,
+ showFilename,
+ align=\centering,
+ lstOptions={columns=fixed}]{xindex}
+%! lualatex --shell-escape
+\documentclass{scrartcl}
+\usepackage{libertinus-otf}
+\makeatletter
+\def\theindex{% only for demonstration
+ \section*{\indexname}
+ \parskip\z@ \@plus .3\p@\relax \parindent\z@
+ \let\item\@idxitem}
+\makeatother
+%StartVisiblePreamble
+\usepackage{makeidx}\makeindex
+% sort with xindex -i <file>
+%StopVisiblePreamble
+\pagestyle{empty}
+\begin{document}
+Test
+\index{alpha sort}\index{alphaA}
+\newpage
+\printindex
+\end{document}
+\end{externalDocument}
+
%\clearpage
-\section{Compressing pagenumbers}\label{Compressing}
+\subsection{Compressing pagenumber series}\label{Compressing}
By default page sequences of an entry are compressed to
\begin{description}
\item[8f] page 8 and 9
@@ -820,62 +1067,7 @@ foo\index{foo}foobar\index{foobar|)}
\end{externalDocument}
-
-\section{\texttt{hyperref}}
-
-Using the package \Lpack{hyperref} is no problem:
-
-\enlargethispage{2.5\normalbaselineskip}
-
-\begin{externalDocument}[
-% grfOptions={width=\dimexpr\linewidth-2\fboxsep-2\fboxrule},
- mpwidth=0.55\linewidth,
- pages={3},
- frame=false,
- compiler=lualatex,
- crop,
- xindex,
- xindexOptions=-l de,
- force=true,
- runs=2,code,docType=latex,
- showFilename,
- align=\centering,
- lstOptions={columns=fixed}]{xindex}
-%! lualatex
-\documentclass[paper=a6]{scrartcl}
-\usepackage{multicol}
-\makeatletter
-\def\theindex{% only for demonstration
- \section*{\indexname}
- \begin{multicols}{2}
- \parskip\z@ \@plus .3\p@\relax \parindent\z@
- \let\item\@idxitem}
-\def\endtheindex{\end{multicols}}
-\makeatother
-%StartVisiblePreamble
-\usepackage{makeidx}\makeindex
-\usepackage{hvindex}% for \Index
-\usepackage[colorlinks]{hyperref}
-%StopVisiblePreamble
-\pagestyle{empty}
-\begin{document}
-Sorted with \verb|-l DE|
-\Index{Österreich} \Index{Öresund}
-\Index{Ostern} \Index{Ober} \Index{Oberin}
-\Index{Österreich} \index{Öresund|textbf}
-\Index{Ostern} \Index{Ober} \Index{Oberin}
-\Index{Obstler} \Index{Öl} \Index{ölen}
-\Index{Ödem} \Index{Oligarch} \Index{Oder}
-\Index{oder} \index{Fluss!Oder|textit}
-\Index{Oder|seealso{Fluss}} \Index{Göbel}
-\Index{Goethe} \Index{Göthe} \Index{Götz}
-\newpage\Index{Goldmann} \Index{Goethe}
-\newpage \printindex
-\end{document}
-\end{externalDocument}
-
-
-\section{Page argument}
+\subsection{Modify Pagenumber}
Every page can be combined with an additional macro, like \verb=\index{foo|fbox}=, the page number
will be set into a framebox. If we have on the same page the two commands:
@@ -930,6 +1122,8 @@ und foo\index{foo|fbox}
+
+
\section{The config file}
The main config file is \Lfile{xindex-cfg.lua} is used by default and loading it by the
@@ -1245,6 +1439,59 @@ baz\index{foo!bar!baz} foobar%
+\section{\texttt{hyperref}}
+
+Using the package \Lpack{hyperref} is no problem:
+
+\enlargethispage{2.5\normalbaselineskip}
+
+\begin{externalDocument}[
+% grfOptions={width=\dimexpr\linewidth-2\fboxsep-2\fboxrule},
+ mpwidth=0.55\linewidth,
+ pages={3},
+ frame=false,
+ compiler=lualatex,
+ crop,
+ xindex,
+ xindexOptions=-l de,
+ force=true,
+ runs=2,code,docType=latex,
+ showFilename,
+ align=\centering,
+ lstOptions={columns=fixed}]{xindex}
+%! lualatex
+\documentclass[paper=a6]{scrartcl}
+\usepackage{multicol}
+\makeatletter
+\def\theindex{% only for demonstration
+ \section*{\indexname}
+ \begin{multicols}{2}
+ \parskip\z@ \@plus .3\p@\relax \parindent\z@
+ \let\item\@idxitem}
+\def\endtheindex{\end{multicols}}
+\makeatother
+%StartVisiblePreamble
+\usepackage{makeidx}\makeindex
+\usepackage{hvindex}% for \Index
+\usepackage[colorlinks]{hyperref}
+%StopVisiblePreamble
+\pagestyle{empty}
+\begin{document}
+Sorted with \verb|-l DE|
+\Index{Österreich} \Index{Öresund}
+\Index{Ostern} \Index{Ober} \Index{Oberin}
+\Index{Österreich} \index{Öresund|textbf}
+\Index{Ostern} \Index{Ober} \Index{Oberin}
+\Index{Obstler} \Index{Öl} \Index{ölen}
+\Index{Ödem} \Index{Oligarch} \Index{Oder}
+\Index{oder} \index{Fluss!Oder|textit}
+\Index{Oder|seealso{Fluss}} \Index{Göbel}
+\Index{Goethe} \Index{Göthe} \Index{Götz}
+\newpage\Index{Goldmann} \Index{Goethe}
+\newpage \printindex
+\end{document}
+\end{externalDocument}
+
@@ -1514,116 +1761,6 @@ run \verb|xindex -c header <file.idx>|
-\section{Case sensitive index entries}
-By default \textsf{foo} and \textsf{Foo} are two different entries and will handled differently
-by \Lprog{xindex}: \textsf{Foo} will be as an own entry \emph{before} \textsf{foo}. Let's see
-a more complex example. In the index the entry \verb|xindex-DIN2.lua| is the first one of
-the \verb|xindex-???| series because uppercase letters are sorted before lowercase letters.
-
-\begin{externalDocument}[
-% grfOptions={width=\dimexpr\linewidth-2\fboxsep-2\fboxrule},
- mpwidth=0.55\linewidth,
- pages={2},
- frame=false,
- compiler=lualatex --shell-escape,
- crop,
- xindex,
-% xindexOptions=,
- force=true,
- runs=2,code,docType=latex,
- showFilename,
- align=\centering,
- lstOptions={columns=fixed}]{xindex}
-%! lualatex --shell-escape
-\documentclass{scrartcl}
-\usepackage{libertinus-otf}
-\makeatletter
-\def\theindex{% only for demonstration
- \section*{\indexname}
- \parskip\z@ \@plus .3\p@\relax \parindent\z@
- \let\item\@idxitem}
-\makeatother
-\begin{filecontents}[force,noheader]{\jobname.idx}
-\indexentry{xindex package@\texttt {xindex} package|hyperpage}{2}
-\indexentry{xindex program@\texttt {xindex} program|hyperpage}{4}
-\indexentry{xindex-cfg.lua file@\texttt {xindex-cfg.lua} file|hyperpage}{6}
-\indexentry{xindex-newfile.lua file@\texttt {xindex-newfile.lua} file|hyperpage}{6}
-\indexentry{xindex-DIN2.lua file@\texttt {xindex-DIN2.lua} file|hyperpage}{6}
-\indexentry{xindex-cfg-common.cfg file@\texttt {xindex-cfg-common.cfg} file|hyperpage}{9}
-\indexentry{xindex-cfg.lua file@\texttt {xindex-cfg.lua} file|hyperpage}{10}
-\indexentry{xindex-HAdW-eKO.lua file@\texttt {xindex-HAdW-eKO.lua} file|hyperpage}{10}
-\indexentry{xindex-dtk.lua file@\texttt {xindex-dtk.lua} file|hyperpage}{12}
-\indexentry{xindex program@\texttt {xindex} program|hyperpage}{13}
-\indexentry{xindex program@\texttt {xindex} program|hyperpage}{14}
-\indexentry{xindex-cfg-common.lua file@\texttt {xindex-cfg-common.lua} file|hyperpage}{14}
-\indexentry{xindex package@\texttt {xindex} package|hyperpage}{15}
-\end{filecontents}
-%StartVisiblePreamble
-\usepackage{makeidx}
-\usepackage{hyperref}
-%StopVisiblePreamble
-\pagestyle{empty}
-\begin{document}
-foo\newpage
-\printindex
-\end{document}
-\end{externalDocument}
-
-
-The same example sorted with the \verb|-a| or \verb|--nocasesensitive| has another output: now
-\verb|xindex-cfg-common.lua| is the first one of the \verb|xindex-???| series.
-
-
-\begin{externalDocument}[
-% grfOptions={width=\dimexpr\linewidth-2\fboxsep-2\fboxrule},
- mpwidth=0.55\linewidth,
- pages={2},
- frame=false,
- compiler=lualatex --shell-escape,
- crop,
- xindex,
- xindexOptions=-a,
- force=true,
- runs=2,code,docType=latex,
- showFilename,
- align=\centering,
- lstOptions={columns=fixed}]{xindex}
-%! lualatex --shell-escape
-\documentclass{scrartcl}
-\usepackage{libertinus-otf}
-\makeatletter
-\def\theindex{% only for demonstration
- \section*{\indexname}
- \parskip\z@ \@plus .3\p@\relax \parindent\z@
- \let\item\@idxitem}
-\makeatother
-\begin{filecontents}[force,noheader]{\jobname.idx}
-\indexentry{xindex package@\texttt {xindex} package|hyperpage}{2}
-\indexentry{xindex program@\texttt {xindex} program|hyperpage}{4}
-\indexentry{xindex-cfg.lua file@\texttt {xindex-cfg.lua} file|hyperpage}{6}
-\indexentry{xindex-newfile.lua file@\texttt {xindex-newfile.lua} file|hyperpage}{6}
-\indexentry{xindex-DIN2.lua file@\texttt {xindex-DIN2.lua} file|hyperpage}{6}
-\indexentry{xindex-cfg-common.cfg file@\texttt {xindex-cfg-common.cfg} file|hyperpage}{9}
-\indexentry{xindex-cfg.lua file@\texttt {xindex-cfg.lua} file|hyperpage}{10}
-\indexentry{xindex-HAdW-eKO.lua file@\texttt {xindex-HAdW-eKO.lua} file|hyperpage}{10}
-\indexentry{xindex-dtk.lua file@\texttt {xindex-dtk.lua} file|hyperpage}{12}
-\indexentry{xindex program@\texttt {xindex} program|hyperpage}{13}
-\indexentry{xindex program@\texttt {xindex} program|hyperpage}{14}
-\indexentry{xindex-cfg-common.lua file@\texttt {xindex-cfg-common.lua} file|hyperpage}{14}
-\indexentry{xindex package@\texttt {xindex} package|hyperpage}{15}
-\end{filecontents}
-%StartVisiblePreamble
-\usepackage{makeidx}
-\usepackage{hyperref}
-%StopVisiblePreamble
-\pagestyle{empty}
-\begin{document}
-foo\newpage
-\printindex
-\end{document}
-\end{externalDocument}
-
-
\section{Automatic index creation}