Legi2pdf

Latest release: Legi2pdf 0.9.0

Project Description

Domaine fonctionnel de l'application.

Le travail d'une assemblée est basé sur un ensemble de documents. Que ce soit des propositions de décrets, des rapports de commissions, ..., il est important que ceux-ci soit rapidement disponible pour permettre une meilleure publicité des débats

L'objectif couvert par ce module, est la production automatique de documents dit "camera ready" comme celui ci-dessous

La production est réalisée par l'utilisation d'un éditeur adapté à la création de documents au format définit pour le Parlement: XML. Le format des documents produits par cet outils est une variante du format standard DOCBOOK (voir http://www.docbook.org; vous pouvez également accéder au schéma de cette variante ici.). Ce format neutre séparant complètement la structure du document de ses aspects de présentation, il permet une publication "multi-canaux" en particulier internet (en HTML) et papier (via un format PDF).

La conversion du XML vers le PDF (la composition ou mise en page du document) est un travail qui peut être délicat et a historiquement été du ressort de spécialistes.

Le programme "LaTeX" implémente un grand nombre de règles de typographie très avancées, et, en particulier les règles spécifiques à la langue française. Il permet donc de produire automatiquement le format PDF, en donnant un résultat très professionnel.

Le module réalisé permet de convertir le format XML vers un format intermédiaire "LaTeX" et ensuite faire tourner le moteur de composition LaTeX pour produire le résultat final en PDF. Concrètement ce module est une spécialisation du module db2latex dont il dépend.

Liste non exhaustive des focntionnalités couvertes.

Police de caractères

Les documents produits s'approche au mieux de la police de caractères utilisée précédement. Cette police de caractère n'est hélas disponible que commercialement. Pour information cette police est la police Sabon. Elle ne constitue pas un prérequi à l'utilisation du module. En effet, si Latex ne la trouve pas, il la remplace par le police définie par défaut.

Caractères "spéciaux"

Certains documents comportent des caractères dit "spéciaux" qui ne sont pas les lettres habituelles. Normalement tous les caractères courants sont supportés, en particuliers les guillemets, apostrophes, tirets longs, le caractères euro.

Marges

Les documents produits s'approche au mieux des marges historiquement utilisées.

2 colonnes

Les documents sont rendus en 2 colonnes.

Page de garde

La page de garde est conforme aux règles en vigueur au Parlement de la communauté française.

Césure

LaTeX prend en charge la césure automatique, conformément aux règles de la langue française.

Justification horizontale

Les textes sont justifiés à gauche et à droite.

Justification verticale

LaTeX assure la justification verticale, afin que l'espace vertical dans chaque colonne soit complètement occupé.

En-tête et pied de page

Numéros de page et numéro/session de document sont placés à  un endroit spécifique. Conformément à l'usage, une différence est faite entre les en-têtes des pages de gauche et de droite.

Notes de bas de page

Les notes de base de page sont rendues en bas de colonnes, ou en fin de tableau lorsqu'il est flottant.

Numérotation des sections

Les sections sont numérotées de manière  automatique. Les numéros de section ne sont pas issus des documents XML.

Table des matières

La table des matières est produite automatiquement pour chaque document. Elle est produite en utilisant les éléments de structure du document (les titres de section), cela signifie que les titres indiqués dans la table des matières ne différent pas  des titres utilisés dans le corps du document.

Tableaux

Les tableaux présentent une problématique particulière. Il s'agit d'éléments pour lesquels les aspects présentations sont fort importants, et donc la représentation visuelle obtenue durant la création du tableau influe fortement sa composition. Dans ce cas, l'outil de mise en page utilisé en prévisualisation lors de la création du tableau  n'est pas le même que celui utilisé pour le rendu final (LaTeX). Il se peut donc que des différences apparaissent.

De plus, la prévisualisation dans l'outils d'édition fait sur 1 colonne, alors que le rendu se fait en 2 colonnes. Un tableau créé sur toute la largeur de la page dans l'éditeur ne peut pas être rendu sur une seule colonne.

L'approche retenue est la suivante. Les "petits" tableaux occupant moins de la moitié de la page dans notre éditeur sont rendu sur une seule colonne en PDF. Les tableaux plus grand sont rendus sur toute la largeur de la page.

Comme la largeur de page dans notre éditeur n'est pas exactement la même que la largeur de page du PDF produit, la largeur des colonnes est ajustée en proportion.

Tableaux longs

Les tableaux se déroulant sur plusieurs pages sont supportés.

Images et "objets"

Les images incluses dans les documents, ainsi que les "objets" (tels que tableaux ou graphiques Excel 'format WMF') sont convertis en rendus le plus fidèlement possible en format PDF.

Pour les images, la fidélité dépend bien entendu de la résolution de l'image source.

Pour les objets, la fidélité dépend beaucoup de la qualité du programme wmf2eps. En effet, le format natif utilisé pour le rendu de ces objets à l'écran est spécifique à Windows (WMF) et doit être convertit en PDF. Cette conversion ne peut se faire avec une fidélité garantie que sous Windows même. Les essais que nous avons réalisés avec le programme portable wmf2eps nous semblent satisfaisants.

Eléments flottants

Les tableaux et images sont généralement des éléments qui occupent beaucoup de place sur la page. LaTeX dispose d'algorithmes sophistiqués permettant de créer des documents avec un aspect équilibré, en plaçant ces éléments aux endroits les plus appropriés. Pour fonctionner, cet algorithme doit pouvoir prendre la "liberté" de déplacer ces éléments par rapport à leur emplacement d'origine dans le texte.

Ce mécanisme a un impact sur la manière de rédiger le texte. En effet, on ne peut plus référencer un tableau ou une figure en utilisant des termes comme "ci-dessus" ou "ci-dessous", mais on doit les référencer en indiquant leur numéro ou leur légende. Par ailleurs, de tels éléments flottants ont typiquement une légende.

Exemple de son utilisation

Le Manuel de l'utilisateur est une illustration du résultat obtenu par l'utilisation conjointe du module Legi2pdf et de l'éditeur adapté aux besoins du parlement.