Extension:EasyTimeline/installation

This page is a translated version of the page Extension:EasyTimeline/installation and the translation is 100% complete.

Cette section traite de l'activation de EasyTimeline dans d'autres installations Mediawiki.

EasyTimeline est une extension du logiciel MediaWiki. Cependant quelques étapes préalables doivent être faites pour l'activer.

Si Mediawiki s'exécute sur une plateforme autre que Linux, ce qui suit peut ne pas s'appliquer ou être insuffisant.

Télécharger Ploticus

EasyTimeline utilise le logiciel open source Ploticus, qui n'est pas inclus dans l'installation de MediaWiki. Télécharger la version correspondant à votre OS : http://ploticus.sourceforge.net/doc/download.html

Ou, si vous êtes sur Ubuntu avec un accès au shell, vous pouvez simplement faire

$ sudo apt install ploticus

EasyTimeline présume que Ploticus est exécutable et situé à /usr/bin/ploticus. Si ce n'est pas le cas, assurez-vous que le programme est exécutable, et indiquez son emplacement dans la variable $wgTimelinePloticusCommand décrite plus bas.

Téléchargement des scripts PHP / PERL

EayTimeline.pl, écrit en Perl, est le greffon actuel.

Timeline.php est l'enveloppe php MediaWiki qui appelle le script Perl avec les arguments préparés, et qui fournit l'image générée et, le cas échéant, l'image-map à la sortie Html.

Téléchargez-le à Special:ExtensionDistributor/timeline

... ou, si vous avez accès au shell, allez au dossier des extensions et entrez...

git clone -b REL1_28 https://gerrit.wikimedia.org/r/mediawiki/extensions/timeline.git

N'utilisez pas le script EasyTimeline.pl, ni sa version compilée, à partir de la page de support des auteurs. Ils sont destinés à une utilisation hors ligne (c'est à dire en dehors de WikiMedia).

Installer les polices

EasyTimeline utilise par défaut la police FreeSans.ttf, qui peut être téléchargée depuis GNU FreeFont.

Ou, si vous êtes sous Ubuntu avec un accès au shell, vous pouvez simplement faire

$ sudo apt install fonts-freefont-ttf

Pour vous assurer qu'EasyTimeline peut trouver FreeSans.ttf, définissez GDFONTPATH, décrit ci-dessous.

Configurer MediaWiki

Charger l'extension

Ajoutez ce qui suit à votre fichier LocalSettings.php  :

wfLoadExtension( "timeline" ); // Ajouter l'extension EasyTimeline

Ploticus

Sur RHEL/CentOS, par exemple, /usr/bin/pl est l'exécutable ploticus. Si l'emplacement de ploticus sur votre système ne correspond pas aux valeurs par défaut répertoriées en haut de extensions/timeline/extension.json, vous devrez définir explicitement les chemins, par ex.

Add the following to you LocalSettings.php file:

$wgTimelinePloticusCommand = "/usr/bin/pl"; // emplacement alternatif de ''ploticus'', selon votre système d'exploitation

Vous pouvez également créer des liens symboliques vers l'emplacement alternatif.

Les paramètres par défaut de l'extension pour ploticus et Perl :
$wgTimelinePloticusCommand = "/usr/bin/ploticus";
$wgTimelinePerlCommand = "/usr/bin/perl";

Police

Ajoutez ce qui suit à votre fichier LocalSettings.php pour vous assurer qu'EasyTimeline trouve la police :

$wgTimelineFontDirectory = "/usr/share/fonts/truetype/freefont"; // Directory containing FreeSans.ttf.

Si FreeSans.ttf n'est pas disponible, définissez à la place :

$wgTimelineFontFile = 'ascii'; // Use the internal Ploticus font

Répertoire des images

Créez un répertoire pour les images de timeline et assurez-vous qu'il est accessible en lecture/écriture par l'utilisateur de votre serveur Web. Par exemple, si l'utilisateur de votre serveur Web est "www-data", vous devrez faire :

$ cd (répertoire racine du wiki)
$ mkdir images/timeline
$ chown www-data images/timeline

Problèmes connus

Les variables de commande sont non-transclusives

Ce problème se produit lorsqu'un contributeur tente d'ajouter certains mots à l'intérieur de la chronologie, qui peuvent être des commandes sous document. Un tel exemple d'instance de mot serait pour le mot construction ; lorsqu'il est utilisé dans une chronologie en tant qu'entrée datée, un type d'erreur se produit, rendant le mot construction comme une commande et non comme un lien cliquable.

Graphiques non cliquables

Ce bogue a été résolu dans Ploticus 2.32

Si cela ne résout toujours pas les problèmes, vous pouvez simplement modifier EasyTimeline.pl pour :

   $MapPNG = $true ; # switched when link or hint found

car cela ne semble pas s'appliquer lorsque les liens de style wiki ne sont utilisés que sur des balises de texte et cela peut être ennuyeux à comprendre.

Windows uniquement : Timeline error: Executable not found. Command line was:

Si vous obtenez une erreur similaire à

Timeline error: Executable not found. Command line was:
"C:/Perl/bin/perl.exe" "C:/Apache2/htdocs/wiki/extensions/timeline/EasyTimeline.pl"
-i "C:/Apache2/htdocs/wiki/images/timeline/bebc64ea32049f9fe1f251640849a318"
-m -P "C:/pl232win32/bin/pl.exe"
-T "C:/Apache2/htdocs/wiki/images/tmp" -A "/wiki/$1"

allez dans votre fichier php (généralement à Timeline.php ou EasyTimeline.php) et de changer

 $ret = `{$cmdline}`;

en

 $ret = `"{$cmdline}"`;

Vous avez peut-être également modifié le nom du répertoire d'extension, ce qui entraînera la même erreur même avec le correctif ci-dessus. Définissez timelineFile sur quelque chose comme ceci dans LocalSettings.php :

 $wgTimelineTimelineFile = "$IP\\extensions\\EasyTimeline\\EasyTimeline.pl";

Windows uniquement : définissez le chemin vers Perl

Lorsque votre installation Mediawiki s'exécute sous Windows, vous devrez mettre à jour Timeline.php. Définissez $wgTimelinePerlCommand sur le chemin vers perl.exe. La valeur par défaut est /usr/bin/perl, cela doit être changé pour Windows.

Aucun texte affiché

EasyTimeline contient une solution rapide pour la prise en charge d'Unicode. Cela nécessite la police (gratuite) FreeSans.ttf. Peut-être cette police n'est pas présente dans un répertoire sur lequel Ploticus a la visibilité. Vous pouvez essayer de trouver où cela se trouve sur votre système : consultez la documentation Ploticus en ligne.

Si vous voulez une police différente avec une couverture raisonnable de points de code, essayez DejaVu, en version Sans Condensed ou Sans Extralight selon vos préférences.

Vous pouvez utiliser $wgTimelineFonts pour spécifier le chemin où EasyTimeline doit rechercher la police.