Extension:EasyTimeline/kurulum

From mediawiki.org
Jump to navigation Jump to search
This page is a translated version of the page Extension:EasyTimeline/installation and the translation is 100% complete.
Other languages:

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.

MediaWiki'yi Linux dışında başka bir platformda çalıştırdığınızda, aşağıdakiler geçerli olmayabilir veya eksik olabilir.

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.

Uzantının ploticus ve perl için varsayılan ayarları:
$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:

putenv("GDFONTPATH=/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 hata Ploticus 2.32'de çözülmüştür.

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.