Attachment 167714 Details for Bug 240664 – texlive-migration-guide.xml

texlive-migration-guide.xml

texlive-migration-guide.xml (text/plain), 19.01 KB, created by Andrea Menegolo on 2008-10-09 10:07:19 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Andrea Menegolo

Created: 2008-10-09 10:07:19 UTC

Size: 19.01 KB

patch

obsolete

><?xml version="1.0" encoding="UTF-8"?>
><!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
>
>
><guide link="/proj/it/tex/texlive-migration-guide.xml" lang="it">
><title>Guida a TeX Live 2007</title>
>
><author title="Autore">
>  <mail link="aballier@gentoo.org">Alexis Ballier</mail>
></author>
>
><author title="Traduzione">
>  <mail link="menegolo_andrea@yahoo.it">Andrea Menegolo</mail>
></author>
>
><abstract>
>In questa guida si mostra come installare TeX Live 2007 su Gentoo, senza
>tralasciare i passaggi da effettuare nel caso in cui sia giÃ  presente una
>distribuzione TeX nel sistema (come tetex o TeX Live 2005).
></abstract>
>
>
>
><license/>
>
><version>1.2</version>
><date>2008-09-30</date>
>
><chapter id="uninstall">
><title>Disinstallazione di una distribuzione precedentemente installata</title>
><section>
><title>Introduzione</title>
><body>
>
><p>
>In questa sezione si assume che <c>>=app-text/tetex-3</c> sia installato sul
>proprio sistema. Si puÃ² seguire la stessa procedura anche nel caso in cui sia
>installato <c>app-text/texlive-2005</c>. Purtroppo non Ã¨ sufficiente eseguire
>la rimozione dei relativi pacchetti.
></p>
>
></body>
></section>
><section>
><title>Salvataggio della configurazione esistente</title>
><body>
>
><p>
>Se si Ã¨ personalizzata la configurazione di <c>tetex</c> modificando i file
>contenuti in <path>/etc/texmf</path>, Ã¨ necessario salvare il contenuto di tale
>directory:
></p>
>
><pre caption="Salvataggio dei file di configurazione">
>$ <i>cp -rf /etc/texmf ~/tetex-texmf</i>
></pre>
>
></body>
></section>
><section>
><title>Rimozione di tetex</title>
><body>
>
><p>
>Ora si puÃ² disinstallare <c>tetex</c> in tutta sicurezza:
></p>
>
><pre caption="Rimozione di tetex">
># <i>emerge -C tetex</i>
></pre>
>
><p>
>Ã stata segnalata la comparsa di errori durante l'unmerge. CiÃ² potrebbe accadere
>se, nella directory <path>/etc/texmf</path>, sono presenti file di
>configurazione anomali. Per sicurezza e per un'installazione pulita di <c>TeX
>Live</c> si raccomanda di rimuovere il file
><path>/etc/texmf/texmf.d/00texmf.cnf</path>:
></p>
>
><pre caption="Pulizia della directory /etc/texmf">
># <i>rm /etc/texmf/texmf.d/00texmf.cnf</i>
></pre>
>
><note>
>Rimuovendo tale file non si rischia di perdere la configurazione della
>precedente distribuzione TeX poichÃ© tutta la directory Ã¨ stata salvata
>precedentemente.
></note>
>
><p>
>PoichÃ© <c>tetex</c> usa <c>texlinks</c> che il gestore di pacchetti non riesce a
>controllare, la rimozione del pacchetto lascia nel sistema alcuni collegamenti
>simbolici:
></p>
>
><pre caption="Collegamenti simbolici di tetex">
>$ <i>ls -l /usr/bin/pdftex</i>
>lrwxrwxrwx 1 root root 7 2007-07-09 07:34 /usr/bin/pdftex -> pdfetex
></pre>
>
><p>
>Sicuramente pdfetex Ã  stato cancellato con la rimozione di <c>tetex</c>, quindi
>pdftex Ã¨ un collegamento simbolico che punta ad un file inesistente e puÃ² essere
>rimosso senza problemi. Si puÃ² utilizzare il comando <c>find</c> per trovare e
>rimuovere questo e altri collegamenti simbolici in modo interattivo:
></p>
>
><pre caption="Rimozione interattiva dei collegamenti simbolici morti">
># <i>find /usr/bin -type l ! -xtype f ! -xtype d -ok rm -f {} \;</i>
>
>&lt; rm ... /usr/bin/pdflatex &gt; ? y
>&lt; rm ... /usr/bin/amstex &gt; ? y
>&lt; rm ... /usr/bin/pdftex &gt; ? y
>&lt; rm ... /usr/bin/eplain &gt; ? y
>&lt; rm ... /usr/bin/jadetex &gt; ? y
>&lt; rm ... /usr/bin/lambda &gt; ? y
>&lt; rm ... /usr/bin/pdfamstex &gt; ? y
>&lt; rm ... /usr/bin/elatex &gt; ? y
>&lt; rm ... /usr/bin/lamed &gt; ? y
>&lt; rm ... /usr/bin/pdfjadetex &gt; ? y
>&lt; rm ... /usr/bin/latex &gt; ? y
></pre>
>
><p>
>Questi sono i file della distribuzione <c>tetex</c> dell'autore rimasti nel
>sistema successivamente alla rimozione del pacchetto.
></p>
>
><p>
><c>tetex</c>, per generare file per la formattazione, utilizza <c>fmtutil</c>
>che anche in questo caso non puÃ² venire controllato in modo appropriato dal
>gestore di pacchetti. Con <c>TeX Live 2007</c> la maggior parte dei file di
>formattazione vengono scritti durante il processo di compilazione dei pacchetti;
>tali file vengono installati in <path>/var/lib/texmf</path>. Ci si deve quindi
>assicurare che non siano presenti file di formattazione strani in tale
>directory:
></p>
>
><pre caption="Rimozione di file di formattazione strani">
># <i>rm -rf /var/lib/texmf/web2c</i>
></pre>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Installazione di TeX Live 2007</title>
><section>
><body>
>
><p>
>Se sono stati seguiti tutti i passaggi fin qui presentati, l'installazione di
><c>TeX Live 2007</c> risulterÃ  molto semplice.
></p>
>
><pre caption="Installazione di TeX Live 2007">
># <i>emerge texlive</i>
></pre>
>
><p>
>In teoria con questo comando verrÃ  installato tutto senza riscontrare problemi.
>Si potrebbero voler modificare le USE flag di <c>app-text/texlive</c> al fine di
>installare dei pacchetti TeX aggiuntivi, ma questa operazione puÃ² venir
>effettuata anche successivamente; <c>app-text/texlive</c> Ã¨ solo un meta-ebuild
>le cui dipendenze sono influenzate dalle USE flag impostate. Ad ogni USE flag
>corrisponde uno o piÃ¹ pacchetti TeX da cui <c>app-text/texlive</c> dipenderÃ .
></p>
>
><p>
>Ã possibile che si incontrino dei problemi per quanto riguarda dipendenze non
>soddisfatte, errori durante la compilazione, ecc. In questi casi si Ã¨ pregati di
>aprire un bug su <uri>https://bugs.gentoo.org</uri>. A tal proposito Ã¨ utile
>fornire le informazioni relative all'errore riscontrato includendo inoltre come
>allegato l'output di <c>texconfig conf</c> (comando da eseguire con lo stesso
>nome utente che non Ã¨ riuscito a portare a termine l'installazione, al fine di
>conservare le stesse variabili d'ambiente); l'output di questo comando Ã¨ infatti
>richiesto nella maggior parte dei casi.
></p>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Configurazione</title>
><section>
><title>Introduzione</title>
><body>
>
><p>
>Come per <c>tetex-3</c>, <c>TeX Live</c> su <c>Gentoo</c> ha tre distinti file
>di configurazione principali gestiti da <c>texmf-update</c>. Questi file sono
><path>texmf.cnf</path>, <path>fmtutil.cnf</path> e <path>updmap.cfg</path>.
>Risiedono nella directory <path>/etc/texmf/web2c</path>; essi non dovrebbero
>venire modificati direttamente poichÃ© ogni cambiamento verrebbe perso
>all'esecuzione di <c>texmf-update</c>.
></p>
>
></body>
></section>
><section>
><title> texmf.cnf </title>
><body>
>
><p>
>Il file <path>texmf.cnf</path> Ã¨ il principale file di configurazione della
>distribuzione TeX. Esso contiene le definizioni di variabili utilizzate da molti
>programmi.
></p>
>
><p>
>Il file <path>texmf.cnf</path> viene generato concatenando i file contenuti in
><path>/etc/texmf/texmf.d</path>. Per modificare la configurazione dell'ambiente
>TeX, Ã¨ necessario modificare i file contenuti in tale directory. Allo stato
>attuale l'ebuild di <c>Gentoo TeX Live</c> installa sei file i questo percorso:
></p>
>
><pre caption="File installati in texmf.d">
>00header.cnf
>05searchpaths.cnf
>10standardpaths.cnf
>15options.cnf
>20sizes.cnf
>25misc.cnf
></pre>
>
><p>
>Ogni file corrisponde ad una sezione del file (leggermente modificato)
><path>texmf.cnf</path> presente nel DVD di <c>TeX Live 2007</c>.
></p>
>
><p>
>I file <path>00header.cnf</path>, <path>05searchpaths.cnf</path>,
><path>10standardpaths.cnf</path> e <path>25misc.cnf</path> non dovrebbero venire
>modificati. Se si ritiene che le impostazioni predefinite potrebbero essere
>migliorate, si prega di aprire un bug segnalando le migliorie che si vorrebbero
>apportare a tali file.
></p>
>
><warn>
>Gli ebuild di <c>TeX Live</c> non possono tener conto di cambiamenti apportati
>nei percorsi definiti in tali file. Se si apportano dei cambiamenti, assicurarsi
>di sapere cosa si sta facendo.
></warn>
>
><p>
>I file <path>15options.cnf</path> e <path>20sizes.cnf</path> possono venire
>modificati prestando un po' di attenzione. I commenti presenti in questi file
>forniscono una guida per capire il significato di ogni impostazione. Per
>esempio, in <path>20sizes.cnf</path> si puÃ² aumentare la quantitÃ  di memoria
>utilizzata da TeX, utile nel caso in cui si incorra nell'errore <c>TeX capacity
>exceeded, sorry</c> durante la compilazione di un documento molto grosso.
></p>
>
><p>
>Nel caso si vogliano fare delle aggiunte al contenuto di <path>texmf.cnf</path>,
>c'Ã¨ la possibilitÃ  di creare un nuovo file nella directory
><path>/etc/texmf/texmf.d</path>, chiamandolo per esempio
><path>99mieaggiunte.cnf</path>. Ã comunque necessario che il nome del nuovo file
>cominci con un numero maggiore di <c>25</c> al fine di conferirgli una prioritÃ 
>inferiore a quella dei file di configurazione principali.
></p>
>
><p>
>La creazione di un nuovo file in <path>texmf.d</path> Ã¨ prevista anche nel caso
>di pacchetti che prevedono l'aggiunta al file <path>texmf.cnf</path> di qualche
>impostazione:
></p>
>
><pre caption="Codice di esempio per installare un file in texmf.d">
><keyword>insinto</keyword> <const>/etc/texmf/texmf.d</const>
><keyword>doins</keyword> <const>40mieaggiunteatexmf.cnf</const>
></pre>
>
></body>
></section>
><section>
><title>updmap.cfg</title>
><body>
>
><p>
>Il file di configurazione <path>updmap.cfg</path> Ã¨ utilizzato da <c>updmap</c>
>(e <c>updmap-sys</c>), a meno che non sia specificato diversamente. Esso
>fornisce delle informazioni per quanto riguarda le mappe di caratteri da
>utilizzare a seconda del driver di output di TeX che si sta utilizzando.
></p>
>
><p>
>Il file <path>updmap.cfg</path> in <path>/etc/texmf/web2c</path> Ã¨ ottenuto
>concatenando i file nella directory <path>/etc/texmf/updmap.d</path>. Il file di
>iniziale <path>00updmap.cfg</path> installato dal pacchetto
><c>app-text/texlive-core</c> Ã¨ ottenuto eseguendo il comando <c>updmap
>--syncwithtrees</c> sull'albero di <c>texmf</c> presente nel sistema
>(praticamente l'esecuzione di <c>updmap --syncwithtrees</c> viene solo simulata,
>ma questo Ã¨ solo un dettaglio tecnico).
></p>
>
><p>
>PiÃ¹ di un ebuild di <c>TeX Live</c>, al momento dell'installazione di font,
>aggiungeranno dei file in <path>/etc/texmf/updmap.d</path>. Al fine di
>disabilitare qualche mappa di caratteri si possono modificare tali file, ma Ã¨
>preferibile rimuovere i pacchetti coinvolti.
></p>
>
><p>
>Se un pacchetto di terze parti installa una nuova mappa di caratteri, essi
>dovrebbe installare un file in <path>/etc/texmf/updmap.d</path> e lasciare che
>sia <c>texmf-update</c> ad occuparsi del resto.
></p>
>
><warn>
>PuÃ² capitare di vedere <c>updmap-sys --enable Map=mymap.map</c> in qualche
>ebuild o nelle istruzioni di installazione di un pacchetto di terze parti per
>l'installazione di un nuovo font. Mentre tutto sembrerÃ  funzionare
>nell'immediato futuro, tutti i cambiamenti apportati da tale comando vengono
>annullati la prima volta che verrÃ  eseguito <c>texmf-update</c>.
></warn>
>
><p>
>Un modo migliore di installare tali pacchetti Ã¨ quello di creare un file nella
>directory <path>/etc/texmf/updmap.d</path> nel caso di distribuzioni di TeX che
>utilizzano <c>texmf-update</c>:
></p>
>
><pre caption="Abilitare una nuova mappa di caratteri">
><keyword>inherit</keyword> <ident>latex-package</ident>
>...
><stmt>src_install()</stmt> {
>    ...
>    <keyword>if</keyword> <stmt>latex-package_has_tetex_3</stmt>; then
>        <keyword>insinto</keyword> /etc/texmf/updmap.d
>        <keyword>doins</keyword> myfontmapconfig.cfg
>    <keyword>fi</keyword>
>    ...
>}
>...
><stmt>pkg_postinst()</stmt> {
>    <stmt>latex-package_pkg_postinst</stmt>
>    <stmt>latex-package_has_tetex_3</stmt> || updmap-sys --enable Map=mymap.map
>}
>
><stmt>pkg_postrm()</stmt> {
>    <stmt>latex-package_pkg_postinst</stmt>
>    <stmt>latex-package_has_tetex_3</stmt> || updmap-sys --disable Map=mymap.map
>}
></pre>
>
><p>
>I file presenti in <path>/etc/texmf/updmap.d</path> devono rispettare la
>sintassi di <c>updmap</c>:
></p>
>
><pre caption="Frammento di updmap.cfg che spiega la sintassi">
>Ci sono due possibili voci: Map e MixedMap. Entrambi richiedono un argomento: il
>nome del file che contiene la mappa. Le linee di MixedMap ("mixed" significa che
>il file Ã¨ disponibile sia bitmap che vettoriale) non vengono utilizzati da dvips
>se dvipsPreferoutline Ã¨ settato a "false". File Map da disattivare devono essere
>marcati con "#! " (senza le virgolette), e non solo da #.
></pre>
>
></body>
></section>
><section>
><title>fmtutil.cnf</title>
><body>
>
><p>
>Il file <path>fmtutil.cnf</path> contiene le informazioni necessarie per
>costruire  e maneggiare un file di formato.
></p>
>
><p>
><path>fmtutil.cnf</path> Ã¨ ottenuto concatenando i file in
><path>/etc/texmf/fmtutil.d</path>. Vari ebuild di <c>TeX Live</c> installano dei
>file in questa directory. Questi file sono accompagnati dai file di formato
>corrispondenti e dal link simbolico al motore pertinente.
></p>
>
><pre caption="Frammento della pagina di man di fmtutil.cnf(5) che spiega la
>sintassi">
>Il file fmtutil.cnf contiene le informazioni di configurazione per fmtutil(8).
>Ogni linea contiene in nome del formato (per esempio "tex", "latex", "omega"),
>il nome del motore utilizzato per quel formato (per esempio "tex", "etex",
>"omega"), il file che definisce lo schema o "pattern" (per esempio language.dat,
>language.def), e altri argomenti (il nome di qualche file .ini).
>
>I campi sono separati da spazi bianchi e linee intere possono venir commentate
>con "#". Il campo corrispondente al "pattern file" non puÃ² venir usato per
>definire un file che Ã¨ utilizzato durante il processo di costruzione del
>formato. Esso dice a fmtutil quale file usare nel processo di creazione del
>formato e ha degli effetti anche sulle opzioni --showhyphen e --byhyphen. Se il
>formato non definisce come personalizzare il ritorno a capo, puÃ² essere usato un
>"-" per indicare lo stesso.
></pre>
>
><p>
>Ebuild di <c>TeX Live</c> che installano un file in <path>fmtutil.d</path>,
>installano anche il relativo file di formato in
><path>/var/lib/texmf/web2c</path> e creano il collegamento simbolico dal formato
>al motore.
></p>
>
><p>
>Si noti che quando viene installato un file per aggiungere il supporto ad una
>nuova lingua, <c>texmf-update</c> si occupa di aggiungere tale file in
><path>language.dat</path> e di rigenerare i file di formato per aggiungere il
>supporto alla lingua appena installata.
></p>
>
></body>
></section>
><section>
><title>Personalizzare la configurazione</title>
><body>
>
><p>
>Ora che si sa come <c>TeX Live</c> gestisce la configurazione, si dovrebbe
>essere in grado di fare quei cambiamenti che erano presenti nella vecchia
>distribuzione di TeX.
></p>
>
></body>
></section>
></chapter>
>
><chapter>
><title>Errori comuni</title>
><section>
><title>Introduzione</title>
><body>
>
><p>
>In questo capitolo vengono presentati gli errori piÃ¹ comuni in cui si puÃ²
>incappare, con una spiegazione della causa del malfunzionamento.
></p>
>
></body>
></section>
><section>
><title>Il formato era scritto con (pdf)etex</title>
><body>
>
><p>
>A volte durante l'installazione di qualche pacchetto che richiede latex, ci si
>puÃ² trovare di fronte al seguente errore:
></p>
>
><pre caption="Formato scritto con pdfetex">
>---! //var/lib/texmf/web2c/latex.fmt was written by pdfetex
></pre>
>
><p>
>Questo errore Ã¨ dovuto alla presenza nel sistema di alcuni vecchi file di una
>distribuzione di <c>TeX</c> basata su <c>etex</c>. Questo significa che la guida
>non Ã¨ stata seguita scrupolosamente, specialmente per quanto riguarda il
>capitolo <uri link="#uninstall">Disinstallazione di una distribuzione
>precedentemente installata</uri>.
></p>
>
><p>
>Ã possibile risolvere il problema senza dover reinstallare nulla; si eseguano i
>seguenti comandi come utente root:
></p>
>
><pre caption="Rimuovere vecchi formati">
># <i>rm -rf /var/lib/texmf/web2c</i>
># <i>texmf-update</i>
></pre>
>
></body>
></section>
><section>
><title>Directory dei formati non esistente</title>
><body>
>
><p>
>Quando si installa per esempio <c>texlive-latex</c>, si puÃ² incontrare il
>seguente errore:
></p>
>
><pre caption="Directory dei formati non esistente">
>fmtutil: format directory
>`/var/tmp/portage/dev-texlive/texlive-latex-2007/work/texmf-var/web2c' does not exist.
></pre>
>
><p>
>Questo Ã¨ dovuto probabilmente ad una configurazione errata. Si provi ad eseguire
>il seguente comando e verificare se si ottiene lo stesso output:
></p>
>
><pre caption="Valore della variabile TEXMFMAIN">
>$ <i>kpsewhich --var-value=TEXMFMAIN</i>
>/usr/share/texmf
></pre>
>
><p>
>Questo Ã¨ molto importante, perchÃ© <c>fmtutil</c> cerca <c>mktexdir</c> in tale
>directory; se si ottiene un output differente allora <c>fmtutil</c> non troverÃ 
><c>mktexdir</c> e quindi non riuscirÃ  a creare la directory in cui salvare
>temporaneamente i file di formato compilati.
></p>
>
><p>
>Non ci sono comandi veloci per risolvere questo problema; si controllino i file
>di configurazione o la presenza di strani file in
><path>/etc/texmf/texmf.d</path>. La causa potrebbe essere anche la presenza di
>una versione vecchia del file <path>00texmf.cnf</path> che imposta delle
>definizioni errate per il file <path>texmf.cnf</path>. Si faccia riferimento al
>capitolo <uri link="#uninstall">Disinstallazione di una distribuzione
>precedentemente installata</uri>.
></p>
>
></body>
></section>
><section>
><title>file .tex mancante</title>
><body>
>
><p>
>Durante l'installazione di <c>texlive-latex</c> (o qualsiasi altro formato che
>supporti la sillabazione attraverso babel), si puÃ² riscontrare il seguente
>errore:
></p>
>
><pre caption="bghyphen.tex mancante">
>===========================================
>Local configuration file hyphen.cfg used
>===========================================
>
>(/var/tmp/portage/dev-texlive/texlive-latex-2007/work/texmf-dist/tex/generic/ba
>bel/hyphen.cfg (/usr/share/texmf/tex/generic/hyphen/hyphen.tex)
>(/usr/share/texmf/tex/generic/hyphen/ushyphmax.tex)
>(/usr/share/texmf/tex/generic/hyphen/dumyhyph.tex)
>(/usr/share/texmf/tex/generic/hyphen/zerohyph.tex)
>(/usr/share/texmf/tex/generic/hyphen/zerohyph.tex)
>(/usr/share/texmf-dist/tex/generic/xu-hyphen/xu-bahyph.tex
>(/usr/share/texmf/tex/generic/hyphen/bahyph.tex))
>(/usr/share/texmf-dist/tex/generic/xu-hyphen/xu-bghyphen.tex
>! I can't find file `bghyphen.tex'.
>l.10   \input bghyphen.tex
>
>Please type another input file name:
>! Emergency stop.
>l.10   \input bghyphen.tex
>
>No pages of output.
>Transcript written on latex.log.
>Error: `pdftex -ini  -jobname=latex -progname=latex
>-translate-file=cp227.tcx *latex.ini' failed
></pre>
>
><p>
>Si dovrÃ  controllare quale file <path>language.dat</path> viene usato:
></p>
>
><pre caption="Trovare il file language.dat usato">
>$ <i>kpsewhich language.dat</i>
>/usr/share/texmf/tex/generic/config/language.dat
></pre>
>
><p>
>Questo file Ã¨ generato automaticamente da <c>texmf-update</c> ed Ã¨ il risultato
>della concatenazione dei file <path>language.*.dat</path> presenti nella
>directory che contiene <path>language.us</path>. Questa directory dovrebbe
>essere <path>/usr/share/texmf/tex/generic/config/</path>. Si dovrebbe quindi
>controllare che non vi siano altri file del tipo <path>language.*.dat</path> in
>tale directory oltre a quelli installati dai pacchetti del tipo
><c>dev-texlive/texlive-lang*</c>. La presenza di un file in tale directory viene
>interpretato come l'intenzione di abilitare la sillabazione per quella lingua
>specifica; se non sono presenti i file di sillabazione corrispondenti i formati
>che supportano la sillabazione non potranno venir costruiti e quindi si verifica
>un errore.
></p>
>
></body>
></section>
></chapter>
></guide>

Actions: View

Attachments on bug 240664: 167714