WebJaxe peut s'installer très facilement, même chez des hébergeurs gratuits, et grâce à Java l'édition des contenus fonctionne sur tous les systèmes d'exploitation.
Sur le serveur
- Un serveur web
- PHP 4 ou PHP 5
- mysql
Avec PHP 4, il est aussi nécessaire d'installer les librairies sablotron et iconv.
Remarque
Il suffit en général d'installer MAMP (sur Mac), XAMPP (sur Linux) ou WAMP (sur Windows), qui incluent Apache, Mysql et PHP. On peut aussi installer ces logiciels séparément, mais il ne faut pas oublier le module mysql pour PHP. Certains paquets doivent être installés sur Linux en plus de PHP : php5-mysql pour le lien avec la base de données, php5-xsl pour les transformations de documents XML, et php5-gd pour le traitement des images.
Pour les clients
- Un navigateur web pas trop vieux (par exemple Firefox 2+, Safari 2+, Internet Explorer 6+)
- Java 1.6+ (préinstallé sur de nombreuses machines, on peut le télécharger si nécessaire à partir de java.com) OU un navigateur récent (en utilisant l'éditeur Daxe au lieu de Jaxe)
Activation de fonctions PHP
Avec PHP5, les extensions de PHP php_xsl et php_gd2 doivent être activées, mais php_domxml doit être désactivé (c'est une extension pour PHP4).
Avec PHP4, les extensions de PHP php_xslt, php_domxml et php_gd2 doivent être activées. Ces extensions sont activées par défaut dans certaines distributions (comme MAMP sur Mac), mais pas sur d'autres (comme WAMP sur Windows).
Placement du dossier
Le dossier de WebJaxe peut être placé où on le souhaite dans le site web. La racine du site correspond souvent à un dossier appelé htdocs, dans lequel on peut placer le dossier webjaxe.
Permissions des fichiers
L'utilisateur PHP doit pouvoir accéder en écriture aux répertoires site_config, contribXML, sites, historique, poubelle et tmp. Il faut s'assurer que les permissions sont correctes avant de lancer WebJaxe pour la première fois.
Création de la base de données
Initialisation
Ouvrir la page suivante avec un navigateur :
http://[votre_site_web]/[répertoire_de_WebJaxe]/index.php
Remarque
Si votre serveur web fonctionne sur un autre port que le port par défaut (80), il faut bien sûr remplacer http://[votre_site_web] par http://[votre_site_web]:[numéro de port].
Pour créer la base de données de WebJaxe, il faut indiquer le login et le mot de passe de l'administrateur de la base de données (souvent 'root' / '' ou 'root' / 'root' par défaut).
La base de données créée est nommée webjaxe par défaut.
Il faut ensuite entrer les informations pour créer le compte de l'administrateur WebJaxe, qui sera le premier utilisateur du site.
La gestion du mail est utilisée pour vous alerter quand un nouveau utilisateur est inscrit, vous avez 3 options:
- Désactivé : l'envoi du mail est désactivé
- Fonction mail PHP : l'email vous sera envoyé en utilisant à la fonction mail de votre hébergeur
- Serveur SMTP : il faut entrer l'adresse du serveur SMTP de votre hébergeur ou fournisseur
Ceci fait, il suffit de cliquer sur le bouton "Créer la base de données" pour terminer l'initialisation de WebJaxe.
Serveur d'images d'équations TeX
Ceux qui souhaitent utiliser les équations avec la syntaxe TeX dans le langage XPAGES doivent aussi configurer un petit serveur supplémentaire. En effet, l'applet Jaxe et son plugin pour XPAGES ne contiennent pas de processeur TeX (ce serait trop lourd !). Le plugin fait donc appel à un serveur, en envoyant le texte d'une équation à laquelle le serveur répond par l'image correspondante. Ce serveur se trouve déjà dans le dossier serveurtex de WebJaxe, mais il nécessite l'installation des programmes latex, dvipng et ImageMagick. Il faut aussi modifier le fichier config/XPAGES/XPAGES_config.xml à la main pour indiquer le serveur à utiliser (rechercher "tex.php" pour le retrouver). La valeur par défaut correspond à un serveur qui n'est pas forcément disponible. Les chemins vers les commandes convert et tex2png peuvent si nécessaire être modifiés dans tex.php. Il faut aussi s'assurer que l'utilisateur PHP puisse écrire dans serveurtex/CACHE.
Les informations sur l'accès à la base de données sont enregistrées dans un fichier site_config.xml, situé dans le répertoire site_config. Ce répertoire est protégé pour le serveur web Apache avec un fichier .htaccess. Ceci interdit la lecture du fichier site_config.xml directement depuis le web, tout en permettant son utilisation par WebJaxe.
Cette protection ne fonctionne qu'avec le serveur web Apache, et seulement si les .htaccess sont autorisés (cela se fait avec l'instruction AllowOverride dans httpd.conf). Si vous utilisez un autre serveur web, comme par exemple IIS, il vous faudra protéger le répertoire site_config d'une autre manière, par exemple en éditant ses propriétés et en interdisant sa lecture. La façon de faire est malheureusement différente d'un serveur à l'autre.
On peut aussi ajouter un .htaccess dans les autres répertoires pour contrôler l'accès en lecture.
Pour éviter d'avoir à gérer à la fois des utilisateurs Apache et des utilisateurs WebJaxe pour contrôler l'accès aux sites, on peut utiliser une redirection vers le script PHP lecture_fichier.php, avec l'extension Mod_rewrite d'Apache. Par exemple, il suffit de mettre le code suivant dans un .htaccess dans les dossiers contribXML et sites pour s'assurer que seuls les utilisateurs WebJaxe autorisés puissent accéder aux fichiers XML et aux sites générés avec WebJaxe :
<IfModule mod_rewrite.c>
RewriteEngine on
RewriteRule ^(.*)$ ../php/partie_utilisateur/lecture_fichier.php?fichier=%{REQUEST_URI}
</IfModule>
Ce code redirige les requêtes en lecture de tous les fichiers du répertoire vers le script lecture_fichier.php, qui ne renvoie le contenu des fichiers que pour les utilisateurs autorisés (qui doivent être connectés sur WebJaxe).
Par ailleurs, pour une meilleure protection des mots de passe sur le réseau, il est conseillé d'utiliser https pour accéder à WebJaxe.
Le répertoire de WebJaxe contient des sous-répertoires avec des fichiers propres à WebJaxe, et d'autres avec des fichiers propres à l'installation locale. Pour mettre à jour WebJaxe, il suffit de recopier les sous-répertoires propres à WebJaxe : config, daxe, design, editeur_config, jaxe, langues, php, serveurtex ainsi que le fichier index.php. Si la base de données doit être mise à jour, l'utilisation sera bloquée jusqu'à ce qu'un administrateur se connecte.