[successivo] [precedente] [inizio] [fine] [indice generale] [violazione GPL] [translators] [docinfo] [indice analitico] [volume] [parte]
Spesso ci si trova di fronte alla necessità o all'utilità di trasformare un documento scritto in un certo modo, per esempio in LaTeX, in qualcosa di diverso, per esempio in HTML. In generale, queste cose andrebbero pianificate prima, per decidere lo stile del documento in base alle forme in cui questo deve poi concretizzarsi. Meglio ancora sarebbe l'utilizzo di strumenti appositi, di solito SGML, pensati in anticipo per la produzione di documentazione in formati differenti.
Questo capitolo serve a raccogliere la descrizione di strumenti che possono aiutare a trasformare un documento realizzato con sistemi di composizione tradizionale, pensati principalmente per la stampa su carta, e viceversa.
|
Non ci si possono fare illusioni: gli strumenti di questo tipo non funzionano sempre, ma solo quando le caratteristiche del sorgente lo consentono. |
DLH (1) è uno strumento relativamente semplice per la conversione di sorgenti LaTeX in HTML. La trasformazione avviene con successo solo quando si tratta di un sorgente LaTeX in cui non si usano ambienti matematici e soprattutto non si usano comandi particolarmente sofisticati (ciò inteso dal punto di vista di DLH).
DLH utilizza un insieme personalizzato di stili LaTeX, collocato normalmente nella directory /usr/share/dlh/inputs/dlh/. Si tratta dei soliti article.sty, epsfig.sty e altri, ma il contenuto di questi file è ridotto rispetto a quelli equivalenti di LaTeX. Se nel sorgente LaTeX si utilizzano altri stili particolari occorrerebbe creare un file corrispondente anche in questa directory, cercando di adattarlo a DLH (cosa che potrebbe risultare difficile, dal momento che bisogna ragionare in termini di TeX limitato secondo le possibilità di DLH).
Il programma eseguibile è dlh che accetta l'indicazione di alcune opzioni e in particolare un elenco di file LaTeX:
dlh [opzioni] file_latex...
In corrispondenza dei file indicati come argomento vengono create altrettante directory contenenti una serie di file HTML che rappresentano il risultato della trasformazione (a partire da index.html che normalmente è un collegamento simbolico al primo di questi file).
DLH utilizza una serie di icone per rappresentare i pulsanti per lo scorrimento del documento secondo la sua struttura. I file di queste icone si trovano normalmente nella directory /usr/share/dlh/icons/ e andrebbero copiati nella directory ../icons/, rispetto a quella in cui si trovano i file HTML.
-f | --force
Questa opzione serve a creare tutti i file che compongono il documento, in particolare le immagini. Ciò può creare un rallentamento nel funzionamento di DLH, ma in generale serve a garantire un risultato più sicuro.
-i uri | --icon-dir=uri
Permette di definire esplicitamente la collocazione dei file che rappresentano le icone utilizzate da DLH per rappresentare i pulsanti per lo scorrimento del documento.
$ dlh prova.tex
Crea la directory ./prova/ e al suo interno inserisce una serie di file HTML che riproducono il documento prova.tex. In questo caso, i file HTML fanno uso delle icone che si trovano nella directory ./icons/, relativa al nodo di rete in cui si trovano.
$ dlh -f prova.tex
Come nell'esempio precedente, ma viene forzata la creazione di tutti i file, nel caso ce ne fosse bisogno.
$ dlh -i icone prova.tex
Come nel primo esempio, con la differenza che i file delle icone devono trovarsi nella directory ./prova/icone/.
Help2man (2) è un programma in grado di generare una pagina di manuale a partire dalle informazioni che restituisce un altro programma attraverso le opzioni --help e --version.
Help2man è predisposto principalmente per gestire convenientemente il risultato generato da un programma che segue le convenzioni GNU (ovvero della Free Software Foundation).
help2man [opzioni] programma_eseguibile
Lo schema sintattico permette di vedere che si tratta dell'eseguibile help2man, che oltre alle opzioni eventuali richiede l'indicazione di un programma da avviare con le opzioni --help e --version per ottenere le informazioni necessarie. In modo predefinito, il risultato viene emesso attraverso lo standard output.
-o file | --output=file
Permette di definire il nome del file da generare, evitando così di emettere il risultato attraverso lo standard output.
-s n_sezione | --section=n_sezione
Permette di specificare il numero della sezione della pagina di manuale.
$ help2man ls > ls.1
Genera il file ls.1, contenente la pagina di manuale di ls.
$ help2man -o ls.1 ls
Esattamente come nell'esempio precedente, utilizzando esplicitamente l'opzione -o.
Pstotext (3) è un programma molto semplice per l'estrazione del testo contenuto all'interno di un file PostScript o PDF, per mezzo di Ghostscript.
pstotext [opzioni] file
Tutto il lavoro viene svolto dall'eseguibile pstotext. Il risultato dell'elaborazione viene emesso attraverso lo standard output, a meno che sia stato stabilito diversamente con le opzioni.
-cork
Specifica che il file PostScript utilizza la codifica «cork», ovvero ciò che viene generato da Dvips quando questo converte file DVI generati da TeX con la codifica T1.
-landscape
-landscapeOther
Queste due opzioni indicano che il testo è ruotato a 90 gradi in un senso, oppure nell'altro.
-portrait
In questo caso si intende che il testo scorre come di consueto, su un foglio orientato in modo verticale.
-output file
Consente di indicare il file di testo da generare, senza bisogno di ridirigere lo standard output.
daniele @ swlibero.orgDovrebbe essere possibile fare riferimento a questa pagina anche con il nome trasformazione_in_altri_formati.html
[successivo] [precedente] [inizio] [fine] [indice generale] [violazione GPL] [translators] [docinfo] [indice analitico]