Extension:EasyTimeline/kurulum
Bu bölüm, diğer MediaWiki kurulumlarında EasyTimeline uzantının nasıl etkinleştirileceği ile ilgili konuları ele almaktadır.
EasyTimeline, MediaWiki yazılımının bir uzantısıdır. Ancak etkinleştirmek için birkaç şey yapmanız gerekiyor.
Ploticus'u indir
EasyTimeline, MediaWiki kurulumuna dahil olmayan açık kaynak programını Ploticus kullanır. İşletim sisteminiz için uygun sürümü indirin: 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, Ploticus yürütülebilir dosyasının /usr/bin/ploticus konumunda bulunmasını bekler, eğer yalnızca yürütülebilir olduğundan emin olun ve aşağıda açıklanan $wgTimelinePloticusCommand içine uygun konumu koyun.
PHP / PERL betiklerini indirin
EasyTimeline.pl perl ile yazılmış gerçek eklentidir.
Timeline.php, perl betiğini uygun argümanlarla çağıran ve oluşturulan görüntü ve görüntü eşlemini (varsa) html çıkışına besleyen MediaWiki php sarmalayıcısıdır.
Special:ExtensionDistributor/timeline üzerinden indirin
...veya kabuk erişiminiz varsa, uzantılar dizininize gidin ve şunu yazın ...
git clone -b REL1_28 https://gerrit.wikimedia.org/r/mediawiki/extensions/timeline.git
EasyTimeline.pl betiğini veya onun derlenmiş sürümünü yazarların destek sayfasından kullanmayın. Bunlar çevrimdışı kullanım içindir (= WikiMedia dışında).
Yazı tiplerini yükle
EasyTimeline varsayılan olarak GNU FreeFont'tan indirilebilen FreeSans.ttf yazı tipini kullanır.
Veya, kabuk erişimine sahip Ubuntu'daysanız, bunu kolayca yapabilirsiniz.
$ sudo apt install fonts-freefont-ttf
EasyTimeline'ın FreeSans.ttf ile bulabileceğinden emin olmak için, aşağıda açıklanan GDFONTPATH ayarlayın.
MediaWiki'yi yapılandırın
Uzantıyı yükle
Aşağıdakileri LocalSettings.php dosyanıza ekleyin:
wfLoadExtension( "timeline" ); // EasyTimeline uzantısı ekleyin
Ploticus
Örneğin RHEL/CentOS üzerinde /usr/bin/pl, ploticus çalıştırılabiliridir.
Sisteminizdeki ploticus konumu, extensions/timeline/extension.json üst kısmında listelenen varsayılanlarla eşleşmiyorsa, yolları açıkça ayarlamanız gerekir, ör.
Add the following to you LocalSettings.php file:
$wgTimelinePloticusCommand = "/usr/bin/pl"; // işletim sistemine bağlı olarak ploticus'un alternatif konumu
Alternatif olarak, alternatif konuma sembolik bağlantılar oluşturabilirsiniz.
$wgTimelinePloticusCommand = "/usr/bin/ploticus";
$wgTimelinePerlCommand = "/usr/bin/perl";
Yazı tipi
EasyTimeline'ın yazı tipini bulduğundan emin olmak için LocalSettings.php dosyanıza aşağıdakileri ekleyin:
$wgTimelineFontDirectory = "/usr/share/fonts/truetype/freefont"; // Directory containing FreeSans.ttf.
FreeSans.ttf mevcut değilse, bunun yerine şunu ayarlayın:
$wgTimelineFontFile = 'ascii'; // Use the internal Ploticus font
Resim dizini
Zaman çizelgesi resimleri için bir dizin oluşturun ve web sunucunuzun kullanıcısı tarafından okunabilir/yazılabilir olduğundan emin olun. Örneğin, web sunucusu kullanıcınız "www-data" ise, şunları yaparsınız:
$ cd (viki kök dizini)
$ mkdir images/timeline
$ chown www-data images/timeline
Bilinen sorunlar
Komut Değişkenleri Yansıtma Değildir
Bu sorun, bir düzenleyici zaman çizelgesinin içine, belge altındaki komutlar olabilecek belirli sözcükleri eklemeye çalıştığında ortaya çıkar. Böyle bir örnek kelime örneği, yapı kelimesi olabilir; bir zaman çizelgesinde tarihli bir girdi olarak kullanıldığında, tıklanabilir bir bağlantı değil, bir komut olarak "yapı" kelimesini oluşturan bir hata tipi oluşur.
Grafikler tıklanamaz
Bu hala sorunları çözmezse, EasyTimeline.pl'yi şu şekilde düzenlemek isteyebilirsiniz:
$MapPNG = $true ; # switched when link or hint found
çünkü vikistili bağlantılar yalnızca metin etiketlerinde kullanıldığında geçerli görünmüyor ve bunu anlamak can sıkıcı olabilir.
Yalnızca Windows: Zaman çizelgesi hatası: Yürütülebilir dosya bulunamadı., Komut satırı şuydu:
Böyle gibi bir hata alıyorsanız
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"
php dosyanıza girmeyi deneyin (genellikle Timeline.php veya EasyTimeline.php'de) ve değiştirmeyi deneyin
$ret = `{$cmdline}`;
dönüşür
$ret = `"{$cmdline}"`;
Ayrıca, uzantı dizini adını değiştirmiş olabilirsiniz; bu, yukarıdaki düzeltmede bile aynı hataya neden olacaktır. timelineFile'ı LocalSettings.php'de buna benzer bir şeye ayarlayın:
$wgTimelineTimelineFile = "$IP\\extensions\\EasyTimeline\\EasyTimeline.pl";
Yalnızca Windows: yolu perl olarak ayarlayın
Mediawiki kurulumunuz Windows üzerinde çalıştığında Timeline.php dosyasını güncellemeniz gerekecektir.
$wgTimelinePerlCommand ile perl.exe yoluna ayarlayın.
Varsayılan /usr/bin/perl olur, bunun Windows için değiştirilmesi gerekir.
Hiçbir metin görüntülenmiyor
EasyTimeline, unicode desteği için hızlı bir düzeltme içerir. Bu, özgür yazı tipi FreeSans.ttf gerektirir. Belki de Ploticus'un göründüğü bir dizinde bu yazı tipine sahip değilsiniz. Sisteminizde nerede olduğunu bulmaya çalışabilirsiniz: Çevrimiçi Ploticus belgelerine bakın.
Makul kod noktası kapsamına sahip farklı bir yazı tipi istiyorsanız, tercihlerinize bağlı olarak DejaVu ile Sans Condensed veya Sans Extra-Light deneyin.
GDFONTPATH ince ayarı
ttf-freefont kurulu bir Ubuntu sisteminde, Timeline.php'de yapılan aşağıdaki değişiklik, Ploticus'un FreeSans.ttf ile metin oluşturmak için gerektirdiği şekilde GDFONTPATH ayarlayacaktır.
$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 );
... veya basitçe LocalSettings.php dosyanızda "putenv("GDFONTPATH=/usr/share/fonts/truetype/freefont");" ekleyin.