<- Retour aux sources

Installer et configurer WikiniMST 12.10


Note: Consulter la page «Pour mettre à jour WikiniMST» si vous avez déjà une version de WikiNiMST d'installée.

Voici les étapes et conseils pour installer WikiNiMST sur votre serveur.

1. Décompressez les sources dans un répertoire web (ex. : wikinimst).
(regh: Si vous installez votre Wiki sur un serveur de chez Free vous devrez aussi créer un dossier "sessions" à la racine du wiki )

2. Donnez les droits d'écriture à apache (chgrp apache nomdossier/ -R, chmod 775 nomdossier/ -R) dans ce dossier (et sous-dossiers), car l'installeur automatisé écrira dans un fichier de configuration (wakka.config.php). Si vous n'avez pas accès à ces droits, le fichier de configuration pourra être créé localement puis transféré par ftp sur le serveur.

3. Rendez-vous dans phpMyAdmin (notre gestionnaire de base de données préféré) pour créer une base de données (ex.: wikinimst).

4. Dans votre navigateur, rendez-vous à l'adresse de votre wikinimst (ex. : http://serveur.com/wikinimst).

5. Complétez les champs en suivant les instructions. Il y a d'autres indications importantes sur la page d'accueil de votre nouveau wiki.

5.1 Éditez le fichier wakka.config.php afin d'y inscrire les variables nécessaires comme:
  • "header_action" => "header",
  • "footer_action" => "footer",
  • "url_site" => "http://adresse.site/", (doit terminer par / )
  • "upload_permission" => "oui",
  • "admin_wiki" => "Nomwiki",


5.2 Pour modifier/gérer le thème: ThemesWikiniMST ou utiliser le thème pour mobile WikiniMSTMobile (version 10.12 et +)

5.3 Pour contrôler l'inscription au wiki (version 10.06 et +).
  • Créer un compte pour l'administrateur du wiki.
  • Inscrire ce nom dans le fichier wakka.config.php, variable "admin_wiki" => "Nomwiki",
  • Modifier l'action {{usersettings}} pour {{userlogin}} dans la page ParametresUtilisateur. Ceci ne fait qu'afficher un formulaire de connexion, pas d'inscription.
  • Créer une page avec l'action {{adminregister}}. Cette page affichera, pour l'admin wiki seulement, un formulaire de création de compte.

5.4 Gestion du menu personnalisé: ActionsIncludePersoEtGroupe


Note: Si vous installez le wikinimst sur un serveur qui n'est pas dans la même zone horaire que vous, on peut changer le tout dans le fichier wakka.php, ligne 256, on remplace cette ligne "time = now(), ". par "time = DATE_SUB(NOW(), INTERVAL 5 HOUR), ". où on soustrait le nombre d'heure. On change DATE_SUB par DATE_ADD si on doit ajouter des heures.


Fin d'une installation de base



La suite est pour activer certaines fonctions du WikiNiMST


6. Utilisation des groupes
 

La fonction des groupes ne fonctionne que pour 1 seul groupe dans la zone de permissions. On ne peut donc pas placer deux groupes comme ayant droit de lire ou d'écrire dans la page.

Créez-vous un compte d'utilisateur. Ex.: PrenomNom (Pas d'espace ni d'accent)

Rendez-vous dans votre phpMyAdmin (gestionnaire de base de données), sélectionnez la base de données de votre WikiniMST, puis modifier le nom dans la table : wikini_groups pour que vous soyez administrateur des groupes (inscrivez votre WikiNom au lieu de PrenomNom qui est déjà inscrit).

Créez une page dans votre WikiniMST (ex.: GestionGroupes). Insérez-y ce code et enregistrez:
=====#B# Gestion des groupes #B#=====
     
 - ** Modification/suppression des groupes :**
 -Cliquer sur le nom du groupe pour le modifier :
   {{listgroups}}
             
 - ** Créer un nouveau groupe («Enter» pour confirmer) :**
  ""<form action="wakka.php">
  Indiquer le nom de la page à créer :
  <input type="hidden" name="wiki" value="EditGroup" />
  <input name="group" size="15" class="text" />
  </form>""


Cliquez sur le ? au côté du nom du Groupe admins et ajoutez ceci:
{{editgroup}}
  //Pour supprimer un groupe, il suffit de supprimer (touche DEL) tous les utilisateurs de la boîte ci-dessus.//


N.B.: Il y aura un message d'erreur qui vous dit que le groupe est vide. Rafraichissez la page.

Maintenant, les membres du goupes admins peuvent créer/modifier les groupes existants.


 

7. Entête, pied de page, menu de gauche

Pour personnaliser l'en-tête, éditer la page EnTete. Pour le menu de gauche et le pied de page, inscrivez dans le fichier wakka.config.php le nom de ces pages dans la variable: "footer_page"=>"PagePied?" pour le pied de page et "menu_page" => "PageMenuGauche" pour le menu de gauche. (ne pas mettre le ? à la fin de PageEntete?, PageMenu? et PagePied?, il est automatiquement ajouté ici)

  • Ne pas utiliser la fonction «upload» pour insérer des images dans ces pages, car elles ne seront pas visibles de partout dans le Wikini. Faites plutôt un lien vers des images existantes sur le web.
  • Ne pas utiliser le code == dans les page entête, menu et pied de page car l'action TOC ne pourra pas fonctionner correctement. Utiliser plutôt le code html correspondant: <h2>Titre</h2> (avec les doubles guillemets).

  • Menu personnalisé
    • On peut utiliser l'action {{includeperso}} pour insérer une partie de menu personnalisée. De même pour un groupe. Voir ActionsIncludePersoEtGroupe.



 

8. Vous pouvez activer la fonction de notification de modifications par courriel en écrivant «oui» dans la ligne suivante du fichier wakka.config.php: "notifier_mail" => "oui",
Le serveur où est installé wikinimst doit avoir un serveur de mail (postfix ou autre) actif. Ensuite, au moins 1 nom d'un utilisateur doit être inscrit dans la zone de permission en écriture de la page.


 

9. Vous pouvez activer la fonction d'attachement de fichiers à une page wiki en écrivant «oui» dans la ligne suivante du fichier wakka.config.php : "upload_permission" => "oui",
N'oubliez pas de créer un dossier upload_dir en lecture/écriture sur votre serveur (théoriquement ce répertoire sera créé automatiquement si apache a les droits d'écriture dans le répertoire du wiki).


 

10. Formules mathématiques
Note de PL: On doit pouvoir installer des applications sur le serveur qui héberge le wiki.

Activer la fonction de visualisation de formules mathématiques (sur serveur Linux seulement)
  • Installez le paquetage nommé ocaml sur votre serveur.
  • Vérifiez si les paquetages ImageMagick?, dvips, convert, gcc, ghostscript et tetex-latex sont installés, sinon installez-les.
  • Téléchargez l'archive du Mediawiki, puis transférez sur votre serveur le répertoire /math (racine de votre installation de wikinimst).
  • Entrez en mode console dans le répertoire /math créé et faites la commande make.
  • Copiez le fichier texvc (nouvellement créé) dans le répertoire /formatters de votre installation wikini.
  • Création de la table math. Dans votre outil de gestion des bases de données, entrez cette commande qui créera une table nommée: wikini_math.
CREATE TABLE `wikini_math` (
  `math_inputhash` varchar(16) NOT NULL default '',
  `math_outputhash` varchar(16) NOT NULL default '',
  `math_html_conservativeness` tinyint(1) NOT NULL default '0',
  `math_html` text,
  `math_mathml` text,
  UNIQUE KEY `math_inputhash` (`math_inputhash`)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

  • Éditez le fichier wakka.config.php pour y inscrire les chemin vers le fichier texvc (math_texvc_path) et le répertoire math_img(math_dir_sys).
    • Pour aller un peu plus loin dans la configuration:
      • Valeurs possibles pour math_render_type :
        • 0 : "Toujours produire une image PNG",
        • 1 : "HTML si tres simple, autrement PNG",
        • 2 : "HTML si possible, autrement PNG",
        • 3 : "Laisser le code TeX? original",
        • 4 : "Pour les navigateurs modernes" (mathml)
      • Valeurs possibles pour ghostscript_png_ext :
        • Versions anciennes de ghostscript : ".png.0"
        • Versions récentes de ghostscript : ".png"


 

11. L'action calendrier a été retirée du WikiNiMST depuis la version 7.12, car elle n'est plus supportée par le développeur et n'est pas fonctionnelle à 100%.


 

12. Choix du thème.
Par défaut, le thème MST est installé (un thème dépouillé). Pour le modifier, voir cette page.


 

13. Désactivation des commentaires
Dans la variable comments_disable, si vous inscrivez 1 les commentaires ne seront plus disponibles sur le wiki. Supprimer également dans le fichier wakka.config.php (dans la variable navigation_links) DerniersCommentaires.


 

14. Installer le correcteur orthographique

Note de PL: Cette fonction n'est pas très utile si vous utilisez déjà un outil de correction dans votre navigateur.

  • Télécharger/décompresser le fichier mot.sql.zip sur le serveur.
  • Rendez-vous dans le répertoire où se trouve mot.sql et faites la commande: mysql -u utiliBDD -p BDD < mot.sql où utilBDD est l'utilisateur de la base de données et BDD est le nom de la base de données de votre WikiNiMST. On vous demandera le mot de passe de la BDD. Après quelques secondes, la table mot s'est ajoutée.
  • Éditer le fichier wakka.config.php et mettre à 0 la variable: "correction_disable" => "0",
  • Voilà, en cliquant sur le bouton «Corriger», WikiNIMST surlignera les mots ne se retrouvant pas dans le dictionnaire.


 

15. Utiliser la fonction UserLogin au lieu de UserSettings

Cette fonction permet de limiter l'enregistrement de nouveaux utilisateurs sur votre Wiki. Éditer la page ParametresUtilisateur et remplacer {{UserSettings}} par {{UserLogin}}. De plus, il serait important de bloquer les page (en écriture du moins) aux personnes non connectées (mettre + dans la variable "default_write_acl" => "*", du fichier wakka.config.php).


 

16. Mettre en place une réécriture d'URL

Pour les version 11.06 et +
  • éditer wakka.config.php et ajuster ces variables:
    • "base_url" => "/nomrepertoirewiki/",(inscrire le nom du répertoire de votre wiki, doit terminer par /).
    • "rewrite_mode" => "1", (mettre 1 à cette variable).
  • éditer le fichier htaccess.txt situé à la racine de votre wiki, changer le nom du répertoire où se trouve votre wiki, renommer ce fichier .htaccess.

Pour les version plus ancienne que la 11.06
Deux fichiers à modifier: wakka.config.php et /actions/header.php. On ajoute un .htaccess également.

1. Déjà, surprise: à l'installation on nous mâche le travail:
           * Pour la configuration de l'URL de votre WikiNi, enlevez la partie "wakka.php?wiki=" donnez simplement l'adresse du répertoire dans lequel se trouve WikiNi à partir du nom de domaine, avec une slash ("/") avant et une après. Exemple: si WikiNi est installé à l'adresse http://wiki.votredomaine.tld/votrerepertoire/, renseignez simplement /votrerepertoire/. WikiNi créera donc des urls du type /votrerepertoire/PagePrincipale, et votre navigateur web comprendra, grâce à la slash ("/") du début que c'est une adresse absolue (c'est à dire définie à partir du nom de domaine)

2. Maintenant il faut mettre en place l'url rewriting. Très facile: créez un fichier nommé .htaccess contenant les lignes suivantes:

RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^([A-Z].+)$ /wikinimst/wakka.php?wiki=$1& [qsa]

note: si votre wikinimst est installé à la racine de votre serveur web, on enlève /repertoire (qui est le nom du répertoire où est installé votre wiki.

    * et placez ce fichier dans le répertoire de WikiNiMST 

3. éditer /actions/header.php et modifier les deux lignes concernant la feuille de style:
          * remplacer
                o <link rel="stylesheet" type="text/css" media="screen" href="wakka.basic.css" />
                o <style type="text/css" media="all"> @import "<?php echo (!isset($_COOKIE["sitestyle"]))?'wakka':$_COOKIE["sitestyle"] ?>.css";</style>
          * par
                o <link rel="stylesheet" type="text/css" media="screen" href="<?php echo $this->GetConfigValue('base_url'); ?>wakka.basic.css" />
                o <style type="text/css" media="all"> @import "<?php echo $this->GetConfigValue('base_url') . (empty($_COOKIE["sitestyle"])?'wakka':$_COOKIE["sitestyle"]) ?>.css";</style>

ainsi que la ligne pour l'éditeur

       echo "<script type=\"text/javascript\" src=\"ACeditor.js\"></script>";

par 

       echo "<script type=\"text/javascript\" src=\"".$this->GetConfigValue('base_url')."ACeditor.js\"></script>";

4. Renommez le fichier ACeditor.buttonsBar.php_avecreecriture ACeditor.buttonsBar.php pour que l'éditeur fonctionne.

5. Modifier une ligne dans wakka.php (pour l'action attacher)
	function Href($method = "", $tag = "", $params = "")
	{
	$href = $this->config["base_url"].$this->MiniHref($method, $tag);
		if ($params)
		{
		$href .= ($this->config["rewrite_mode"] ? "?" : "&amp;").$params;
		}
		return $href;
	}

par 

	function Href($method = "", $tag = "", $params = "")
	{
		$href = $this->config["url_site"].$this->MiniHref($method, $tag);
		if ($params)
		{
			$href .= ($this->config["rewrite_mode"] ? "?" : "&amp;").$params;
		}
		return $href;
	}


6. Finalement , éditer le fichier /actions/attach.class.php et utiliser la fonction attach (ligne 58) qui utilise la réécriture d'url.


 

17. Utiliser les fonctions Geonext, Geogebra, Geolabo, Freemind, lecteur mp3 et flv, JMath3D, Scratch, Squeak, Instrumenpoche
  • Téléchargez l'archive contenant tous les visionneurs sur cette page: SourcesDuWikiniMST
  • Placez les fichiers nécessaires selon les fonctions désirées à la racine de votre wiki.
    • Geogebra: le répertoire complet geogebra (contient 6 fichiers)
    • Geonext: fichier geonext.jar
    • Geolabo: fichier geoweb.jar
    • Freemind: fichers visorfreemind.swf et flashobject.js
    • Lecteur mp3 par défaut: fichier player_mp3_maxi.swf
    • Lecteur mp3 mini: fichier emff_standard.swf
    • Lecteur flv: player_flv.swf
    • Jmath3d?: fichier JMath3D.jar
    • Scratch: fichier ScratchApplet?.jar et soundbank.gm
    • Squeak: aucun fichier n'est nécessaire.
    • instrumenpoche: fichier Animation.swf


  • Éditez le fichier de configuration wakka.config.php, ajouter (dans le cas d'une mise à jour les lignes ne sont pas présentes) les lignes suivantes (si on inscrit 1 on veut que le visionneur soit utilisé, si on inscrit 0 le fichier sera traité sans celui-ci):
    "view_geonext" => "1",
    "view_geogebra" => "1",
    "view_geolabo" => "1",
    "view_freemind" => "1",
    "view_mp3" => "1",
    "view_flv" => "1",
    "view_obj" => "1",
    "view_scratch" => "1",
    "view_squeak" => "1",
    "view_iep" => "1",


  • En joignant un fichier source de ces applications dans une page WikiNiMST le contenu du fichier sera affiché à l'aide d'un visionneur.
 




 

18. Une question (une addition) est posée avant de pouvoir commenter/enregistrer une page
Note de PL:: Cette fonction n'est pas utile si on bloque l'édition des pages et des commentaires aux seuls utilisateurs du wiki (un + comme permission d'écriture dans le fichier wakka.config.php).

"ask_question_page" => "0", Mettre cette variable à 1 pour l'enregistrement d'une page.
"ask_question_comment" => "0" Mettre cette variable à 1 pour commenter avec question.



19. Anti-Spam (liste noire)
 


Note de PL:: Cette fonction n'est pas utile si on bloque l'édition des pages et des commentaires aux seuls utilisateurs du wiki (un + comme permission d'écriture dans le fichier wakka.config.php).

  • Récupérer le antispam.sql et l'insérer dans la base de données de votre wikinimst (utiliser un outil comme phpmyadmin pour ce faire).
  • Une variable comme celle-ci: "comments_spam_enable" => "1", (1 our actif, 0 pour i=nactif) doit être présente dans le fichier wakka.config.php
  • Dans une page wiki, disons GestionSpam, ajouter les actions suivantes: {{recentlyspamed}} et {{spam}} La première listera les commentaires considérés comme du spam (ou d'anciennes versions des commentaires) et la seconde permet d'ajouter des mots à la BDD et de voir les mots présents dans la liste noire. Vous pourrez supprimer de la BDD ces commentaires.
  • NB: Seul l'admin du wiki ("admin_wiki" => "NomUtilisateurAdmin?", du fichier wakka.config.php) pourra gérer la fonction anti-spam.
    Ajout dans le CSS: .commentspam { color:#c71f1f; background-color: yellow; padding: 10px; border-left:1px solid #CCCCCC; border-right: 1px solid #CCCCCC; border-top: 1px solid #CCCCCC; border-bottom: 1px solid #EEEEEE; }


20. Action JMol
 

  • Placer le contenu de l'archive de l'action dans /actions (il y a un fichier jmol.php et un dossier /jmol).
  • Placer tous les .jar de l'application Jmol 10.2 dans /jmol (racine du wikinimst)
  • Ajouter cette ligne dans le fichier wakka.config.php: "jmol_action" => "jmol",

Pour plus de détails, visiter le site du développeur: https://193.50.91.122/wiki2/wakka.php?wiki=PhpJmolPlug


21. Fonction affichage des fichier CSV
 

  • Mettre la variable view_csv à 1: "view_csv" => "1",
Il y a 18 commentaires sur cette page. [Afficher commentaires/formulaire]
 
IMP :: RSS :: HTML :: TXT :: Clone :: Historique :: Propriétaire : PierreLachance