Truedoc

Come ottenere una versione stampabile¶

In questo momento, a parte alcuni testi di appunti presenti nella radice, insieme al file di inclusione di tutta la documentazione (adminbook.tex) la documentazione è suddivisa in varie directory:

Per ottenere una versione stampabile dei vari testi occorre andare nella rispettiva directory ed utilizzare LaTeX per compilare il testo relativo. I comandi utilizzabili sono due: lualatex per generare direttamente un PDF, e latex per generare un file DVI che poi può essere convertito in vari altri formati (non verificato). Nel nostro caso tratteremo solo la generazione del PDF.

Ciascuno di questi comandi deve prendere come argomento il file che per ciascuna directory contiene il testo iniziale (quello indicato nella seconda colonna della precedente tabella) che include le eventuali altri parti che costituiscono il testo.

Il primo passo da eseguire è quello di creare le figure utilizzate nel formato opportuno, per questo si può utilizzare il comando make che provvede ad eseguire quanto necessario, ad esempio per generare le figure per le dispense di amministrazione si esegua:

cd dovelhomesso/truedoc/
make
for i in mailservices sicurezza webservices; do
    cd $i
    make
    cd ..
done
cd agl
make

La prima volta che si eseguono questi comandi verranno create anche le versioni stampabili dei relativi testi, per AGL che include parte degli altri testi è necessario eseguire la compilazione dopo aver fatto le altre, altrimenti potrebbero mancare alcune immagini.

Le figure sono state realizzate con dia ed in qualche caso con inkscape (e tali programmi sono necessari per generarne la versione PDF), o sono degli screenshot in formato PNG o PDF. Oltre a dia e inkscape i programmi utilizzati da make per la generazione sono epstopdf, eps2eps, pngtopnm, pnmtops, che dono essere installati. Per tutto ciò è necessario installare i seguenti pacchetti:

apt-get install git dia inkscape make epstool netpbm texlive-base  \
    texlive-latex-extra texlive-bibtex-extra texlive-fonts-extra texlive-pstricks \
    texlive-latex-extra-doc fonts-inconsolata texlive-lang-italian texlive-luatex \
    fonts-lmodern lmodern latexml

In generale, a meno di non aver scaricato un aggiornamento con nuove figure, occorre eseguire make solo la prima volta, questo si incaricherà di creare tutti file nei vari formati necessari. In genere questo consente di creare le immagini nei formati usati da latex. Si tenga presente che siccome la compilazione del testo di amministrazione utilizza delle sezioni presenti in altri testi, è opportuno, prima di compilare il relativo testo, eseguire il lancio di make in tutte le sezioni (sicurezza, webservices, mailservices).

Se si vuole ottenere la bibliografia e gli indici è necessario, dopo una prima compilazione con lualatex, utilizzare i programmi makeindex e bibtex per creare i file necessari. Occorre poi richiamare lualatex due volte. La procedura completa per generare il PDF (nel caso di Amministrare GNU/Linux) è allora la seguente:

lualatex agl.tex
makeindex agl
bibtex agl
lualatex agl.tex
lualatex agl.tex