Extension:Description2

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

Description2 Stav rozšíření: stabilní
Implementace	Extrakce dat, Rozšíření syntaktického analyzátoru
Popis	Poskytuje značku meta description a přidává data do výstupu analyzátoru pro použití dalších rozšíření.
Autoři	Daniel Friesen (Dantmandiskuse)
Nejnovější verze	0.4.1
Zásady kompatibility	Větev master zachovává zpětnou kompatibilitu.
MediaWiki	>= 1.38.0
Změny v databázi	Ne
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball
Parametry $wgDescriptionMaxChars $wgDescriptionRemoveElements $wgDescriptionAlgorithm $wgEnableMetaDescriptionFunctions
Použité háčky (hooks) OutputPageParserOutput ParserAfterTidy ParserFirstCallInit
Čtvrtletní stahování	37 (Ranked 74th)
Přeložte rozšíření Description2, používá-li lokalizaci z translatewiki.net

Rozšíření Description2 přidává metaznačku description pro články automaticky na základě obsahu. Zdá se, že tato funkce byla v určitém okamžiku z MediaWiki odstraněna. Existují situace, kdy extrakce popisu (subjekty méně sofistikovanými než Google, jako je Facebook) vytáhne z wiki nesprávné popisné informace a použije něco jako sitenotice jako popis stránky místo jejího obsahu. Toto rozšíření také přidává popis do výstupu analyzátoru způsobem, který mohou využívat ostatní rozšíření (například poskytnout popis v jiném formátu, jako je Extension:OpenGraphMeta , nebo jej možná použít v seznamech článků na wiki).

Instalace

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného Description2 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/Description2
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'Description2' );
  $wgEnableMetaDescriptionFunctions = true;
  

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

Další možnosti

Pokud v LocalSettings.php nastavíte $wgEnableMetaDescriptionFunctions = true;, můžete použít funkci analyzátoru {{#description2:}} k ovládání výstupního popisu pro stránku a přepsat jej vlastním popisem. Tato rozšíření analyzátoru můžete použít takto:

{{#description2:This is a description}}

Místo toho můžete použít funkci analyzátoru description2 k poskytnutí značky description, která můžete ovládat pomocí proměnných šablony.

Algoritmus

Popis je extrahován z HTML reprezentace stránky:

1. Odstraní všechny prvky ‎<table> (a jejich obsah).
2. Najde všechny prvky ‎<p>.
3. Prochází přes tyto odstavce, odstraní všechny HTML tagy (viz strip_tags()) a ořízne kolem nich mezery.
4. Jako popis je vybrán první neprázdný odstavec (po všech předchozích transformacích).

Co je třeba zvážit:

• Pokud používáte šablony v horní části článků a použijete pro šablonu místo tabulek ‎<div>, ujistěte se, že nevykresluje odstavce, které by jinak byly použity jako popis. To se může stát, pokud máte uvnitř šablony několik ‎<div> s novými řádky.

Související odkazy

• Extension:OpenGraphMeta – používá při instalaci informace popisu Description2.
• Extension:MetaDescriptionTag
• Extension:Semantic Meta Tags