docbook-2-pdf - Online nel cloud

PROGRAMMA:

NOME

sgml2x — Formatta facilmente documenti SGML/XML utilizzando i fogli di stile DSSSL

SINOSSI

sgml2x [Opzioni] [sgmlfile | xmlfile ]

docclass-2-formato di destinazione [Opzioni] [sgmlfile | xmlfile ]

Descrizione

sgml2x permette di formattare facilmente un documento SGML o XML usando fogli di stile DSSSL, e
fornisce le seguenti caratteristiche:

· Più fogli di stile possibili per classe di documenti

· Facile specifica dei fogli di stile utilizzando alias, con supporto per i parametri
eredità

· Facile integrazione di nuovi fogli di stile aggiungendo un semplice nuovo file di definizione in a
directory di configurazione

· Il chiamante può specificare un elenco di directory di configurazione simile a PATH, il valore predefinito è
una directory di configurazione a livello di sistema, per utente e per progetto

· Selezione automatica di un foglio di stile predefinito da utilizzare, in base all'assegnazione
priorità

· Passa opzioni arbitrarie a giada(1)

La classe documento utilizzata per cercare i fogli di stile e il formato di output è per ora
derivato solo dal nome con cui viene chiamato il programma, quindi vorrai chiamarlo così
programma tramite collegamenti simbolici come docbook-2-pdf.

sgml2x è implementato come un wrapper di shell intorno giada(1) (o, preferibilmente, giada aperta(1),
anche se usiamo il nome generico giada tutta questa documentazione), giadetex(1) e altro
strumenti.

Se non c'è jadetex.cfg vicino al documento, ne viene copiato uno di default, che abilita
produzione di segnalibri PDF.

Opzioni

-c|--Catalogare catalogo
Usa il catalogo SGML specificato invece del valore predefinito del sistema.

-C|--confdir dir-lista
Utilizzare l'elenco (separato da spazi) delle directory di configurazione. Questa opzione è
cumulativo, cioè puoi usarne più di uno -C opzioni e le liste saranno
concatenato.

Gli elementi della lista dovrebbero essere ordinati dalla configurazione più generica (es. a livello di sistema)
al più specifico (ad es. a livello di progetto).

Se viene fornita una directory tramite questa opzione, l'elenco di directory predefinito sarà
ignorato.

-D|--dssslproc dsssl-processore
Usa il dsssl-processore per applicare il foglio di stile, invece di quello predefinito. Questo
il processore deve supportare giada-come opzioni, come -V.

Quando questa opzione non è presente, la prima trovata nel dsslproc file da confdirs è
preso. Vedere "File" per ulteriori dettagli.

-h|--Aiuto Visualizza un messaggio di aiuto ed esci.

-j|--giada dsssl-processore
Sinonimo obsoleto di --dssslproc.

--jadetexfilter filtro-perl
Post-elaborare l'output jadetex utilizzando un filtro perl.

Questo può essere utile per forzare interruzioni di pagina in alcuni punti specifici per superare il foglio di stile
problemi, o per forzare la sillabazione dove TeX non ha abbastanza pattern, o per farne uno
un'altra trasformazione intelligente a cui penseresti.

Vedere la esempi/righe di comando file per eventuali utilizzi.

-n|--nessun atto
Stampa i comandi invece di eseguirli. Utile per conoscere il livello inferiore
strumenti e per il debug della riga di comando.

-o|--openjade
La sezione opzione is obsoleto. giada aperta è ora l'impostazione predefinita quando disponibile. Utilizzo
--dssslproc o dsslproc file di configurazione per forzare un processore specifico.

Questa opzione era usata giada aperta(1) come processore DSSSL invece di giada(1).

-O|--jadeopts jade-opzioni
Opzioni aggiuntive a cui passare giada(1). Questa opzione è cumulativa, puoi
specificarne diversi, le opzioni fornite verranno concatenate.

-q|--silenzioso
Imposta verbosità su silenzioso

-r|--osservazioni
Rendi il contenuto delle note del documento nel documento (osservazione elementi in
DocBook 4, commento elementi in DocBook 3), rendendo l'output prodotto un
solo per uso interno documento, stampando un'avvertenza in grassetto sulla copertina.

Questa è una funzionalità specifica per docclass e fogli di stile e non tutti i fogli di stile verranno utilizzati
Questo.

-s|--stile style
Seleziona uno stile di output per sovrascrivere l'impostazione predefinita (eventualmente derivata dal documento).

Gli stili attualmente disponibili per una specifica classe di documenti e per ogni formato di output sono
dipende dal contenuto delle directory di configurazione e può essere visualizzato con il tasto
--Aiuto opzione.

Nota che è buona norma specificare questa opzione in una procedura di compilazione, in modo da ottenere
risultati riproducibili indipendentemente dai fogli di stile disponibili.

-v|--verboso
Aumenta la verbosità. Questa opzione può essere specificata più volte.

--verbosità N
Imposta verbosità su N. I livelli di verbosità sono definiti come segue:

silenzioso Solo errori di stampa

difetto Stampa solo errori e avvisi

verboso Stampa anche gli avvisi

tracciare Stampa anche i comandi significativi man mano che vengono eseguiti (come --nessun atto lo fa).

mettere a punto Stampa anche i messaggi di debug

-V|--versione
Stampa la versione del programma ed esci.

Configurazione

sgml2x usa un albero di directory di configurazione invece di un file di configurazione, in modo che sia
facile per altri pacchetti da collegare con un basso rischio di rompere una configurazione esistente.

Le gerarchie di stili si trovano nelle directory denominate stili in ogni configurazione
directory. Le vecchie versioni di questo programma erano usate per mettere quelle gerarchie direttamente nel
directory di configurazione.

Una directory di configurazione contiene una directory per ogni classe di documenti nota, denominata con
un soprannome della classe del documento (es libro dei documenti). Queste directory docclass contengono un sotto-
directory per ogni classe di formato di output (attualmente, solo html ed stampare sono supportati).

Attualmente, i problemi di implementazione impongono una limitazione ai soprannomi per le classi di documenti
e fogli di stile: possono contenere solo caratteri alfanumerici e underscore. Questo
la limitazione potrebbe essere eliminata in una versione futura, ma ciò non accadrà prima di questo
lo script viene riscritto in un'altra lingua.

Ognuna di queste directory contiene un file per stile disponibile. I nomi di questi file
possono contenere solo caratteri alfanumerici e vengono utilizzati come soprannomi per gli stili. Questo
il file contiene righe con a chiave: APPREZZIAMO pattern, con le seguenti chiavi attualmente
supportati:

Id L'identificatore pubblico per il foglio di stile

disc Una breve descrizione degli stili, da visualizzare nel messaggio di aiuto

pdfSostituisci, ps Sostituisci,
rtfOverride, mifOverride" 10 Un simbolo dsssl dal foglio di stile di stampa da impostare
a #t (O un simbolo=APPREZZIAMO coppia, adatto come argomento a giada's -V opzione),
da utilizzare per il formato di stampa specificato.

È consentito un solo simbolo per riga di sostituzione. Per definire i valori per più simboli, utilizzare
parecchie righe.

Eredita Il soprannome di un foglio di stile da cui questo eredita, per evitare inutile
duplicazione delle definizioni di stile.

Attualmente, questo causa solo l'ereditarietà del *Oltrepassare parametri.

Priorità Un numero intero positivo per aiutare a selezionare lo stile predefinito quando uno non può essere
derivato dal documento. Valori più alti hanno maggiori probabilità di essere presi come
predefinito. Abbi cura di utilizzare basse priorità per stili iper-specializzati per a
tipo di documento generico, in modo che non venga utilizzato per errore.

Ad esempio, l'attuale politica consigliata per i fogli di stile DocBook derivata da
Quello di Norman Walsh è il seguente (e può cambiare se l'esperienza lo dimostra inadeguato).

10 I fogli di stile di base, che di solito devono essere personalizzati.

0 Qualsiasi foglio di stile che è stato scritto per uno scopo iper-specializzato (es
scheda prodotto di marketing).

1000 Uno stile predefinito per tutti i documenti prodotti da un'organizzazione. Di solito un
personalizzazione della luce, con preferenze di layout, l'organizzazione
logo o cose del genere.

10-100 Varie personalizzazioni generiche dei fogli di stile di base.

Quando scrivi una versione migliorata di un foglio di stile con priorità n, Si
di solito vogliono selezionare una priorità più alta.

File

/etc/sgml/sgml2x/

~/.sgml2x/

./sgml2x/ Le directory di configurazione predefinite, in cui si trovano i file di configurazione
Cercato. Vedere la documentazione per --confdir per ulteriori dettagli.

confidare/stile/
La gerarchia che definisce gli stili utilizzabili. Vedere "Configurazione" per maggiori
dettagli.

confidare/dsslproc
Un file contenente un elenco ordinato di processori dsssl da cercare, separati da
newline e/o spazi bianchi. Righe che iniziano con a # carattere sono trattati come
Commenti. I valori comuni includono giada aperta ed giada.

I processori DSSSL specificati qui dovrebbero accettare il -V ed -D compatibile con giada
opzioni della riga di comando.

Si cercano le directory di configurazione partendo dalla più specifica
one, in modo che, con le confdirs predefinite, le impostazioni del progetto possano sovrascrivere user
impostazioni, che a loro volta possono sovrascrivere le impostazioni di sistema.

Il valore speciale falso può essere utilizzato per interrompere la ricerca ed evitare di indagare
directory più generiche. Se ad esempio un progetto deve utilizzare il
openjade-1.4devel comando e nessun altro, può specificare openjade-1.4devel falso
nella sua dsslproc file.

Avvertenze

Quando si usa openjade-1.4devel come processore DSSSL, vedrai un reclamo sul top-
livello di flusso-oggetto generato da doctype.dsl, e la determinazione automatica del documento-
tipo fallirà. Questo errore è altrimenti innocuo. Idee su come affrontare questo, o
conferma che openjade-1.4devel è troppo severo, sarà apprezzato :)

I futuro

Le funzionalità pianificate per le versioni future includono:

· Integrazione di un generatore di indici

· Integrazione di un bel motore di stampa per esempi di codice

· Specifica delle trasformazioni da concatenare

· Dichiarazione di sottoinsiemi di docclass per consentire l'uso con qualsiasi docclass dello stile-
fogli che si applicano alle sue docclass superset.

· Lavorare in una posizione temporanea in modo da non inquinare la directory di lavoro con
file temporanei. Non è così facile come sembra, perché rompe un documento
fa riferimento a file di immagine che utilizzano percorsi relativi. Può essere visto come un insetto di giada,
tuttavia.

Sfoglia l'elenco TODO completo e inviaci altre idee!

Copyright

Copyright © 2001-2003 Alcova & Yann Dirson.

sgml2x è concesso in licenza sotto la GNU General Public License, versione 2.

Questa documentazione è rilasciata sotto la GNU Free Documentation License, versione 1.

Contatti us

sgml2x è parte del Alcova Libro progetto (link a URL http://www.alcove-
labs.org/en/software/alcovebook/) . Si prega di utilizzare il file Alcova Libro mailing list (link a URL
https://savannah.gnu.org/mail/?group_id=533) per entrare in contatto con sviluppatori e utenti.

L'elenco dei bug e delle richieste di funzionalità è disponibile attraverso a Web interfaccia (link a URL
https://savannah.gnu.org/support/?group_id=533) . Si prega di utilizzarlo per inviare problemi e
idee.

See anche

giada aperta(1), giada(1), giadetex(1), collateindex.pl(1).

sgml2x(1)

Utilizzare docbook-2-pdf online utilizzando i servizi onworks.net