Linux Certif

Toute la documentation sur la certification Linux LPI

docbook2texi-spec.pl

NOM

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

SYNOPSIS

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.