Nom

docbook2texi-spec.pl - convertit des « Book » DocBook vers des documents Texinfo

Résumé

sgmlspl docbook2man-spec.pl nsgmls [ document_sgml ]| sgmlspl docbook2texi-spec.pl [ basename ]

Description


docbook2texi est un fichier de spécifications sgmlspl qui produit des documents GNU Texinfo à partir de documents DocBook.

Le programme lit les données « ESIS » produit par nsgmls (ou tout autre analyseur syntaxique SGML) à partir de l'entrée standard. Actuellement l'élément de document doit être « Book », autrement le résultat est indéfini.

Le document Texinfo converti résultant est écrit sur la sortie standard.

Le fichier basename.refs sera également créé, il contient tous les n½uds du document et leurs n½uds « enfants » immédiats. Comme le traitement des n½uds nécessitent toujours des références en aval, docbook2texi doit être invoqué deux fois sur chacun des documents : la première fois pour construire les références, et la seconde pour générer effectivement un document valide.

PrÉ-requis

Le paquetage SGMLSpm du CPAN. Ce paquetage inclut le script sgmlspl qui est également nécessaire.

Limitations


Tester docbook2man sur des fichiers qui ne sont pas au format DocBook ou SGML provoque un comportement indéfini.

Ce programme est un script Perl lent et « vite fait, mal fait ».

Ce programme ne prétend pas accepter tous les marquages possibles de DocBook, et peut produire des sorties erronées, dans certains cas, avec le marquage supporté.

À faire

(bu Quel enfer pour représenter la barre oblique inverse « » dans Texinfo!!@? J'ai essayé « \ » mais TeX s'en plaint.

(bu Corriger les plantages sur les documents de test.

(bu Ajouter une nouvelle manipulation d'élément et corriger les manipulations existantes. Être solide.

(bu Le rendre plus rapide. Je pense que la plupart des problèmes de rapidité jusqu'ici sont dus à l'analyse syntaxique d'ESIS. Réécrire SGMLS.pm en C et/ou récupérer directement l'entrée à partir de SP&.

(bu Il y a des dépendances sur des éléments qui surviennent alors que ceux-ci sont en fait optionnels (en accord avec la DTD). Nous devons corriger ceci (de préférence) ou en faire éminemment état dans les exigences.

(bu Permettre d'autres éléments de document plus courants.

(bu Séparer le référencement des n½uds dans un script à part. Non seulement cela le rendrait plus rapide/facile à maintenir car il serait séparé du code principal, mais également je voudrais le faire évoluer vers un générateur automatique de table des matières DocBook.

Copyright


Copyright (C) 1998-1999 Steve Cheng <steve@ggi-project.org>

Ce programme est 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 la version 2 de cette licence, soit (à vous de voir...) toute autre version ultérieure.

Vous devez avoir reçu une copie de la Licence Publique Générale GNU avec ce programme; voir le fichier COPYING&. Si ce n'est pas le cas, écrivez à la Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.

Traduction


Ce document est une traduction réalisée par Alain Portal <aportal AT univ-montp2 DOT fr> 12 février 2003 et révisée le 19 novembre 2004.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=en man 1 docbook2texi-spec.pl ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.