.\" -*- coding: UTF-8 -*- .\" Process this file with .\" groff -man -Tascii linuxdoc.1 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH LINUXDOC 1 "27 luglio 2000" .SH NOME linuxdoc \- LinuxDoc DTD SGML convertitore ad altri formati di uscita .SH SINTASSI \fBlinuxdoc\fP \fB\-\-backend=\fP\fIformato\fP .br \fB\-\-papersize=\fP\fIsize\fP \fB\-\-language=\fP\fIlinguaggio\fP \fB\-\-charset=\fP\fIcarattere\fP \fB\-\-style=\fP\fIfile\fP \fB\-\-debug\fP \fB\-\-define\fP\fI\ attributo=valore\fP \fB\-\-include\fP\fI\ entity\fP \fB[opzione\-backend...]\fP \fIfile(.sgml)\fP .PP o (Uso vechio, obsoleto) .br \fBsgmlxxxx [opzioni\-generiche...] [opzioni\-backend...] \ \ \fP\fIfile(.sgml)\fP .SH DESCRIZIONE La suite \fBlinuxdoc\fP è 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 varietà di formati di uscita, includendo HTML, TeX, DVI, PostScript, testo semplice, e il sorgente \fBgroff\fP(1) nel formato delle pagine di manuale. La suite linuxdoc è fornita di retro compatibilità, dato che ci sono ancora molti documenti utili scritti in sorgente sgml di LinuxDoc DTD. .LP Il liguaggio di macatuta accettato da questi formattatori è descritto nella \fILinuxdoc\-Tools\fP \fIGuida dell'Utente\fP. Ci sono delle varianti di una document type definition SGML sviluppate originariamente da Matt Welsh per la documentazione di Linux. .SH 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 più comuni: .IP "\-\-backend=\fIformato\fP, \-B" Imposta il back\-end per un formato specifico. Il formato predefinito è nessuno dei formati attuali, ma solo l'uscita dell'uso di questa suites. I formati disponibili sono: html, info, latex, lyx, rtf, txt, check. .IP "\-\-papersize=\fIsize\fP, \-p" Imposta le dimensioni della pagina. Il formato prdefinito è \*(lqa4\*(rq (pagina Europea 297x210mm). Si può specificare amche il formato \*(lqletter\*(rq. .IP "\-\-language=\fIlang\fP, \-l" Specifica la lingua del documento (questo può cambiare dipendentemente da quale file di stile è usato da un back\-end per la formattazione). La lingua predefinita è l'Inglese. Per vedere la lista dei codici di lingua validi eseguire un comando LinuxDoc\-tools senza argomenti. .IP "\-\-charset=\fIchars\fP, \-c" Specifica la codifica del carattere di uscita. La codifica predefinita a \*(lqascii\*(rq seleziona il set di caratteri ASCII; si può specificare "latin" per specificare il set di caratteri ISO 8859\-1 (Latin\-1). Inoltre, \*(lqnippon\*(rq e \*(lqeuc\-kr\*(rq sono richiesti per gestire le rispettive codifiche euc\-jp e euc\-kr del file sgml. È accettato anche il formato \*(lqutf\-8\*(rq, sebbene sia supportato solo parzialmente. .IP "\-\-style=\fIfile\fP, \-S" Include un DTD (Document Type Definition) ausiliario da /usr/share/linuxdoc\-tools/dtd. .IP "\-\-tabsize=\fIn\fP, \-t" Imposta gli spazi di tabulazione (tab) assunti per la generazione del documento di uscita. Il valore perdefinito degli spazi di tabulazione è 8. .IP "\-\-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). .IP "\-\-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 è gestita dal comando sgmlpre. Vedere la pagina di manuale di sgmlpre(1) cosi` come la Guida dell'Utente. .IP "\-\-include, \-i" Passa una opzione \-i al comando \fBnsgmls\fP(1). Questo può essere usato per l'inclusione di condizionali. Vedere la pagina di manuale di \fBnsgmls\fP(1) per i dettagli. .IP "\-\-pass, \-P" Passa una stringa di opzioni al back\-end. L'esatta semantica di queste opzioni è dipendente dal back\-end e dovrebbe essere spiegata nella pagina di manuale relativa a ogni back\-end. .IP file Il file sorgente SGML, chiamato \fIfile\fP o \fIfile.sgml\fP. .LP L'esecuzione di un back\-end senza alcun argomento produrrà una lista di tutte le sue opzioni (Il messaggio di errore riguardo a "no filenames given" in questo caso può essere sicuramente ignorato). I back\-end disponibili includono (i nomi tra parentesi sono la forma vecchia & osoleta): .IP linuxdoc\ \-B\ html\ (sgml2html) traduce in HTML .IP linuxdoc\ \-B\ info\ (sgml2info) traduce in GNU info .IP linuxdoc\ \-B\ lyx\ (sgml2lyx) traduce in macro di Lyx .IP linuxdoc\ \-B\ latex\ (sgml2latex) traduce in LaTeX 2e .IP linuxdoc\ \-B\ rtf\ (sgml2rtf) traduce in Microsoft Rich Text Format .IP linuxdoc\ \-B\ txt\ (sgml2txt) traduce in testo semplice o nel markup delle pagine di manuale Unix .LP C'è anche \fBlinuxdoc\fP\-B\fBcheck\fP (sgmlcheck) uno strumento disponibile per verificare la sintassi LinuxDoc DTD SGML dei documenti sorgenti attualmente senza generare una versione tradotta. .SH "DRIVER DI BACKEND" Di seguito c'è la descrizione per ogni driver di backend: .LP **************************************************** .LP \fBlinuxdoc \-B html \fP (sgml2html) converte un file sorgente SGML di LinuxDoc DTD in file HTML di uscita. L'uscita apparirà nel file di livello più alto \fIfile.html\fP e \fIfile\-n.html\fP per ogni sezione (azione predefinita, ma può essere cambiata con un'opzione), dove \fIfile\fP è il nome del file sorgente SGML e \fIn\fP è il nome della sezione. .LP La coppia attributo/valore "output=html" è impostata per i condizionali. .LP \fBlinuxdoc \-B html\fP accetta le seguenti opzioni: \fB[\-\-split\fP \fI0|1|2\fP \fB] [\-\-dosnames] [\-\-imagebuttons]\fP \fB[\-\-toc\fP \fI0|1|2\fP \fB]\fP .LP Il significato di queste opzioni è: .IP "\-\-split, \-s" A quale livello dividere i documenti sorgenti. 0 = non dividere, 1 = dividere attraverso le sezioni principali, 2 = dividere attraverso le sottosezioni. .IP "\-\-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. .IP "\-\-dosnames, \-h" Usa ".htm" invece di ".html" come estensione dei file .IP "\-\-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. .IP "\-\-footer, \-F" Usa il file specificato come il footer in ogni file html ottenuto. Il footer predefinito è solo il semplice .nh .nf .ad l \en \en .hy .fi .IP "\-\-header, \-H" Usa il file specificato come la parte più alta dell'intestazione in ogni file html ottenuto. Notare che questo non è la parte completa dell'intestazione. (per esempio, il titolo e i links (next,previous,contents) non sono tenuti nell'intestazione predefinita. L'intestazione predefinita è .nh .nf .ad l \en \en \en .hy .fi .LP **************************************************** .LP \fBlinuxdoc \-B info\fP > (sgml2info) converte un file sorgente SGML di LinuxDoc DTD al formato info GNU. L'uscita apparirà nel \fIfile.info\fP dove \fIfile\fP è il nome del file sorgente SGML. .LP La coppia attributo/valore "output=info" è impostata per i condizionali. .LP \fBlinuxdoc \-B info\fP non ha opzioni specifiche di backend. .LP **************************************************** .LP \fBlinuxdoc \-B latex\fP > (sgml2latex) converte un file sorgente SGML di LinuxDoc DTD in un file di uscita LaTeX, usando l'analizzatore \fBnsgmls\fP(1) o \fBonsgmls\fP(1), e il traduttore \fBsgmlsasp\fP(1). Usando l'uscita LaTeX, e il formattatore di testo \fBlatex\fP(1), si può creare un'uscita DVI, e un'uscita PostScript usando il convertitore \fBdvips\fP(1). L'uscita apparirà nel \fIfile.tex\fP per l'uscita LaTeX, \fIfile.dvi\fP per l'uscita DVI, o \fIfile.ps\fP per l'uscita PostScript, dove \fIfile\fP è il nome del file sorgente SGML. .LP Usando l'uscita LaTeX, e il formattatore di testo \fBpdflatex\fP(1), poi si può creare un file di uscita PDF piacevole, adatto per essere visualizzato con visualizzatori di PDF come \fBxpdf\fP(1), \fBacroread\fP(1) o \fBghostview\fP(1). .LP La coppia attributo/valore "output=latex2e" è impostata per i condizionali. .LP \fBlinuxdoc \-B latex\fP accetta le seguenti opzioni specifiche di backend: \fB[\-\-output=\fP\fItex\fP\fB|\fP\fIdvi\fP\fB|\fP\fIps\fP\fB|\fP\fIpdf]\fP \fB[\-\-bibtex] [\-\-makeindex]\fP \fB[\-\-pagenumber=\fP\fIn\fP\fB]\fP \fB\-\-quick\fP \fB[\-\-latex=\fP\fIlatex\fP\fB|\fP\fIhlatexp\fP\fB|\fP\fIplatex\fP\fB|\fP\fIjlatex]\fP \fB[\-\-dvips=\fP\fIdvips\fP\fB|\fP\fIdvi2ps]\fP \fB[\-\-verbosity=n]\fP .LP Il significato di queste opzioni è: .IP "\-\-output=\fIfmt\fP, \-o" Specifica il formato di uscita voluto. Il formato specificato \fIfmt\fP può essere \*(lqtex\*(rq, \*(lqdvi\*(rq, \*(lqps\*(rq, o \*(lqpdf\*(rq. .PP Nota: Questa versione non sovrascrive/rimuove i file intermedi: il file per l'uscita dvi, o i file per l'uscita ps. Questo comportamento è differente dall'SGML\-Tools 1.0.9 originale, cosi` si è avvertiti. .IP "\-\-bibtex, \-b" Elabora il file TeX generato con \fBbibtex\fP(1). .IP "\-\-makeindex, \-m" Genera un file index TeX adatto per l'elaborazione con \fBmakeindex\fP(1) dai tag e presenti nel sorgente SGML. .IP "\-\-pagenumber, \-n" Imposta il numero della pagina iniziale nel file di uscita DVI o PS. .IP "\-\-quick, \-q" Fa solamente un passaggio della formattazione. Spesso questo non è sufficiente per produrre un'uscita finale (dovuta ai riferimenti, ecc.) ma è utile per mostrare gli errori di TeX e i problemi di giustificazione. .IP "\-\-pass, \-P" L'argomento dell'opzione pass è inserito subito dopo il preambolo di LaTeX generato dal tag del tipo di documento. Specifica il formato di uscita voluto. Il formato specificato \fIfmt\fP può essere \*(lqtex\*(rq, \*(lqdvi\*(rq, \*(lqps\*(rq, o \*(lqpdf\*(rq. .IP "\-\-latex=\fIcomando_latex_alternativo\fP, \-x" Questa opzione correntemente è per il coreano e il giapponese. Il \fIcomando_latex_alternativo\fP può essere \*(lqlatex\*(rq (predefinito), \*(lqhlatexp\*(rq (per il coreano), \*(lqplatex\*(rq o \*(lqjlatex\*(rq (per il giapponese). Questa opzione può 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 può essere ottenuto con jLaTeX (che è il predefinito quando è specificato \*(lq\-c nippon\*(rq), cosi` se si ha già installato jLaTeX, non è necessario installare pLaTeX. .IP "\-\-dvips=\fIcomando_dvips_alternativo\fP, \-s" Questa opzione è correntemente per il giapponese. Il \fIcomando_dvips_alternativo\fP può essere \*(lqdvips\*(rq o \*(lqdvi2ps\*(rq. Se non si conosce questo, allora questo non e' necessario. .IP "\-\-verbosity, \-V" Imposta la verbosità. '0' (predefinito) mostra informazioni sull'esecuzione di LaTeX solo in caso di errori. '1' mostra sempre informazioni sull'ultima esecuzione. '2' mostra informazioni per tutte le esecuzioni. .LP **************************************************** .LP \fBlinuxdoc \-B lyx\fP > (sgml2lyx) converte un file sorgente SGML di LinuxDoc DTD a un file di uscita LyX. L'uscita apparirà nel \fIfile.lyx\fP dove \fIfile\fP è il nome del file sorgente SGML. .LP La coppia attributo/valore "output=lyx" è impostata per i condizionali. .LP \fBlinuxdoc \-B lyx\fP non ha opzioni specifiche di backend. .LP **************************************************** .LP \fBlinuxdoc \-B rtf\fP > (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 apparirà nel file di più alto livello \fIfile.rtf\fP e \fIfile\-n.rtf\fP per ogni sezione, dove \fIfile\fP è il nome del file sorgente SGML. L'uscita RTF è adatta alla compilazione con il Compilatore dell'Help di Windows Help (hc31.exe). .LP La coppia attributo/valore "output=rtf" è impostata per i condizionali. .LP \fBlinuxdoc \-B rtf\fP accetta \fB[\-\-twosplit]\fP come un'opzione specifica di backend. Il significato di questa opzione è il seguente: .IP "\-\-twosplit, \-2" Divide i file sia a n. seczioni che a n.m. sottosezioni .LP **************************************************** .LP \fBlinuxdoc \-B txt\fP > (sgml2txt) converte un file sorgente SGML di LinuxDoc DTD a file di uscita ASCII, ISO\-8859\-1, o EUC\-JP. L'uscita apparirà nel \fIfile.txt\fP dove \fIfile\fP è il nome del file sorgente SGML. .LP La coppia attributo/valore "output=txt" è impostata per i condizionali. .LP \fBlinuxdoc \-B txt\fP accetta le seguenti opzioni di backend: \fB[\-\-manpage] [\-\-filter] [\-\-blanks=\fP\fIn\fP\fB]\fP .LP Il significato di queste opzioni è: .IP "\-\-manpage, \-m" Produce in uscita un file sorgente di groff, adatto per la formattazione con \fBgroff \-man\fP per le pagine di manuale .IP "\-\-filter, \-f" Rimuove gli backspace\-overstrikes dai file intermediari generati da \fBgroff\fP(1). .IP "\-\-pass, \-P" L'argomento dell'opzione pass è aggiunto alle opzioni della riga di comando gestite da \fBgroff\fP(1). .IP "\-\-blanks=\fIn\fP, \-b" Imposta il limite delle linee bianche consecutive per la generazione del documento di uscita. Il limite predefinito è 3. Se è specificato 0 (zero), il risultato avrà molte linee bianche consecutive. .LP **************************************************** .LP \fBlinuxdoc \-B check\fP > (sgmlcheck) esegue un analizzatore SGML sul documento sorgente specificato. Ogni errore è riportato sullo standard output. Nessuna versione formattata del sorgente è prodotta. .LP Notare che \fBlinuxdoc \-B check\fP pre\-elabora il sorgente SGML di LinuxDoc DTD, facendo la condizionalizzazione descritta da ogni tag <#if> e <#unless>. I documenti sorgenti che contengono questi tag confonderanno un analizzatore SGML standalone. \fBlinuxdoc \-B check\fP non ha opzioni specifiche di backend. **************************************************** .SH FILE Sono usati molti file ed eseguibili nelle directory /usr/share/linuxdoc\-tools e /usr/bin. .SH BUG Potrebbe essercene qualcuno. Ci si senta liberi di inviare il proprio reportal corrente manutentore. .SH MANUTENTORE Questa pagina di manuale è stata mantenuta da Cees de Groot in SGML\-Tools (v1). Attualmente è mantenuta da Taketoshi Sano per Linuxdoc\-Tools. .PP .SH TRADUZIONE La traduzione italiana di questa pagina di manuale è stata creata da Hugh Hartmann , Beatrice Torracca e Marco Curreli . .PP Questa traduzione è documentazione libera; leggere la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Versione 3 .UE o successiva per le condizioni di copyright. Non ci assumiamo alcuna responsabilità. .PP Per segnalare errori nella traduzione di questa pagina di manuale inviare un messaggio a .MT pluto-ildp@lists.pluto.it .ME .