Modelet Math

Objectifs

Ce modelet permet d'intégrer dans un modèle documentaire des ressources mathématiques sous leur forme ODF, MathML ou LaTeX (depuis SC3.4.1).

Informations générales

Informations techniques

Mode d'emploi

Pour tester ce modelet

  1. Installer SCENARIbuilder, version 3.4.1 minimum.
  2. Via un client Subversion, récupérer l'atelier de démonstration Math à l'adresse suivante :
  3. Créer un atelier dans SCENARIbuilder en pointant sur le dossier précédemment créé.
  4. Dans cet atelier, créer un environnement de test (demo/math.wsptest) et pointer la définition de l'atelier demo/math.wspdef.
  5. Lancer la compilation du test.
  6. Dans SCEANRItest, éditer/créer les formules de math; exemple présents dans test/mml/res, test/odf/res et test/tex/res.
  7. Sélectionner l'item de publication : test/publi.genWeb pour générer le site web ou test/publi.genOd pour générer le document ODT.
  8. Consulter les documents générés.

Pour exploiter ce modelet dans un modèle documentaire

Le modelet réside dans l'espace "math" de l'atelier de SCEANRIbuilder qui a servi pour le test précédent. Pour chaque format mathématique supporté (ODF, LaTeX, MathML), vous trouverez les items suivants :

  • un .model : c'est l'item qui permet de déclarer la ressource (dans le wspDef). Vous ne devriez pas avoir à le modifier.
  • pour la publication openDocument :
    • 1 transformerList : _genOd.transflist;
    • 2 transformers : xxx_od.transf et xxx_od@…. Ces derniers permettent latransformation des ressurces en ODF pour l'intégration correcte dans l'ODT généré. Remarque : L'appel de ressource mathématique insérée dans le flux du texte se fera avec l'axis inline.
  • pour la publication web :
    • 1 transformerList : _genWeb.transflist;
    • 2 transformers : xxx_web.transf et xxx_web@…. Ces derniers appellent un des transformers ci-dessous (via un axis), permettant l'intégration de la formule sous sa forme MML, PNG ou SWF. Les formules sont intégrées par défaut sous leur forme MathML. Pour changer celà, il suffit de spécifier 'png' ou 'swf' à le place de 'mml' dans xxx_web.transf et xxx_web@….
      • transformer xxx_web@… : retourne la formule sous sa forme MathML;
      • transformer xxx_web@… : retourne la formule sous sa forme PNG;
      • transformer xxx_web@… : retourne la formule sous sa forme SWF;

Remarques :

  • Format MathML : pour les modélisateurs avancés, il est possible de paramétrer les transformations apportées à ce fichier MathML avant son intégration au site web ou à l'ODT.
  • Format ODF : le transformer odf_web@… est un freeTransformer. Il permet de transformer un ODF en MathML. Pour les modélisateurs avancés, il est possible de paramétrer dans ce transformer une XSL modifiant le MathML extrait de cet ODF (cf : math/odf/_res/web@mml/bs.doss/sfile_odf_Amml/odMmlToXhtmlMml.xsl).
  • Format LaTeX : en plus d'une intégration classique sous la forme d'une ressource externe, il est possible d'insérer directement la formule dans le flux d'un texte. Plus d'info ici.

Attention !

Attention, il est important de ne pas renommer ou déplacer les fichiers de l'espace math : cetains models et primitives sont codés en free.