docbook-2-html - En ligne dans le Cloud

PROGRAMME:

Nom

sgml2x — Formate facilement les documents SGML/XML à l'aide des feuilles de style DSSSL

SYNOPSIS

sgml2x [Options] [fichier sgml | fichier xml ]

classe de doc-2-format cible [Options] [fichier sgml | fichier xml ]

Description

sgml2x permet de formater facilement un document SGML ou XML à l'aide des feuilles de style DSSSL, et
fournit les fonctionnalités suivantes:

· Plusieurs feuilles de style possibles par classe de document

· Spécification simple des feuilles de style à l'aide d'alias, avec prise en charge des paramètres
héritage

· Intégration facile de nouvelles feuilles de style en ajoutant un nouveau fichier de définition simple dans un
répertoire de configuration

· L'appelant peut spécifier une liste de répertoires de configuration de type PATH, par défaut
un répertoire de configuration à l'échelle du système, par utilisateur et par projet

· Sélection automatique d'une feuille de style par défaut à utiliser, en fonction de l'assignation
priorités

· Passer des options arbitraires à jade(1)

La classe de document utilisée pour rechercher les feuilles de style et le format de sortie est pour l'instant
uniquement dérivé du nom avec lequel le programme est appelé, vous voudrez donc l'appeler
programme via des liens symboliques comme docbook-2-pdf.

sgml2x est un implémenté comme un shell wrapper autour jade(1) (ou, de préférence, jade ouvert(1),
bien que nous utilisions le nom générique jade tout au long de cette documentation), jadetex(1) qualité
outils.

Si il n'y a pas jadetex.cfg près du document, un fichier par défaut est copié, ce qui permet
production de signets PDF.

Options

-c|--catalogue catalogue
Utilisez le catalogue SGML spécifié au lieu de la valeur par défaut du système.

-C|--confirs liste de répertoires
Utiliser la liste (séparée par des espaces) des répertoires de configuration. Cette option est
cumulatif, c'est-à-dire que vous pouvez utiliser plusieurs -C options et les listes seront
concaténé.

Les éléments de la liste doivent être commandés à partir de la configuration la plus générique (par exemple à l'échelle du système)
au plus spécifique (par exemple à l'échelle du projet).

Si un répertoire est fourni via cette option, la liste de répertoires par défaut sera
ignoré.

-D|--dssslproc processeur dsssl
Utilisez processeur dsssl pour appliquer la feuille de style, au lieu de celle par défaut. Cette
le processeur doit prendre en charge jade-comme des options, telles que -V.

Lorsque cette option n'est pas présente, la première trouvée dans le dssslproc fichiers de confdirs est
pris. Voir "Des dossiers" pour plus de détails.

-h|--Aidez-moi Affichez un message d'aide et quittez.

-j|--jade processeur dsssl
Synonyme obsolète de --dssslproc.

--jadetexfilter filtre perl
Post-traitez la sortie jadetex à l'aide d'un filtre perl.

Cela peut être utile pour forcer les sauts de page à certains endroits spécifiques pour surmonter la feuille de style
problèmes, ou pour forcer les césure là où TeX n'a ​​pas assez de modèles, ou faire n'importe quel
autre transformation intelligente à laquelle vous penseriez.

Voir le exemples/lignes de commande fichier pour les utilisations possibles.

-n|--pas d'action
Imprimer les commandes au lieu de les exécuter. Utile pour en savoir plus sur le niveau inférieur
outils et pour le débogage de la ligne de commande.

-o|--openjade
Ce option is obsolète. jade ouvert est maintenant la valeur par défaut lorsqu'elle est disponible. Utilisation
--dssslproc ou dssslproc fichier de configuration pour forcer un processeur spécifique.

Cette option utilisait jade ouvert(1) comme processeur DSSSL au lieu de jade(1).

-O|--jadeopts options de jade
Options supplémentaires pour passer à jade(1). Cette option est cumulative, vous pouvez
spécifiez-en plusieurs, les options fournies seront concaténées.

-q|--silencieux
Définir la verbosité sur calme

-r|--remarques
Rendre le contenu des remarques du document dans le document (remarque éléments dans
DocBook 4, commentaire éléments dans DocBook 3), faisant de la sortie produite un
usage interne uniquement document, en imprimant un avertissement en gras sur la couverture.

Il s'agit d'une fonctionnalité spécifique aux classes de documents et aux feuilles de style, et toutes les feuilles de style n'utiliseront pas
ce.

-s|--style Catégorie
Sélectionnez un style de sortie pour remplacer la valeur par défaut (éventuellement dérivée du document).

Les styles actuellement disponibles pour une classe de document spécifique et pour chaque format de sortie sont
en fonction du contenu des répertoires de configuration, et peut être affiché avec le
--Aidez-moi option.

Notez qu'il est recommandé de spécifier cette option dans une procédure de génération, afin que vous obteniez
des résultats reproductibles quelles que soient les feuilles de style disponibles.

-v|--verbeux
Augmenter la verbosité. Cette option peut être spécifiée plusieurs fois.

--verbosité N
Définir la verbosité sur N. Les niveaux de verbosité sont définis comme suit :

calme Erreurs d'impression uniquement

défaut N'imprimer que les erreurs et les avertissements

verbeux Imprimez également les avis

tracer Imprimez également les commandes importantes au fur et à mesure de leur exécution (comme --pas d'action Est-ce que).

déboguer Imprimer également les messages de débogage

-V|--version
Imprimez la version du programme et quittez.

configuration

sgml2x utilise une arborescence de répertoires de configuration au lieu d'un fichier de configuration, de sorte qu'il est
facile à brancher pour d'autres packages avec un faible risque de casser une configuration existante.

Les hiérarchies de styles sont situées dans des répertoires nommés modes dans chaque configuration
annuaire. Les anciennes versions de ce programme mettaient ces hiérarchies directement dans le
répertoires de configuration.

Un répertoire de configuration contient un répertoire pour chaque classe de document connue, nommé avec
un surnom de classe de document (par exemple docbook). Ces répertoires docclass contiennent un sous-
répertoire pour chaque classe de format de sortie (actuellement, seulement html ainsi que impression sont pris en charge).

Actuellement, des problèmes d'implémentation imposent une limitation sur les surnoms pour les classes de documents
et les feuilles de style : elles ne peuvent contenir que des caractères alphanumériques et des traits de soulignement. Cette
la limitation peut être supprimée dans une future version, mais cela n'arrivera pas avant cela
le script est réécrit dans une autre langue.

Chacun de ces répertoires contient un fichier par style disponible. Les noms de ces fichiers
ne peuvent contenir que des caractères alphanumériques et sont utilisés comme surnoms pour les styles. Cette
fichier contient des lignes avec un clé: Plus-value modèle, les touches suivantes étant actuellement
prise en charge:

Id L'identifiant public de la feuille de style

desc Une brève description des styles, à afficher dans le message d'aide

pdfRemplacer, psOverride,
rtfRemplacer, mifRemplacer" 10 Un symbole dsssl de la feuille de style d'impression à définir
à #t (ou un symbole=Plus-value paire, appropriée comme argument pour jade's -V option),
à utiliser pour le format d'impression donné.

Un seul symbole par ligne de dérogation est autorisé. Pour définir des valeurs pour plusieurs symboles, utilisez
plusieurs lignes.

Hérite Le surnom d'une feuille de style dont celle-ci hérite, pour éviter les inutiles
duplication des définitions de style.

Actuellement, cela ne provoque que l'hérédité de la *Passer outre paramètres.

Priorité Un entier positif pour aider à sélectionner le style par défaut quand on ne peut pas être
dérivé du document. Des valeurs plus élevées ont plus de chances d'être prises comme
défaut. Veillez à utiliser des priorités faibles pour les styles hyper-spécialisés pour un
type de document générique, afin qu'il ne soit pas utilisé par erreur.

Par exemple, la politique actuellement recommandée pour les feuilles de style DocBook dérivées de
Celui de Norman Walsh est le suivant (et peut changer si l'expérience prouve qu'il est inadéquat).

10 Les feuilles de style de base, qui doivent généralement être personnalisées.

0 Toute feuille de style qui a été écrite dans un but hyper-spécialisé (par ex.
fiche produit marketing).

1000 Un style par défaut pour tous les documents produits par une organisation. Habituellement un
personnalisation légère, avec des préférences de mise en page, les
logo, ou de telles choses.

10-100 Diverses personnalisations génériques des feuilles de style de base.

Lorsque vous écrivez une version améliorée d'une feuille de style avec priorité n, Vous
veulent généralement sélectionner une priorité plus élevée.

Fichiers

/etc/sgml/sgml2x/

~/.sgml2x/

./sgml2x/ Les répertoires de configuration par défaut, dans lesquels les fichiers de configuration sont
recherché. Voir la documentation pour --confirs pour plus de détails.

confier/style/
La hiérarchie qui définit les styles utilisables. Voir "Configuration" pour plus d'
détails.

confier/dssslproc
Un fichier contenant une liste ordonnée de processeurs dsssl à rechercher, séparés par
des nouvelles lignes et/ou des espaces. Les lignes commençant par un # caractère sont traités comme
commentaires. Les valeurs communes incluent jade ouvert ainsi que jade.

Les processeurs DSSSL spécifiés ici doivent accepter le -V ainsi que -D compatible jade
options de ligne de commande.

Les répertoires de configuration sont recherchés en commençant par les plus spécifiques
un, de sorte que, avec les confdirs par défaut, les paramètres du projet peuvent remplacer l'utilisateur
paramètres, qui à leur tour peuvent remplacer les paramètres du système.

La valeur spéciale non peut être utilisé pour arrêter la recherche et empêcher l'examen
répertoires plus génériques. Si par exemple un projet doit utiliser le
openjade-1.4devel commande et aucune autre, il peut spécifier openjade-1.4devel non
dans sa dssslproc fichier.

Avertissements

Lors de l'utilisation openjade-1.4devel en tant que processeur DSSSL, vous verrez une plainte concernant le top-
objet de flux de niveau généré par doctype.dsl, et la détermination automatique du document-
le type échouera. Cette erreur est par ailleurs inoffensive. Des idées sur la façon de gérer cela, ou
la confirmation que openjade-1.4devel est trop strict, sera apprécié :)

La avenir

Les fonctionnalités prévues pour les futures versions incluent :

· Intégration d'un générateur d'index

· Intégration d'un joli moteur d'impression pour les exemples de code

· Spécification des transformations à enchaîner

· Déclaration de sous-ensembles docclasses pour permettre l'utilisation avec n'importe quel docclass du style-
feuilles qui s'appliquent à ses docclasses surensemble.

· Travailler dans un emplacement temporaire afin de ne pas polluer le répertoire de travail avec
fichiers temporaires. Ce n'est pas aussi facile qu'il y paraît, car cela casse un document
fait référence aux fichiers image utilisant des chemins relatifs. Cela peut être considéré comme un bug de jade,
cependant.

Parcourez la liste complète des TODO et envoyez-nous plus d'idées !

Droits d’auteur

Copyright © 2001-2003 Alcôve & Yann Dirson.

sgml2x est sous licence GNU General Public License, version 2.

Cette documentation est sous licence GNU Free Documentation License, version 1.

Contactez-Nous us

sgml2x fait partie de la AlcôveLivre Projet (lien à URL http://www.alcove-
labs.org/en/software/alcovebook/) . Veuillez utiliser le AlcôveLivre mailing listes (lien à URL
https://savannah.gnu.org/mail/?group_id=533) pour entrer en contact avec les développeurs et les utilisateurs.

La liste des bugs et des demandes de fonctionnalités est disponible à travers a DÉVELOPPEMENT interface (lien à URL
https://savannah.gnu.org/support/?group_id=533) . Veuillez l'utiliser pour soumettre des problèmes et
des idées.

See aussi

jade ouvert(1), jade(1), jadetex(1), indexer.pl(1).

sgml2x(1)

Utilisez docbook-2-html en ligne à l'aide des services onworks.net