Rozšíření:ActiveAbstract

Příručka k rozšířením MediaWiki

ActiveAbstract Stav rozšíření: stabilní
Implementace	Rozšířená syntaxe
Popis	Vygeneruje zdroj XML pro projekt Active Abstracts společnosti Yahoo
Autoři	Brooke Vibberdiskuse
Zásady kompatibility	Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
MediaWiki	1.25+
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: stáhněte si Git master procházení úložiště (GitHub) zobrazení historie přispěvatelé repozitáře (GitHub) kontrola kódu
Čtvrtletní stahování	9 (Ranked 127th)
Přeložte rozšíření ActiveAbstract, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Toto rozšíření se používá s výpisy XML k získání formátované kopie původního textu článku a jeho organizační struktury. Je to jeden z dostupných filtrů pro záložní systém.

Vytáhne první dvě věty článku spolu s každým nadpisem oddílu a zabalí je do značek XML a ořízne položku tak, aby nebyla delší než 1024 znaků.

Instalace

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného ActiveAbstract ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ActiveAbstract
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'ActiveAbstract' );
  

•  Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Parametry

ActiveAbstract se spouští jako plugin pro dumpBackup.php:

 php dumpBackup.php \
   --plugin=AbstractFilter:extensions/ActiveAbstract/AbstractFilter.php \
   --current \
   --output=gzip:/dumps/abstract.xml.gz \
     --filter=namespace:NS_MAIN \
     --filter=noredirect \
     --filter=abstract

Kde

• current - načte jen poslední verzi článku
• output - nastaví, kam půjde výsledný stream
• filters
  • namespace - zahrne pouze dokumenty z daného jmenného prostoru
  • noredirect - ignoruje přesměrování
  • abstract - registers the abstracts filter and runs it from within dumpBackup.php
  • variants - if variants exist, pull all latest copies and output them to a separate abstracts file

It can optionally convert output text to a given language variant:

   --filter=abstract:variant=zh-cn

A possible way to run this in production would be

/usr/bin/php -q /apache/common/php-1.5/maintenance/dumpBackup.php   --wiki='quwiki' \
   --plugin=AbstractFilter:/apache/common/php-1.5/extensions/ActiveAbstract/AbstractFilter.php \
   --current   --report=1000   --force-normal   --server='x.x.x.x'  \
   --output=file:/mnt/dumps/public/quwiki/20090613/quwiki-20090613-abstract.xml  \
   --filter=namespace:NS_MAIN     --filter=noredirect     --filter=abstract

force-normal is added for better UTF-8 conversion.

Formatting

The required tags for each entry are:

• doc
• title
• url
• abstract
• links
• sublink

Example Listing

<doc>
	<title>Wikipedia: An American in Paris</title>
	<url>http://en.wikipedia.org/wiki/An_American_in_Paris</url>
	<abstract>An American in Paris is a symphonic composition by American composer George Gershwin, composed in 1928. Inspired .. </abstract>
	<links>
		<sublink linktype="nav"><anchor>Instrumentation</anchor><link>http://en.wikipedia.org/wiki/An_American_in_Paris#Instrumentation</link></sublink>
		<sublink linktype="nav"><anchor>Recordings</anchor><link>http://en.wikipedia.org/wiki/An_American_in_Paris#Recordings</link></sublink>
		<sublink linktype="nav"><anchor>Film</anchor><link>http://en.wikipedia.org/wiki/An_American_in_Paris#Film</link></sublink>
	</links>
</doc>

The ‎<abstract> text is trimmed to not run off this wiki page.