Installation des outils d'édition WYSIWYG et de refactoring

Pré requis

TWiki (version du 01 Février 2003)

Nous avons développé nos services sur cette version de TWiki. Nous pouvons difficilement prédire leurs comportements sur de futures versions.

Perl 5.6+

Les services Web ont été développés et principalement testés avec la version 5.8 de Perl. Aucune fonctionnalité spécifique à cette version n?a été utilisée et nous n?avons pas constaté de problème avec la version 5.6.

Librairies Perl

SOAP::Lite 0.55+

SOAP::Lite est requis pour pouvoir utiliser les services Web nécessaires aux applications de refactoring et d?édition WYSWIYG.

XML::TreeBuilder 3.08+ (optionnel)

Cette librairie n?est requise que si le service de notifications est activé.

Ressources

Service

• Hierarchie de fichiers pour services:
  

Le répertoire bin contient des scripts Perl :

• jnlplauncher : un script qui génère des descripteurs Web Start JNLP à la volée.
• service : un serveur SOAP de type script CGI.

Le répertoire lib contient les modules Perl requis par les services Web ainsi qu?un fichier de configuration :

• Service.cfg : le fichier de configuration.
• Service.pm et le répertoire Service : les implémentations des services.

Editeur WYSIWYG

Le répertoire twe contient les ressources de l'éditeur :

• twe
  • twe.jar : jar exécutable signé et déployable sur un serveur TWiki
  • twe.jnlp : le descripteur Java Web Start (cf. installation de l'éditeur)
  • twe.src.jar : le code source de l'éditeur

Outil de refactoring

Le répertoire refactoring contient les ressources de l'outil de refactoring :

• refactoring.jar : jar exécutable signé et déployable sur un serveur TWiki
• Refactor.jnlp : le descripteur Java Web Start (cf. installation de l'éditeur)
• src : répertoire contenant le code source de l'éditeur
• doc : la documentation

Procédure

Service

Copie de fichiers

Copier le contenu du répertoire bin dans *TWiki Install Dir*/bin, et le contenu du répertoire lib dans *TWiki Install Dir*/lib. Il ne faut pas oublier de donner les permissions d?exécution aux scripts jnlplauncher et service. Il sera peut être nécessaire de modifier les entêtes des scripts pour être exécutables par l?interpréteur Perl sur votre configuration.

Configuration

Ouvrir dans un éditeur de texte le fichier Service.cfg. Les valeurs données par défaut peuvent être laissées telles quelles à l?exception de: endpoint et jnlpDir. endpoint doit définir l?url du serveur SOAP, par exemple http://hostname/bin/service. jnlpDir doit définir le répertoire où le script jnlplauncher devra chercher les descripteurs Web Start JNLP, par exemple /usr/home/httpd/twiki/jnlp/.

Editeur WYSIWYG

Copie de fichiers

Copier les fichiers twe.jar et twe.jnlp dans le répertoire spécifié par jnlpDir dans Service.cfg.

Configuration du descripteur Java Web Start

Ouvrir dans un éditeur de texte le fichier twe.jnlp. Par défaut le codebase est placé sur la machine de test du projet ( par défaut : http://miageprojet.unice.fr/twikitestnice/) il faut modifier cette valeur par l'URL ou l'ont peu télécharger les fichiers twe.jar et twe.jnlp.

Exemple : jnlp spec="1.0+" codebase="http://twikiserveur.fr/jnlp/">

Modification des templates TWiki

Pour permettre l'édition en ligne d'un topic TWiki, il faut ajouter un lien dans le template correspondant au topic considéré.

Ce lien est le suivant : a href='/twiki/bin/jnlplauncher/Minfo03/TerBn1Installation?jnlp=twe.jnlp> (voir "raw view" pour le lien réel)

Il s'agit d'un appel au script jnlplauncher avec en argument le fichier jnlp et ses arguments.

Outil de refactoring

La procédure d'installation de l'outils de refactoring est trés proche de celle de l'éditeur.

Copie des fichiers

Il faut copier les fichiers refactoring.jar et Refactor.jnlp dans le répertoire jnlpDir dans Service.cfg, puis modifier le codebase dans le fichier Refactor.jnlp à l'aide d'un éditeur de texte, pour mettre la valeur de l'URL d'accés à ces fichiers depuis internet ou l'intranet (http://nom_serveur/twiki/ par exemple).

Modification des templates TWiki

Pour lancer l'application depuis une page web, il faut ajouter le lien suivant dans les templates :

a href="/twiki/bin/jnlplauncher/Minfo03/TerBn1Installation?jnlp=refactoring.jnlp">Refactoring tool

• Set ALLOWTOPICCHANGE = RomainRaugi, LamureMaxime, MandrioliDamien, MarioDIMICELI, ColasNahaboo, EnseignantsGroup, MichelBuffa

-- RomainRaugi - 07 Jun 2004
to top