Il s'agit de la commande docbook2man-spec.pl qui peut être exécutée dans le fournisseur d'hébergement gratuit OnWorks en utilisant l'un de nos multiples postes de travail en ligne gratuits tels que Ubuntu Online, Fedora Online, l'émulateur en ligne Windows ou l'émulateur en ligne MAC OS
PROGRAMME:
Nom
docbook2man-spec.pl - convertit les DocBook RefEntries en pages de manuel
SYNOPSIS
sgmlspl docbook2man-spec.pl
nsgmls [ sgml document ]| sgmlspl docbook2man-spec.pl
DESCRIPTION
docbook2man est un fichier de spécification sgmlspl qui a produit des pages de manuel (en utilisant les macros -man) à partir de
Balise DocBook RefEntry.
Le programme lit ESIS produit par nsgmls (ou d'autres analyseurs SGML) à partir d'une entrée standard.
Le balisage introuvable dans RefEntry est supprimé.
Sa sortie, les pages de manuel converties, sont écrites dans le répertoire courant. Si RefMeta
les informations ne sont pas spécifiées dans une RefEntry, alors la page de manuel sera écrite en standard
sortie.
Le fichier page de manuel.links sera également créé, qui contient tous les alias des pages de manuel
généré. Ce fichier est au format :
<man page> <alias
page de manuel>
La page de manuel.refs fichier conserve une trace des références XRef. Notez que si le document d'entrée a
toutes les références vers l'avant, puis docbook2man peut devoir être invoqué deux fois (la première fois
la mise à jour page de manuel.refs) pour les résoudre.
EXIGENCES
Le package SGMLSpm de CPAN. Ce package comprend le script sgmlspl qui est également
nécessaire.
LIMITATIONS
En essayant docbook2man sur un non-DocBook ou un SGML non conforme entraîne un comportement indéfini.
:-)
Ce programme est un script Perl lent et louche.
Ce programme ne prend pas en charge tous les balisages possibles dans DocBook, et peut
produire une sortie erronée dans certains cas avec un balisage pris en charge.
À DO
Des trucs évidents :
· Réparer docbook2man ruptures trouvées dans les documents d'essai, en particulier bizarre.sgml.
· Ajouter une nouvelle manipulation d'élément et corriger la manipulation existante. Soyez robuste.
· Produisez la sortie de l'homme la plus propre et lisible possible (contrairement à d'autres convertisseurs).
Suivez Linux man(7) congrès. Comme la conversion en pages de manuel n'est généralement pas effectuée très
souvent, il vaut mieux être plus lent/plus compliqué que de produire une mauvaise sortie. Également si
quelqu'un veut abandonner l'utilisation de DocBook pour une raison quelconque, les dernières pages de manuel converties
peut alors être maintenu manuellement.
· Fais le plus rapidement. Je pense que la plupart des problèmes de vitesse jusqu'à présent sont liés à l'analyse d'ESIS. Récrire
SGMLS.pm avec C et/ou obtenir des entrées directement de SP.
· Prise en charge d'autres langues (humaines). Mais que faire des jeux de caractères non ASCII ? SGMLSpm
ne les signale pas et roff ne les grogne pas. [Commentaire : texte après les listes jointes
(et les blocs SS) casseront docbook2man] Si nous faisons cela, davantage de personnes pourront utiliser DocBook.
DROIT D'AUTEUR
Copyright (C) 1998-1999 Steve Cheng[email protected]>
Ce programme est un logiciel libre ; vous pouvez le redistribuer et/ou le modifier selon les termes de
la licence publique générale GNU telle que publiée par la Free Software Foundation ; Soit
version 2, ou (à votre choix) toute version ultérieure.
Vous devriez avoir reçu une copie de la licence publique générale GNU avec ce programme ;
voir le fichier COPIER. Sinon, veuillez écrire à la Free Software Foundation, 675 Mass Ave,
Cambridge, MA 02139, États-Unis.
29 Octobre 2012 DOCBOOK2MAN-SPEC.PL(1)
Utilisez docbook2man-spec.pl en ligne en utilisant les services onworks.net
