Documentation | Version PDF du manuel français grandement améliorée

Par Guillaume Lelarge le 01/05/2006 - 12:29

La version PDF de la documentation n'a jamais été bien réalisée. Ceci est principalement dû à la façon dont elle était construite. L'équipe de traduction utilisait openjade pour générer un gros fichier HTML contenant toute la documentation. Puis, ce document était fournit à htmldoc qui créait le PDF... sans prendre en compte les feuilles de style (une des grosses limitations de la version 1.8 de ce logiciel). De plus, ce logiciel a peu d'options qui permettraient d'améliorer la présentation du PDF.

Comme certaines personnes (nommément fabix et Kryskool) souhaitaient passer en DocBook XML, le passage a été entrepris. Cela a permis d'utiliser une chaîne d'outils bien plus complète et flexible. Le passage au XML et les modifications nécessaires pour créer un PDF agréable à utiliser et à lire ont pris entre deux et trois semaines... mais le résultat est plus que probant.

L'équipe de traduction vous fournit donc un PDF de grande qualité qui semble faire envie à certaines personnes utilisant la version originale :) À ce sujet, il est évident qu'un travail sera entrepris pour améliorer le PDF de la version originale.

Dernière information sur la traduction, il existe maintenant plusieurs sites pour la traduction :

• le site des utilisateurs ;
• et celui des développeurs.

En cas de problème avec la documentation, n'hésitez pas à saisir un rapport sur le site des développeurs !

Attention, ce PDF ne sera disponible que pour les versions 8.1.3 et ultérieures.