Extension:EasyTimeline/installation/fr

Cette section traite de l'activation de 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

EasyTimeline présume que Ploticus est exécutable et situé à. Si ce n'est pas le cas, assurez-vous que le programme est exécutable, et indiquez son emplacement dans la variable  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, 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

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



Configurer MediaWiki


Charger l'extension
Ajoutez ce qui suit à votre fichier  :

Ploticus
Sur RHEL/CentOS, par exemple,  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, vous devrez définir explicitement les chemins, par ex.

Add the following to you  file:

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

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

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



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 :



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 :

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

en

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 :



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  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  installé, la modification suivante de Timeline.php définira   comme requis par Ploticus pour le rendu du texte avec la police FreeSans.ttf.

... ou ajoutez simplement " " à votre LocalSettings.php.