Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] docbook2texi-spec.pl - convertit des « Book » DocBook vers des documents Texinfo [size=18] [b]Résumé[/b] [/size] [b]sgmlspl[/b] [b]docbook2man-spec.pl[/b] [b]nsgmls[/b] [ [b][/b][i]document_sgml[/i][b][/b] ][b]\|[/b] sgmlspl [b]docbook2texi-spec.pl[/b] [ [b][/b][i]basename[/i][b][/b] ] [size=18] [b]Description[/b] [/size] [b]docbook2texi[/b] 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 [i]basename.refs[/i] 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, [b]docbook2texi[/b] 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. [size=18] [b]PrÉ-requis[/b] [/size] Le paquetage SGMLSpm du CPAN. Ce paquetage inclut le script sgmlspl qui est également nécessaire. [size=18] [b]Limitations[/b] [/size] Tester [b]docbook2man[/b] 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é. [size=18] [b]À faire[/b] [/size] [table][row][col]    [/col][col](bu Quel enfer pour représenter la barre oblique inverse « » dans Texinfo!!@? J'ai essayé « \ » mais TeX s'en plaint.[/col][/row][/table] [table][row][col]    [/col][col](bu Corriger les plantages sur les documents de test.[/col][/row][/table] [table][row][col]    [/col][col](bu Ajouter une nouvelle manipulation d'élément et corriger les manipulations existantes. Être solide.[/col][/row][/table] [table][row][col]    [/col][col](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 [i]SGMLS.pm[/i] en C et/ou récupérer directement l'entrée à partir de [b]SP[/b]&.[/col][/row][/table] [table][row][col]    [/col][col](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.[/col][/row][/table] [table][row][col]    [/col][col](bu Permettre d'autres éléments de document plus courants.[/col][/row][/table] [table][row][col]    [/col][col](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.[/col][/row][/table] [size=18] [b]Copyright[/b] [/size] 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 [i]COPYING[/i]&. Si ce n'est pas le cas, écrivez à la Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA. [size=18] [b]Traduction[/b] [/size] 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 : « [b]LANG=en[/b] 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.
Fichier