Provided by: manpages-it_3.73-2_all 
NOME
linuxdoc - LinuxDoc DTD SGML convertitore ad altri formati di uscita
SINTASSI
linuxdoc --backend=formato
--papersize=size --language=lang --charset=char --style=file --debug --define attributo=valore
--include entity [opzioni-backend...] file(.sgml)
o (Uso vechio, obsoleto)
sgmlxxxx [opzioni-generiche...] [opzioni-backend...] file(.sgml)
DESCRIZIONE
La suite linuxdoc e` una collezione di formatatori di testo che comprendono un file sorgente SGML di
LinuxDoc DTD. Ogni formattatore (o "back-end") converte il file sorgente in una varieta` di formati di
uscita, includendo HTML, TeX, DVI, PostScript, testo semplice, e il sorgente groff(1) nel formato delle
pagine di manuale. La suite linuxdoc e` fornita di retro compatibilita`, dato che ci sono ancora molti
documenti utili scritti in sorgente sgml di LinuxDoc DTD.
Il liguaggio di macatuta accettato da questi formattatori e` descritto nella Linuxdoc-ToolsGuida
dell'Utente. Ci sono delle varianti di una document type definition SGML sviluppate originariamente da
Matt Welsh per la documentazione di Linux.
OPZIONI-GENERICHE
La maggior parte delle opzioni da riga di comando sono accettate da tutti i back-end. Alcuni back-end
hanno opzioni specifiche per controllare la loro resa al proprio particolare formato di uscita. Queste
sono le opzioni piu` comuni:
--backend=formato, -B
Imposta il back-end per un formato specifico. Il formato predefinito e` nessuno dei formati
attuali, ma solo l'uscita dell'uso di questa suites. I formati disponibili sono: html, info,
latex, lyx, rtf, txt, check.
--papersize=size, -p
Imposta le dimensioni della pagina. Il formato prdefinito e` ``a4'' (pagina Europea 297x210mm). Si
puo` specificare amche il formato ``letter''.
--language=lang, -l
Specifica la lingua del documento (questo puo` cambiare dipendentemente da quale file di stile e`
usato da un back-end per la formattazione). La lingua predefinita e` l'Inglese. Per vedere la
lista dei codici di lingua validi eseguire un comando LinuxDoc-tools senza argomenti.
--charset=chars, -c
Specifica la codifica del carattere di uscita. La codifica predefinita a ``ascii'' seleziona il
set di caratteri ASCII; si puo` specificare "latin" per specificare il set di caratteri ISO 8859-1
(Latin-1). Inoltre, ``nippon'' e ``euc-kr'' sono richiesti per gestire le rispettive codifiche
euc-jp e euc-kr del file sgml.
--style=file, -S
Include un DTD (Document Type Definition) ausiliario da /usr/share/linuxdoc-tools/dtd.
--tabsize=n, -t
Imposta gli spazi di tabulazione (tab) assunti per la generazione del documento di uscita. Il
valore perdefinito degli spazi di tabulazione e` 8.
--debug, -d
Non elimina i file intermedi (come i file .TeX generati sul passaggio a un .dvi, o i file .man
eliminati sul passaggio al testo semplice).
--define, -D
Passa la coppia attributo/valore per essere corrisposta su i condizionali "if" e "unless". Vedere
la Guida dell'Utente per una discussione estesa di di questa caratteristica. Questa
condizionalizzazione e` gestita dal comando sgmlpre. Vedere la pagina di manuale di sgmlpre(1)
cosi` come la Guida dell'Utente.
--include, -i
Passa una opzione -i al comando nsgmls(1). Questo puo` essere usato per l'inclusione di
condizionali. Vedere la pagina di manuale di nsgmls(1) per i dettagli.
--pass, -P
Passa una stringa di opzioni al back-end. L'esatta semantica di queste opzioni e` dipendente dal
back-end e dovrebbe essere spiegata nella pagina di manuale relativa a ogni back-end.
file Il file sorgente SGML, chiamato file o file.sgml.
L'esecuzione di un back-end senza alcun argomento produrra` una lista di tutte le sue opzioni (Il
messaggio di errore riguardo a "no filenames given" in questo caso puo` essere sicuramente ignorato). I
back-end disponibili includono (i nomi tra parentesi sono la forma vecchia & osoleta):
linuxdoc -B html (sgml2html)
traduce in HTML
linuxdoc -B info (sgml2info)
traduce in GNU info
linuxdoc -B lyx (sgml2lyx)
traduce in macro di Lyx
linuxdoc -B latex (sgml2latex)
traduce in LaTeX 2e
linuxdoc -B rtf (sgml2rtf)
traduce in Microsoft Rich Text Format
linuxdoc -B txt (sgml2txt)
traduce in testo semplice o nel markup delle pagine di manuale Unix
C'e` anche linuxdoc-Bcheck
(sgmlcheck) uno strumento disponibile per verificare la sintassi LinuxDoc DTD SGML dei documenti
sorgenti attualmente senza generare una versione tradotta.
DRIVER DI BACKEND
Di seguito c'e` la descrizione per ogni driver di backend:
****************************************************
linuxdoc -B html (sgml2html) converte un file sorgente SGML di LinuxDoc DTD in file HTML di uscita.
L'uscita apparirà nel file di livello piu` alto file.html e file-n.html per ogni sezione (azione
predefinita, ma puo` essere cambiata con un'opzione), dove file e` il nome del file sorgente SGML e n e`
il nome della sezione.
La coppia attributo/valore "output=html" e` impostata per i condizionali.
linuxdoc -B html accetta le seguenti opzioni: [--split 0|1|2 ] [--dosnames] [--imagebuttons] [--toc 0|1|2
]
Il significato di queste opzioni e`:
--split, -s
A quale livello dividere i documenti sorgenti. 0 = non dividere, 1 = dividere attraverso le
sezioni principali, 2 = dividere attraverso le sottosezioni.
--toc, -T
A quale livello generare la toc (table of contents).
0 = non generare la toc,
1 = include le sezioni principali(/capitoli/parti),
2 = include le sottosezioni.
--dosnames, -h
Usa ".htm" invece di ".html" come estensione dei file
--imagebuttons, -I
Usa le icone delle immagini "next" (successivo), "previous" (precedente), e "contents" (contenuti)
incluse nella directory /usr/share/linuxdoc-tools come pulsanti di navigazione.
--footer, -F
Usa il file specificato come il footer in ogni file html ottenuto. Il footer predefinito e` solo
il semplice
</BODY>\n </HTML>\n
--header, -H
Usa il file specificato come la parte piu` alta dell'intestazione in ogni file html ottenuto.
Notare che questo non e` la parte completa dell'intestazione. (per esempio, il titolo e i links
(next,previous,contents) non sono tenuti nell'intestazione predefinita. L'intestazione predefinita
e`
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">\n
<HTML>\n <HEAD>\n
****************************************************
linuxdoc -B info (sgml2info) converte un file sorgente SGML di LinuxDoc DTD al formato info GNU.
L'uscita apparira` nel file.info dove file e` il nome del file sorgente SGML.
La coppia attributo/valore "output=info" e` impostata per i condizionali.
linuxdoc -B info non ha opzioni specifiche di backend.
****************************************************
linuxdoc -B latex (sgml2latex) converte un file sorgente SGML di LinuxDoc DTD in un file di uscita
LaTeX, usando l'analizzatore nsgmls(1) o onsgmls(1), e il traduttore sgmlsasp(1). Usando l'uscita LaTeX,
e il formattatore di testo latex(1), si puo` creare un'uscita DVI, e un'uscita PostScript usando il
convertitore dvips(1). L'uscita apparira` nel file.tex per l'uscita LaTeX, file.dvi per l'uscita DVI, o
file.ps per l'uscita PostScript, dove file e` il nome del file sorgente SGML.
Usando l'uscita LaTeX, e il formattatore di testo pdflatex(1), poi si puo` creare un file di uscita PDF
piacevole, adatto per essere visualizzato con visualizzatori di PDF come xpdf(1), acroread(1) o
ghostview(1).
La coppia attributo/valore "output=latex2e" e` impostata per i condizionali.
linuxdoc -B latex accetta le seguenti opzioni specifiche di backend: [--output=tex|dvi|ps|pdf] [--bibtex]
[--makeindex] [--pagenumber=n] --quick [--latex=latex|hlatexp|platex|jlatex] [--dvips=dvips|dvi2ps]
Il significato di queste opzioni e`:
--output=fmt, -o
Specifica il formato di uscita voluto. Il formato specificato fmt puo` essere ``tex'', ``dvi'',
``ps'', o ``pdf''.
Nota: Questa versione non sovrascrive/rimuove i file intermedi: il file per l'uscita dvi, o i file per
l'uscita ps. Questo comportamento e` differente dall'SGML-Tools 1.0.9 originale, cosi` si e` avvertiti.
--bibtex, -b
Elabora il file TeX generato con bibtex(1).
--makeindex, -m
Genera un file index TeX adatto per l'elaborazione con makeindex(1) dai tag <idx> e <cdx> presenti
nel sorgente SGML.
--pagenumber, -n
Imposta il numero della pagina iniziale nel file di uscita DVI o PS.
--quick, -q
Fa solamente un passaggio della formattazione. Spesso questo non e` sufficiente per produrre
un'uscita finale (dovuta ai riferimenti, ecc.) ma e` utile per mostrare gli errori di TeX e i
problemi di giustificazione.
--pass, -P
L'argomento dell'opzione pass e` inserito subito dopo il preambolo di LaTeX generato dal tag del
tipo di documento. Specifica il formato di uscita voluto. Il formato specificato fmt puo` essere
``tex'', ``dvi'', ``ps'', o ``pdf''.
--latex=comando_latex_alternativo, -x
Questa opzione correntemente e` per il coreano e il giapponese. Il comando_latex_alternativo puo`
essere ``latex'' (predefinito), ``hlatexp'' (per il coreano), ``platex'' o ``jlatex'' (per il
giapponese). Questa opzione puo` essere usata per ottenere un documento coreano usando HLaTeXp, o
per ottenere un documento giapponese usando pLaTeX/jLaTeX. Altrimenti, HLaTeX dovrebbe essere
installato per ottenere un documento coreano. In altre parole, un documento giapponese puo`
essere ottenuto con jLaTeX
(che e` il predefinito quando e` specificato ``-c nippon''), cosi` se si ha gia` installato
jLaTeX, non e` necessario installare pLaTeX.
--dvips=comando_dvips_alternativo, -s
Questa opzione e` correntemente per il giapponese. Il comando_dvips_alternativo puo` essere
``dvips'' o ``dvi2ps''. Se non si conosce questo, allora questo non e' necessario.
****************************************************
linuxdoc -B lyx (sgml2lyx) converte un file sorgente SGML di LinuxDoc DTD a un file di uscita LyX.
L'uscita apparira` nel file.lyx dove file e` il nome del file sorgente SGML.
La coppia attributo/valore "output=lyx" e` impostata per i condizionali.
linuxdoc -B lyx non ha opzioni specifiche di backend.
****************************************************
linuxdoc -B rtf (sgml2rtf) converte un file sorgente SGML di LinuxDoc DTD a RTF, il Rich Text Format
usato dal sistema di aiuto di Microsoft Windows. L'uscita apparira` nel file di piu` alto livello
file.rtf e file-n.rtf per ogni sezione, dove file e` il nome del file sorgente SGML. L'uscita RTF e`
adatta alla compilazione con il Compilatore dell'Help di Windows Help (hc31.exe).
La coppia attributo/valore "output=rtf" e` impostata per i condizionali.
linuxdoc -B rtf accetta [--twosplit] come un'opzione specifica di backend. Il significato di questa
opzione e` il seguente:
--twosplit, -2
Divide i file sia a n. seczioni che a n.m. sottosezioni
****************************************************
linuxdoc -B txt (sgml2txt) converte un file sorgente SGML di LinuxDoc DTD a file di uscita ASCII,
ISO-8859-1, o EUC-JP. L'uscita apparira` nel file.txt dove file e` il nome del file sorgente SGML.
La coppia attributo/valore "output=txt" e` impostata per i condizionali.
linuxdoc -B txt accetta le seguenti opzioni di backend: [--manpage] [--filter] [--blanks=n]
Il significato di queste opzioni e`:
--manpage, -m
Produce in uscita un file sorgente di groff, adatto per la formattazione con groff -man per le
pagine di manuale
--filter, -f
Rimuove gli backspace-overstrikes dai file intermediari generati da groff(1).
--pass, -P
L'argomento dell'opzione pass e` aggiunto alle opzioni della riga di comando gestite da groff(1).
--blanks=n, -b
Imposta il limite delle linee bianche consecutive per la generazione del documento di uscita. Il
limite predefinito e` 3. Se e` specificato 0 (zero), il risultato avra` molte linee bianche
consecutive.
****************************************************
linuxdoc -B check (sgmlcheck) esegue un analizzatore SGML sul documento sorgente specificato. Ogni
errore e` riportato sullo standard output. Nessuna versione formattata del sorgente e` prodotta.
Notare che linuxdoc -B check pre-elabora il sorgente SGML di LinuxDoc DTD, facendo la
condizionalizzazione descritta da ogni tag <#if></#if> e <#unless></#unless>. I documenti sorgenti che
contengono questi tag confonderanno un analizzatore SGML standalone. linuxdoc -B check non ha opzioni
specifiche di backend.
****************************************************
FILE
Sono usati molti file ed eseguibili nelle directory /usr/share/linuxdoc-tools e /usr/bin.
BUG
Potrebbe essercene qualcuno. Ci si senta liberi di inviare il proprio report al corrente manutentore.
MANUTENTORE
Questa pagina di manuale e` stata mantenuta da Cees de Groot <cg@cdegroot.com> in SGML-Tools (v1). Attualmente e` mantenuta da Taketoshi Sano <sano@debian.org> per Linuxdoc-Tools. Traduzione ed adattamenti a cura di Hugh Hartmann <hhartmann@libero.it>. Revisione a cura di Beatrice Torracca <beatricet@libero.it>. 27 Jul 2000 LINUXDOC(1)