Extension:EasyTimeline/installation
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.
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.
$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
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, soit Sans Condensed ou Sans Extra-Light selon vos préférences.
Peaufiner GDFONTPATH
Sur un système Ubuntu avec ttf-freefont installé, la modification suivante de Timeline.php définira GDFONTPATH comme requis par Ploticus pour le rendu du texte avec la police FreeSans.ttf.
$cmdline = 'GDFONTPATH=/usr/share/fonts/truetype/freefont' . ' ' .
wfEscapeShellArg( $wgTimelinePerlCommand, $IP . "/extensions/timeline/EasyTimeline.pl" ) .
" -i " . wfEscapeShellArg( $fname ) . " -m -P " . wfEscapeShellArg( $wgTimelinePloticusCommand ) .
" -T " . wfEscapeShellArg( $wgTmpDirectory ) . " -A " . wfEscapeShellArg( $wgArticlePath );
... ou ajoutez simplement "putenv("GDFONTPATH=/usr/share/fonts/truetype/freefont");" à votre LocalSettings.php.