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 [url 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

Or, if you are on Ubuntu with shell access, you can simply do

sudo apt install ploticus

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...

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

Do not use the EasyTimeline.pl script, or its compiled version, from the authors support page. These are meant for offline usage (= outside WikiMedia).

Install fonts
EasyTimeline by default uses the font, which can be downloaded from GNU FreeFont.

Or, if you are on Ubuntu with shell access, you can simply do

sudo apt install fonts-freefont-ttf

To make sure EasyTimeline can find, set  , described below.

Load extension
Add the following to you  file:

Ploticus
On RHEL/CentOS, for instance,  is the ploticus executable. If the ploticus location on your system does not match the defaults listed at the top of, you will need to explicitly set the paths, e.g.

Add the following to you  file:

Alternatively you may create symlinks to the alternate location.

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.