Extension:EasyTimeline/installation/fr

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

EasyTimeline est une extension au logiciel MediaWiki. Cependant quelques petites choses 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 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 plug-in effectif.

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 un accès shell, allez au dossier des extensions et tapez...

N'utilisez pas le script EasyTimeline.pl, ou sa version compilée, à partir de la page de support des auteurs. Ceux-ci sont destinés à une utilisation hors ligne (= 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 sur Ubuntu avec un accès shell, vous pouvez simplement faire

sudo apt install fonts-freefont-ttf

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

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.

Font
Add the following to your  file to make sure EasyTimeline finds the font:

If  is not available, instead set:

Image directory
Create a directory for timeline images and ensure it's read/writable by your web server's user. For example if your web server user is "www-data", you would do:

Command Variables are Non-Transclusion
This problem occurs when an editor attempts to add certain words inside of the timeline which may be commands under document. One such example word instance would be for the word construction; when used in a timeline as a dated entry, an error type occurs, rendering the word construction as a command and not a clickable link.

Charts not clickable
If that still does not resolve problems you may want to simply edit EasyTimeline.pl to:

since it doesn't seem to apply when wikistyled links are just used on text tags and it can be annoying to figure that out.

Windows only: Timeline error: Executable not found. Command line was:
If you are getting an error something like

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"

try going into your php file (usually at Timeline.php or EasyTimeline.php) and changing

into

You may also have modified the extension directory name, which will result in the same error even with the above fix. Set timelineFile to something like this in LocalSettings.php:

Windows only: set path to perl
When your mediawiki installation runs on Windows you will need to update Timeline.php. Set  to the path to perl.exe. The default is /usr/bin/perl, this needs to be changed for Windows.

No texts displayed
EasyTimeline contains a quick fix for unicode support. This requires free font FreeSans.ttf. Maybe you do not have that font in a directory where Ploticus looks. You might try to find where that is on your system: see Ploticus docs online.

If you want a different font with reasonable code point coverage, try DejaVu, either Sans Condensed or Sans Extra-Light depending on your preferences.

Tweaking GDFONTPATH
On a Ubuntu system with  installed, the following change to Timeline.php will set   as required by Ploticus to render text with FreeSans.ttf.

... or simply add " " to your LocalSettings.php.