Rozšíření:EasyTimeline/instalace
Tato část se zabývá otázkami, jak aktivovat EasyTimeline v jiných instalacích MediaWiki.
EasyTimeline je rozšíření softwaru MediaWiki. Pro jeho aktivaci je však nutné udělat několik věcí.
Stažení Ploticus
EasyTimeline používá open source program Ploticus, který není součástí instalace MediaWiki. Stáhněte správnou verzi pro Váš operační systém: http://ploticus.sourceforge.net/doc/download.html
Nebo pokud používáte Ubuntu s přístupem k shellu, můžete prostě použít příkaz
$ sudo apt install ploticus
EasyTimeline očekává, že spustitelný soubor Ploticus bude umístěn v adresáři /usr/bin/ploticus. Pokud ne, ujistěte se, že je spustitelný, a vložte příslušné umístění do $wgTimelinePloticusCommand, jak je popsáno níže.
Stažení skriptů PHP/PERL
EasyTimeline.pl je skutečný plugin, napsaný v Perlu.
Timeline.php je PHP wrapper MediaWiki, který volá Perl skript se správnými argumenty a do HTML výstupu vkládá vygenerovaný obrázek a mapu obrázků (pokud je to relevantní).
Stáhněte si jej ze Special:ExtensionDistributor/timeline
...nebo pokud máte přístup k shellu, přejděte do adresáře s rozšířeními a zadejte ...
git clone -b REL1_28 https://gerrit.wikimedia.org/r/mediawiki/extensions/timeline.git
Nepoužívejte skript EasyTimeline.pl ani jeho zkompilovanou verzi ze stránky podpory autorů. Tyto jsou určeny pro offline použití (= mimo Wikimedii).
Instalace fontů
EasyTimeline ve výchozím nastavení používá písmo FreeSans.ttf, které lze stáhnout z GNU FreeFont.
Nebo, pokud používáte Ubuntu s přístupem do shellu, můžete to udělat
$ sudo apt install fonts-freefont-ttf
Abyste zajistili, že EasyTimeline dokáže najít FreeSans.ttf, nastavte $wgTimelineFontDirectory, jak je popsáno níže.
Konfigurace MediaWiki
Načtení rozšíření
Přidejte do souboru LocalSettings.php následující:
wfLoadExtension( "timeline" ); // Přidání rozšíření EasyTimeline
Ploticus
Například v RHEL/CentOS je /usr/bin/pl spustitelný soubor ploticus.
Pokud umístění souboru ploticus ve vašem systému neodpovídá výchozím hodnotám uvedeným v horní části souboru extensions/timeline/extension.json, budete muset explicitně nastavit cesty, např.
Přidejte do souboru LocalSettings.php následující:
$wgTimelinePloticusCommand = "/usr/bin/pl"; // alternativní umístění ploticusu v závislosti na operačním systému
Případně můžete vytvořit symbolické odkazy na alternativní umístění.
$wgTimelinePloticusCommand = "/usr/bin/ploticus";
$wgTimelinePerlCommand = "/usr/bin/perl";
Písmo
Přidejte do souboru LocalSettings.php následující kód, abyste se ujistili, že EasyTimeline najde písmo:
$wgTimelineFontDirectory = "/usr/share/fonts/truetype/freefont"; // Directory containing FreeSans.ttf.
Pokud FreeSans.ttf není k dispozici, nastavte místo toho:
$wgTimelineFontFile = 'ascii'; // Použijte interní písmo Ploticus
Adresář obrázků
Vytvořte adresář pro obrázky časové osy a zajistěte, aby jej uživatel webového serveru mohl číst a zapisovat. Například pokud je uživatel vašeho webového serveru „www-data“, měli byste provést následující:
$ cd (kořenový adresář wiki)
$ mkdir images/timeline
$ chown www-data images/timeline
Známé problémy
Proměnné příkazu nejsou transkripční
K tomuto problému dochází, když se editor pokusí přidat určitá slova do časové osy, což mohou být příkazy v dokumentu. Jedním takovým příkladem výskytu slova by bylo slovo construction; při použití v časové ose jako datovaný záznam dojde k chybě typu, která slovo construction vykreslí jako příkaz a nikoli jako klikatelný odkaz.
Na grafy nelze klikat
Pokud to stále nevyřeší problém, můžete jednoduše upravit soubor EasyTimeline.pl na:
$MapPNG = $true ; # switched when link or hint found
protože se zdá, že to neplatí, když se odkazy ve stylu wiki používají pouze na textové značky a může být nepříjemné to zjistit.
Pouze pro Windows: Chyba časové osy: Spustitelný soubor nenalezen. Příkazový řádek byl:
Pokud se vám zobrazí chyba, jako je
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"
zkuste se dostat do svého PHP souboru (obvykle Timeline.php nebo EasyTimeline.php) a změnit to
$ret = `{$cmdline}`;
do
$ret = `"{$cmdline}"`;
Možná jste také upravili název adresáře rozšíření, což bude mít za následek stejnou chybu i po výše uvedené opravě.
Nastavte timelineFile na něco podobného v LocalSettings.php:
$wgTimelineTimelineFile = "$IP\\extensions\\EasyTimeline\\EasyTimeline.pl";
Pouze pro Windows: nastavit cestu k Perlu
Pokud vaše instalace Mediawiki běží ve Windows, budete muset aktualizovat soubor Timeline.php.
Nastavte $wgTimelinePerlCommand na cestu k souboru perl.exe.
Výchozí nastavení je /usr/bin/perl, pro Windows je nutné toto změnit.
Žádné texty nejsou zobrazeny
EasyTimeline obsahuje rychlou opravu pro podporu Unicode. To vyžaduje bezplatné písmo FreeSans.ttf. Možná nemáte dané písmo v adresáři, kde Ploticus hledá. Můžete zkusit najít, kde se to ve vašem systému nachází: Viz online dokumentace k Ploticusu.
Pokud chcete jiné písmo s rozumným pokrytím kódových bodů, zkuste [1], buď Sans Condensed, nebo Sans Extralight, v závislosti na vašich preferencích.
Můžete nastavit hodnotu $wgTimelineFonts a určit tak cestu, kde má EasyTimeline hledat písmo.