Adélia Print Engine (APE) est un moteur de création de documents.
Ce moteur s'exécute dans un environnement Java (version 1.8 minimum).
La création d'un document se déroule en deux étapes distinctes :
Merge : Génération d'un document dans un langage intermédiaire
Cette première étape consiste à créer dynamiquement un document. Sa réalisation nécessite de fournir :
- Un ensemble de données brutes à afficher dans le document : le modèle de données,
- Un ensemble de règles de mises en page et de transformation des données : le gabarit.
Ce processus s'appuie sur l'exécution d'un processeur de gabarit (ou template engine).
Le principe d'un tel processeur est de combiner (ou de fusionner) un gabarit (ou template) avec un modèle de données (ou data model) pour produire une sortie formatée (le document résultat).
Le template doit être vu comme un squelette du document à produire : il contient les règles de disposition du contenu (mise en page) du document résultat et des instructions (écrites dans un langage de programmation spécifique au moteur) permettant d'exploiter le modèle de données, et d'injecter ces données à des positions précises dans la sortie formatée.
L'exécution du template avec le modèle de données par le processeur permet de produire le document résultat. D'une manière générale, un langage de programmation de templates supportent les notions suivantes :
- Parcourir le modèle de données,
- Créer des variables de programmation et des fonctions utilisateurs,
- Manipuler du texte,
- Inclure des sous-templates,
- Proposer des instructions algorithmiques comme les évaluations conditionnelles, les boucles, etc.
Le processeur de template utilisé pour cette étape de création de document est Apache FreeMarker.
Il s'agit d'un processeur Java permettant de produire une sortie texte.
Les templates exécutés par ce processeur sont écrits en FTL (FreeMarker Template Language). ↑ Haut de page
Transform : Transformation d'un document
Cette deuxième étape consiste à transformer un document vers le format d'édition demandé.
Ceci implique que le document fourni en entrée de ce processus n'est pas directement exploitable par l'utilisateur : le document est écrit dans un langage intermédiaire de mise en forme de documents, indépendant d'un support donné (écran, papier, etc.) et d'un format final d'édition donné (format Microsoft Word, EPUB, PDF, Postscript, etc.).
L'APE impose que les documents fournis en entrée de ce processus soient écrits dans le langage XSL-FO (eXtensible Stylesheet Language - Formatting Objects). Il s'agit d'un langage de balises XML de description de contenu et de rendu d'un document.
Cliquez ci-dessous pour plus d'informations :
Le langage XSL-FO fait partie du langage XSL, qui décrit un ensemble de technologies du W3C pour la transformation et le formatage de données XML. Les autres parties de XSL sont XSLT et XPath.
Le moteur de transformation utilisé pour cette étape est Apache FOP. Il s'agit d'un moteur Java permettant de transformer des documents XSL-FO dans des formats d'édition comme PDF, Postscript, PCL, PNG, etc.