Rechercher une page de manuel
docbook2texi-spec.pl
Langue: fr
Version: 11 February 2004 (www.delafond.org - 07/08/07)
Section: 1 (Commandes utilisateur)
NOM
docbook2texi-spec.pl - convertit des � Book � DocBook vers des documents TexinfoSYNOPSIS
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
- *
- Quel enfer pour repr�senter la barre oblique inverse � \ � dans Texinfo!!@? J'ai essay� � \\ � mais TeX s'en plaint.
- *
- Corriger les plantages sur les documents de test.
- *
- Ajouter une nouvelle manipulation d'�l�ment et corriger les manipulations existantes. �tre solide.
- *
- 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.
- *
- 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.
- *
- Permettre d'autres �l�ments de document plus courants.
- *
- 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.
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre