indici

Debitamente corretto il file seguente funziona come previsto
`% !TEX TS-program = pdflatex
% !TEX encoding = UTF-8 Unicode
\documentclass[11pt,a4paper,twoside]{book}
\usepackage{imakeidx}
\makeindex[name=sogg,title=Indice degli argomenti]
\makeindex[name=nomi,title=Indice dei nomi]

\begin{document}

… bla\index[sogg]{bla} … blablabla\index[nomi]{blablabla} …

\printindex[nomi]
\printindex[sogg]
\end{document}`

Se usi l’opzione [splitindex] la generazione non è automatica e la devi eseguire da terminale con il dando il comando splitindex ma se la togli quell’opzione pdflatex fa tutto da solo,a meno che tu non gli abbia esplictamante vietato di eseguire lo “shell-escape”, Forse non è abilitato con l’installazione di MiKTeX, o forse hai una installazione vecchia, tuttavia oggi, almeno con TeXLive, l’esecuzione del comando makeindex avviente automaticamente in protected mode. Altrimenti da terminale devi dare i debiti comandi makeindex seguito da ciascono dei nomi dei file con estensione .idx.

Io non devo fare niente, perché da me con TeXLive (MacTeX) è abiiitato allo shell escape.

La spiegazione consiste in quello che c’è scritto nella documentazione di imakeidx.

pdflatex (e forse anche xelatex e lualatex) hanno un massimo di 16 canali per leggere e 16 canali per scrivere.

Per gestire i “raw index filex” (i file .idx che contengono i dati da indicizzare, raccolti durante la normale compilazione di un documento) il programma ha bisogno di usare un canale per ciascuno dei file .idx. Ora normalmente il programma usa dei canali di scrittura per i file .aux, .log, .toc,.lof, .lot, .out, eccetera; quindi i canali disponibili non sono in numero illimitato ed sarebbe possibile che durante l’esecuzione il programma emettesse un errore del tipo “No more writing channels available” (ho citato a memoria, perché sono almeno 10 anni che non mi capita di saturare i canali disponibili).

Ecco allora che se si compilano molti indici analitici senza l’opzione splitindex, si impegnano altrettanti canali di scrittura ed è possibile arrivare a richiederne più di 16. Se invece si usa questa opzione, tutti i dati da indicizzare vengono scritti in un unico file .idx, impegnando un solo canale di scrittura; l’eventualità che pdflatex ne abbia già impegnati di suo 16 è remota, ma non è teoricamente impossibile. Ne consegue che scrivendo tutti i dati da indicizzare in un solo file minimizza l’eventualità di saturare i canali di scrittura, ma se il numero è già saturo a causa del programma, non c’è verso di comporre nessun indice analitico.

Con splitindex si impegna un solo canale di scrittura, ma i dati dei vari indici sono mescolati; bisogna separarli in tanti file .idx distinti, ma questo può essere fatto solo esternamente al programma di composizione; mi pareva di ricordare che inizialmente imakeidx fosse in grado di farlo da solo, ed era così, perché era comunque necessario attivare esplicitamente lo shell escape; ma splitindex non fa parte della lista di programmi eseguibili in protected shell escape, mentre ne fa parte makeindex; ne consegue che senza l’opzione splitindex, pdflatex può lanciare makeindex e trasformare i vari file .idx nei file .ind, quelli che \printindex importa per comporre i vari indice. Invece se si è costretti ad usare splitindex o perché gli indici sono tanti, o perché pdflatex ha già usato troppi canali di scrittura (lasciandone troppo pochi per scrivere diversi file .idx), allora o si lancia a mano pdflatex con l’opzione –shell-scape, o si configura l’editor perché lanci pdflatex con quell’opzione, oppure si esegue a mano il programma splitindex.

Quindi quando nella documentazione di imakeinde si dice che si può prendere in considerazione l’uso di splitindex quando ci sono almeno due indici analitici da eseguire, non vuol dire che siccome “si può” allora “si deve”; certo se lo si fa quando non è necessario, bisogna comportarsi come indicato per quando è necessario, cioè bisogna agire a mano o bisogna configurare l’editor in modo adatto per lanciare il programma con l’opzione shell escape che permette l’esecuzione di qualunque programma presente sul calcolatore in modalità non protetta, quindi consente di lanciare anche del malware; ecco perché la sicurezza consiglia di non lasciare permanentemente attiva l’impostazione dei programmi con l’opzione shell escape.

Scusa lo spiegone interminabile, ma purtroppo la cosa non si può spiegare in due parole; nello stesso tempo si tratta di una questione delicata che richiede una certa comprensione di come fnziona il sistema TeX. Per noi vecchi utenti la cosa non è incomprensibile anche senza leggere tanti manuali, perché abbiamo cominciato ad usare il sistema Te quando esisteva solo il DOS; tu che sei giovane forse non hai nemmeno sentito nominare questo sistema operativo, ma era quello che si usava sui prmi PC degli anni ’80, che avevano normalmente 10 MIB di disco fisso e disporne con dischi fissi di 20MiB era un lusso che si potevano permettere solo pochi (in pratica lo stipendi di un anno). Capisci bene che noi eravamo abituati fin dall’inizio ad usare risorse minime, semplicemente ridicole al giorno d’oggi quando un normale telefonino dispone di risorse centinaia di volte maggiori di allora.