Rozšíření:ActiveAbstract

From mediawiki.org
This page is a translated version of the page Extension:ActiveAbstract and the translation is 59% complete.
Základní informace k tomuto rozšíření MediaWiki
ActiveAbstract
Stav rozšíření: stabilní
Zavádění Rozšířená syntaxe
Popis Vygeneruje zdroj XML pro projekt Active Abstracts společnosti Yahoo
Napsal(i) Brooke Vibberdiskuse
Zásady kompatibility Vydání snímků následuje MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
MediaWiki 1.25+
Licence GNU General Public License 2.0 nebo později
Zdrojový kód
Čtvrtletní stahování 10 (Ranked 137th)
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' );
    
  • Yes 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.