Lazi

lazi

Présentation

Le programme en ligne de commande "lazi" sert d'interface pour utiliser les autres programmes. Il permet de lancer translate, compute et xsltproc en une seule commande. Par exemple

lazi --inputs "$LAZI_BASE|utils/lazi.inputs" --format html --viewer "firefox %s" --command commands-lazi.xml

lance les commandes du fichier commands-lazi.xml et affiche le résultat sous forme html dans le navigateur web firefox. L'option --inputs "$LAZI_BASE|utils/lazi.inputs inclue tous les fichiers sources indiqués dans le fichier utils/lazi.inputs, $LAZI_BASE| donne la base des chemins de ces fichiers. Le fichier commands-lazi.xml peut avoir les formules Lazi dans le format "sources".

Sans l'option --command lazi sert à traduire des fichiers (voir les options plus bas).

Les fichiers de travail seront créés dans un répertoire temporaire qui sera détruit automatiquement (ce qui peut empêcher le navigateur de sauver le fichier visualisé). Pour ne pas détruire ce répertoire ajouter l'option "--debug".

Ce programme est écrit en perl.

Options

./lazi --format FMT [ --xmlinput FILE ] [ --output FILE ] [ --debug ] [ --simplify ] --inputs [BASE_PATH1]|FILE1 ... --inputs [BASE_PATH1]|FILEn --input FILE1 ... --input FILEn

Arguments :

  • --command COMP COMP est le fichier des commandes, dans ce fichiers les formules peuvent être au format "sources" mais aussi xml.
  • --all Convertit tous les fichiers sources en a fichier des définitions. Incompatible avec l'option "--command".
  • --xmlinput FILE Option pour traduire les formules d'un fichier XML comportant des tag "formula". FILE est le chemin du fichier.
  • --output FILE Fichier de sortie (STDOUT si l'option n'est pas fournie).
  • --format FORMAT Format de la sortie, peut être :
    • html : uniquement pour l'option "--command".
    • sources : Fichier XML où les formules sont au format "sources".
    • xml : Fichier XML où les formules sont au format "xml".

  • --viewer PROG Lance PROG pour visualiser le fichier de sortie (pour "--command"). PROG peut contenir la chaîne "%s" qui sera remplacée par le fichier de sortie (dans ce cas le chemin spécifié par l'éventuelle option --output ne doit pas contenir d'espace).
  • --input FILE FILE est le chemin d'un fichier source à inclure.
  • --inputs DIR DIR est le chemin d'un dossier devant contenir un fichier "lazi.inputs". Ce fichier contient 4 sortes de lignes:
    • CHEMIN : équivaut à l'option "--input DIR/CHEMIN"
    • !INC DIR2 : équivaut à l'option "--inputs DIR2" si DIR2 est un chemin absolu et sinon "--inputs DIR/DIR2".
    • Commentaire : "#..."
    • Ligne blanche

  • --pathexec PATH Chemin à ajouter pour trouver les exécutables lancés par lazi.
  • --pathres PATH Chemin où chercher les fichiers de ressources (acutellement "lazi.xsl"). Peut aussi être fourni par la variable d'environnement LAZI_RES_PATH.
  • --debug Les commandes sont affichées, le répertoire de travail n'est pas détruit et son chemin est affiché.
  • --simplify Demande à translate de simplifier les expressions.

@todo (mettre à jour la doc)