Chapitre 1. Un Concept révolutionnaire

1. Qu'est-ce que Borges ?
1.1. Caractéristiques
2. Choisir Borges
2.1. En ai-je besoin ?
2.2. Borges est-il fait pour moi ?
3. Un peu de vocabulaire

1. Qu'est-ce que Borges ?

Borges est un système de gestion de documents extensible et libre (open source) destiné à faciliter des projets de documentation en format XML. Il a été conçu dans un souci d'internationalisation et de réutilisation des contenus, de flexibilité, de travail collaboratif, etc.

Le but de Borges est de fournir un outil convivial :

  • pour les débutants : grâce à une interface très simple pour compiler les documents XML et DocBook et les exporter vers divers formats ;

  • pour les utilisateurs avancés : en leur offrant la possibilité de personnaliser n'importe quel aspect du système comme les formats d'exportation, la mise en pages et d'autres commandes personnalisées, etc.

  • pour les chargés de projets : en leur fournissant un puissant outil de suivi de projets permettant de « jongler » avec les auteurs et les traducteurs, les échéances, etc.

1.1. Caractéristiques

Les DTDs prises en charge sont DocBook TDB(Training DocBook), un dérivé de la DTD DocBook utilisé pour rédiger les supports de cours de MandrakeSoft. L'ajout de DTD externes est très facile, même si le système de contrôle des révisions ne fonctionne pas encore avec des DTD autres que DocBook et TDB.

Actuellement, le système permet de :

  • compiler des fichiers source en PDF, PS et (X)HTML;

  • gérer différentes versions d'un document en définissant des versions dérivées à partir de balises ;

  • chaque module est attribué à une équipe de contributeurs : auteurs, traducteurs et relecteurs, chacun étant responsable d'une des étapes de création d'un module. Chaque contributeur peut prendre connaissance de ses tâches sur une page Web et peut recevoir des courriels contenant sa liste des tâches ;

  • suivre l'évolution du projet dans sa globalité (à partir de divers manuels) ou à partir d'éléments basiques (paragraphes) et leur traduction ;

  • suivre l'évolution d'un module selon 6 étapes prédéfinies (de l'écriture à la relecture finale). Lorsque chaque tâche est accomplie, l'étape correspondante est validée pour que le module passe à la suivante.

Aperçu rapide des fonctionnalités de Borges :

  • gestion automatique des images aux formats EPS, PNG, DIA, XFig ;

  • gestion automatique globale ou locale (par manuel) des éléments externes ;

  • gestion automatique des modules en tant qu'éléments externes.