Politique de gestion des fichiers de ressources de TXM

Objectif

Avoir une architecture de déploiement et d'utilisation compatible entre la version pour poste et la version portail (surtout corpus binaires, scripts de démarrage et scripts R).

Définir quels sont les usages et accès aux fichiers de ressources que l'on souhaite donner aux utilisateurs.

Les ressources sont fournies au moment du setup ou par le biais de mises à jour, et utilisées pendant une session de travail.

TXM pour poste livre divers types de fichiers à l'installation :

  • des corpus binaires
  • des macros (Groovy)
  • des scripts de démarrage start.groovy et stop.groovy
  • des CSS
  • des XSL
  • des scripts R

Ces fichiers sont tous accessibles à l'utilisateur dans le répertoire HOME de TXM et ont tous un potentiel d'altération du comportement de TXM différent. Il s'agit de définir une politique qui permette à l'utilisateur de pouvoir modifier ces fichiers tout en préservant la cohérence (jusqu'à un certain point à préciser) du fonctionnement de la plateforme.

aujourd'hui, les commandes qui utilisent R ne stockent/exposent pas les lignes de commandes R dans des fichiers *.R. Ça pourrait être pratique pour debugger ou bien modifier le comportement de ces commandes

Méthode

Dans un premier temps, préciser la documentation de ces fichiers et leurs divers impacts sur la documentation de TXM.

Puis concevoir une dichotomie : zone système / zone utilisateur. La première où l'impact de modifications sur le fonctionnement de la plateforme est maximal et non vérifiable/protégeable. La seconde n'ayant pas d'impact majeur sur le fonctionnement.

Puis implémenter des moyens de passer d'une zone à l'autre. Par exemple: récupérer des macros systèmes, les modifier et une fois qu'on est sur de soit les basculer en système.

Solution

Macros et Scripts

On différencie une zone des macros/scripts systèmes et zone des macros/scripts de l'utilisateur :

  • scripts
    • system
      • org
        • txm
          • scripts
            • importer
              • txt
              • xml
            • sw
            • export
            • tal
          • macro
            • importer
            • txt
            • export
            • command
          • ui
    • user
      • org
        • txm
          • scripts
            • importer
              • txt
              • xml
            • sw
            • export
            • tal
          • macro
            • importer
            • txt
            • export
            • command
          • ui

Caractéristiques :

  • Les packages “user” ont priorité sur les packages “system”.
  • Une vue ou plusieurs permettent de gérer les fichiers (copie, suppr…)

Étape 1 - Documentation

Les répertoires de TXM HOME : css, xsl, scripts…

Macros

celles du package org.txm.macro

Scripts Groovy

lanceurs des modules d'imports

CSS

utilisées par les modules d'import

XSL

qu'on peut utiliser en front XSL

public/politique_fichiers.txt · Dernière modification: 2018/07/06 10:46 par matthieu.decorde@ens-lyon.fr