Installation
Il est recommandé d'utiliser l'outil climax pour l'installation et l'utilisation de MaX.
Démarrage rapide
climax new mon_projet
cd mon_projet
climax demo
climax start
Pour afficher l'aide de climax :
climax --help
Fonctionnement général
L'application est scindée en 2 blocs :
- le cœur : déclaration des routes/fonctionnalités de base, accès aux sources xml et à la configuration, système de templating, traduction etc.
- les bundles : fonctionnalités additionnelles.
Les sources XML à afficher sont stockées dans une base nommée max d'une instance de BaseX.
Les bundles
Un bundle ajoute une (ou des) fonctionnalité(s) à MaX (xquery, xsl, js, etc.). On distingue les bundles de vocabulaire des autres bundles. Pour fonctionner, un (et un seul) bundle de vocabulaire doit être activé. Sans bundle de vocabulaire, aucun rendu HTML n'est opéré par le cœur de MaX.
MaX propose de base les bundles :
- max-dumb-xml : Bundle de vocabulaire d'exemple. Affiche un listing des sources, n'opère aucune transformation sur les documents.
- max-export : Export des sources XML stockées dans MaX (accessible depuis la route
/sources.zip). - max-dev : Fonctionnalités d'assitance au développement, actives uniquement en environnement 'dev'.
Bundle de vocabulaire
Un bundle de vocabulaire est spécialisé dans le rendu d'un vocabulaire XML (TEI, EAD, etc.).
Code source
Le code source est disponible ici.