add an index

robitex · robitex · commit d36063354f2d · 2021-04-16T19:00:38.000+02:00
diff --git a/.gitignore b/.gitignore
@@ -19,4 +19,8 @@ tmp.lua
 guidalua.bbl
 guidalua.bcf
 guidalua.blg
-guidalua.run.xml
+guidalua.run.xml
+# index ausiliary files
+*.idx
+*.ilg
+*.ind
diff --git a/app-reg/01.tex b/app-reg/01.tex
@@ -1,5 +1,5 @@
 % !TeX program = LuaTeX
-% filename: app-registro/01.tex
+% filename: app-reg/01.tex
 \directlua{
 register = {}
 function register.append(filename, line)
diff --git a/app-reg/02.tex b/app-reg/02.tex
@@ -1,5 +1,5 @@
 % !TeX program = LuaTeX
-% filename: app-registro/02.tex
+% filename: app-reg/02.tex
 \directlua{
 register = {
     start = os.clock(),
diff --git a/app-reg/03.tex b/app-reg/03.tex
@@ -1,5 +1,5 @@
 % !TeX program = LuaTeX
-% filename: app-registro/03.tex
+% filename: app-reg/03.tex
 \directlua{register = require "mod-history"}
 
 Testo
diff --git a/app-reg/doc.tex b/app-reg/doc.tex
@@ -1,5 +1,5 @@
 % !TeX program = LuaLaTeX
-% filename: app-registro/doc.tex
+% filename: app-reg/doc.tex
 \documentclass{article}
 \usepackage{fontspec}
 \setmainfont{Libertinus Serif}
diff --git a/app-reg/doc2.tex b/app-reg/doc2.tex
@@ -1,5 +1,5 @@
 % !TeX program = LuaLaTeX
-% filename: app-registro/doc2.tex
+% filename: app-reg/doc2.tex
 \documentclass{article}
 \usepackage{fontspec}
 \setmainfont{Libertinus Serif}
diff --git a/app-reg/historylog.sty b/app-reg/historylog.sty
@@ -1,4 +1,4 @@
-% filename: app-registro/historylog.sty
+% filename: app-reg/historylog.sty
 \NeedsTeXFormat{LaTeX2e}[2000/06/01]
 \ProvidesPackage{historylog}[2020/06/07 Compile task logger]
 % load the Lua module
diff --git a/app-reg/lib-logger.lua b/app-reg/lib-logger.lua
@@ -1,4 +1,4 @@
--- filename: app-registro/lib-logger.lua
+-- filename: app-reg/lib-logger.lua
 
 local register = {
     _iArchive = {},
diff --git a/app-reg/logger.sty b/app-reg/logger.sty
@@ -1,4 +1,4 @@
-% filename: app-registro/logger.sty
+% filename: app-reg/logger.sty
 \NeedsTeXFormat{LaTeX2e}[2000/06/01]
 \ProvidesPackage{logger}[2021/04/12 Compile task logger]
 % load the Lua module
diff --git a/app-reg/mod-history.lua b/app-reg/mod-history.lua
@@ -1,4 +1,4 @@
--- filename: app-registro/mod-history.lua
+-- filename: app-reg/mod-history.lua
 local register = {
     start = os.clock(),
     sep = ", ",
diff --git a/guidalua.tex b/guidalua.tex
@@ -18,6 +18,9 @@
 \usepackage[backend=biber,style=alphabetic]{biblatex}
 \addbibresource{guidalua.bib}
 
+%\indexsetup{noclearpage,level=\section*,toclevel=section}
+\makeindex[options={-s guidatematica.ist},title=Indice Analitico]
+
 \fvset{
     fontsize=\small,
     numbers=left,
@@ -214,5 +217,10 @@ \part{Applicazioni Lua in \LuaTeX}
 
 % bibliografia
 \input{section/Z-90-biblio.tex}
+
+% indexes
+\printindex
+%\printindex[lua]
+
 \end{document}
 
diff --git a/guidatematica.ist b/guidatematica.ist
@@ -0,0 +1,10 @@
+headings_flag 1
+heading_prefix   "\\section*{"
+heading_suffix   "}"
+symhead_positive "Simboli"
+symhead_negative "simboli"
+numhead_positive "Numeri"
+numhead_negative "numeri"
+delim_0 ",\~"
+delim_1 ",\~"
+delim_2 ",\~"
diff --git a/guidatematicafiles.ist b/guidatematicafiles.ist
@@ -0,0 +1,8 @@
+headings_flag 1
+heading_prefix   "\\section*{"
+heading_suffix   "}"
+symhead_positive "Estensioni"
+symhead_negative "estensioni"
+numhead_positive "Numeri"
+numhead_negative "numeri"
+delim_0 ",\~"
diff --git a/section/0-01-intro.tex b/section/0-01-intro.tex
@@ -69,9 +69,9 @@ \section{Contribuire e collaborare}
 
 \section{Altre risorse}
 
-La risorsa principale per imparare Lua, a cui si rimanda per tutti gli
-approfondimenti, è certamente il PIL \cite{PIL} acronimo del titolo del libro
-\emph{Programming In Lua} di Roberto Ierusalimschy, principale Autore di Lua.
+La risorsa principale per imparare Lua, a cui rimando per tutti gli
+approfondimenti, è certamente il PIL \cite{PIL}, acronimo del titolo del libro
+\emph{Programming In Lua} di Roberto Ierusalimschy il principale Autore di Lua.
 Questo testo non solo è completo e autorevole ma è anche ben scritto e
 composto\footnote{Tra l'altro il libro ufficiale su Lua viene composto in
 \LaTeX{} e commercializzato per contribuire allo sviluppo del linguaggio
@@ -80,7 +80,7 @@ \section{Altre risorse}
 La seconda importante risorsa su Lua si trova in rete all'indirizzo
 \href{https://www.lua.org/manual/5.3/}{\texttt{www.lua.org/manual/5.3/}} ed è il
 \emph{reference} del linguaggio \cite{web:luaref} con le specifiche di sintassi,
-metametodi, funzioni di libreria, C API eccetera.
+metametodi, funzioni di libreria, C API, eccetera.
 
 Quanto a \LuaTeX{} il riferimento è il suo manuale \cite{prg:luatex} che, come
 quasi tutta la documentazione nel sistema \TeX{}, può essere visualizzato a
@@ -117,7 +117,7 @@ \section{Note di lettura}
 efficienti, più accurati, più completi di riscriverne il codice.
 
 Auguro buona e proficua lettura nell'esplorare l'avampost%
-\begin{tikzpicture}[scale=0.0375]
+\begin{tikzpicture}[scale=0.0378]
 \guidalualogocmd
 \end{tikzpicture} lunare.
 
diff --git a/section/I-02-tab.tex b/section/I-02-tab.tex
@@ -502,7 +502,7 @@ \subsection{Composizione finale}
 \end{tabular}
 \end{lines}
 
-Il progetto completato si trova nel file \file{app-star/E0-006-tab.tex}, dove ho
+Il progetto completato si trova nel file \file{app-start/E0-006-tab.tex}, dove ho
 aggiunto alla tabella la colonna con il calcolo della superficie laterale delle
 barre.
 
diff --git a/section/III-01-registro.tex b/section/III-01-registro.tex
@@ -44,7 +44,7 @@ \section{Scrivere sul registro}
 
 La funzione \fn{append} può essere provata in un sorgente plain \LuaTeX{}
 compilabile come in questo:
-\sourcecode{file = [[app-registro/01.tex]]}
+\sourcecode{file = [[app-reg/01.tex]]}
 
 
 \section{Dati di compilazione}
@@ -66,7 +66,7 @@ \section{Dati di compilazione}
 del termine del sorgente. Come prima istruzione invece, inseriremo il blocco di
 codice Lua che definirà alcuni parametri come il nome del file del registro e il
 separatore di campo testuale, e la funzione \fn{append}:
-\sourcecode{file = [[app-registro/02.tex]]}
+\sourcecode{file = [[app-reg/02.tex]]}
 
 
 \subsection{La variabile \code{jobname}}
@@ -151,7 +151,7 @@ \section{Creare il modulo e il pacchetto}
 l'accesso alle funzionalità da parte degli utenti indipendentemente dal formato.
 
 Allo stato attuale dello sviluppo del codice, il modulo Lua è il seguente:
-\sourcecode{file = [[app-registro/mod-history.lua]]}
+\sourcecode{file = [[app-reg/mod-history.lua]]}
 
 Tutte le funzionalità sono incluse in un unica tabella Lua chiamata
 \code{register}. Dall'esterno, caricando il modulo con la funzione \fn{require}
@@ -165,7 +165,7 @@ \section{Creare il modulo e il pacchetto}
 incremento delle prestazioni per includere il riferimento alla tabella stessa.
 
 Il sorgente in plain \LuaTeX{} si semplifica in questo:
-\sourcecode{file = [[app-registro/03.tex]]}
+\sourcecode{file = [[app-reg/03.tex]]}
 
 Per compilarlo correttamente il file Lua del modulo chiamato
 \code{mod-history.lua} deve essere nel percorso di ricerca. La soluzione più
@@ -174,12 +174,12 @@ \section{Creare il modulo e il pacchetto}
 A questo punto è facile creare un pacchetto per \LaTeX{}. Non ci sarà alcuna
 macro utente ma un aggiunta al codice di chiusura del documento con la macro
 \cs{AtEndDocument}. Ecco il codice:
-\sourcecode{file = [[app-registro/historylog.sty]]}
+\sourcecode{file = [[app-reg/historylog.sty]]}
 
 Basta caricare il pacchetto e tutte le compilazioni del sorgente verranno
 registrate come per questo file sorgente per Lua\LaTeX{}. Compilatelo più volte
 e controllate poi il file locale \file{history.log}:
-\sourcecode{file = [[app-registro/doc.tex]]}
+\sourcecode{file = [[app-reg/doc.tex]]}
 
 Il file di registro conterrà informazioni simili a queste:
 \begin{Verbatim}[numbers=none,xleftmargin=0pt]
@@ -195,19 +195,16 @@ \section{Sviluppo}
 informazioni sulle compilazioni dei sorgenti. Le funzionalità sono minime ma si
 tratta di un buon punto di partenza per dare risposta a nuove domande: quale
 struttura dovremo dare al modulo in modo che sia semplice aggiungere nuove
-funzionalità, come permettere all'utente di modificare le informazioni
-registrabili.
+funzionalità o modificare la lista delle informazioni registrabili.
 
 A poco a poco prende forma e si precisa la struttura di un \emph{framework}
-grazie all'attività di progettazione del software a passi successivi. Ciò che
-era molto meno evidente con lo sviluppo dei pacchetti \LaTeX{} è invece chiaro
-con i moduli Lua: la necessità di ricercare soluzioni convenienti ai problemi di
-organizzazione del codice.
+grazie all'attività di progettazione in passi successivi. Ciò che era molto meno
+evidente con lo sviluppo dei pacchetti \LaTeX{} è invece chiaro con i moduli
+Lua: la necessità di ricercare soluzioni con l'organizzazione del codice.
 
 
 \subsection{Dati per descrivere dati}
 
-
 Nel registro ogni linea contiene informazioni ma nel codice non ne esiste una
 rappresentazione di alto livello, un oggetto che si possa aggiungere o
 eliminare, o stampare in un diverso formato.
@@ -223,8 +220,7 @@ \subsection{Dati per descrivere dati}
 \end{compactitemize}
 
 Il costruttore di tabelle è una struttura in grado di rappresentare ogni tipo di
-dato e la seguente è la diretta descrizione dei componenti di questo tipo di
-dato:
+dato e la seguente è la diretta descrizione dei componenti di \code{Info}:
 \begin{lines}
 {
     id = "EngineName",
@@ -280,7 +276,7 @@ \subsection{Nuova implementazione del registro}
 
 Non spiegherò tutti i dettagli per non eccedere con la descrizione del codice,
 tratterò solo i punti salienti lasciando libero il lettore di consultare il
-codice completo nel file \file{app-registro/lib\_logger.lua}.
+codice completo nel file \file{app-reg/lib-logger.lua}.
 
 Di base, la possibilità di selezionare l'insieme di informazioni da registrare
 comporta il dover distinguere la lista di oggetti disponbili che chiameremo
@@ -697,7 +693,7 @@ \subsection{Il punto di vista dell'utente}
 l'opportuno codice Lua.
 
 Si possono fare esperimenti scaricando il pacchetto di seconda generazione
-\file{app-registro/logger.sty} e il file di prova \file{app-registro/doc2.tex},
+\file{app-reg/logger.sty} e il file di prova \file{app-reg/doc2.tex},
 secondo le istruzioni della sezione~\ref{secIntroNote}.
 
 Una terza iterazione di sviluppo, potrebbe porsi lo scopo di minimizzare il
diff --git a/section/Z-01-notefinali.tex b/section/Z-01-notefinali.tex
@@ -3,7 +3,7 @@
 \chapter{Note finali}
 
 I miei ringraziamenti vanno a Claudio Beccari per aver scritto la classe
-\class{guidatemaica.cls} con cui è stata composta la guida e per avermi dato
+\class{guidatematica.cls} con cui è stata composta la guida e per avermi dato
 risposte come sempre precise e complete alle mie domande.
 
 Ringrazio Gianluca Pignalberi che mi ha proposto un uso avanzato del pacchetto

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-% filename: app-registro/historylog.sty`
	`1`	`+% filename: app-reg/historylog.sty`
`2`	`2`	`\NeedsTeXFormat{LaTeX2e}[2000/06/01]`
`3`	`3`	`\ProvidesPackage{historylog}[2020/06/07 Compile task logger]`
`4`	`4`	`% load the Lua module`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`--- filename: app-registro/lib-logger.lua`
	`1`	`+-- filename: app-reg/lib-logger.lua`
`2`	`2`
`3`	`3`	`local register = {`
`4`	`4`	`_iArchive = {},`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-% filename: app-registro/logger.sty`
	`1`	`+% filename: app-reg/logger.sty`
`2`	`2`	`\NeedsTeXFormat{LaTeX2e}[2000/06/01]`
`3`	`3`	`\ProvidesPackage{logger}[2021/04/12 Compile task logger]`
`4`	`4`	`% load the Lua module`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`--- filename: app-registro/mod-history.lua`
	`1`	`+-- filename: app-reg/mod-history.lua`
`2`	`2`	`local register = {`
`3`	`3`	`start = os.clock(),`
`4`	`4`	`sep = ", ",`