ParserBeforeStrip

This page is a translated version of the page Manual:Hooks/ParserBeforeStrip and the translation is 100% complete.
ParserBeforeStrip
Dostupné od verze 1.5.0
Odstraněno od verze 1.36.0 (Gerrit change 622618)
Používá se ke zpracování surového wiki kódu stránky ještě před tím, nežli je interpretován interními procesy.
Definice funkce:
public static function onParserBeforeStrip( &$parser, &$text, &$strip_state ) { ... }
Registrace háčku: V extension.json:
{
	"Hooks": {
		"ParserBeforeStrip": "MediaWiki\\Extension\\MyExtension\\Hooks::onParserBeforeStrip"
	}
}
Volá se z: Soubor/y: parser/Parser.php
Rozhraní: ParserBeforeStripHook.php

Další informace o háčcích najdete na stránce Příručka:Háčky .
Chcete-li vědět, jaká rozšíření tento háček používají, podívejte se na stránku Category:ParserBeforeStrip extensions/cs.

Podrobnosti

Mějte prosím na paměti, že pokud je obsah stránky již umístěn někde v keši, tak se již tento háček (hook) nevolá. A spouští se také při analýze systémových zpráv kromě textu stránky.

$text bude obsahovat analyzovaný text. Chcete-li změnit analyzovaný text, upravte tuto hodnotu. Např. pro přidání fráze "The mighty oracle gives forth this proclamation: " na začátek analyzovaného textu byste použili následující kód:

$text = "The mighty oracle gives forth this proclamation: " . $text;
Pokud pouze přidáváte věci na začátek/konec těla stránky a nepotřebujete, aby byly skutečně integrovány do procesu analýzy, měli byste zvážit použití samostatného háčku pro přidání/předřazení tohoto obsahu.

Historie

Původně analyzátor MediaWiki provedl první průchod, který odstranil prvky, které by neměly být zpracovány jako wiki text (např. značky ‎<nowiki>, komentáře HTML, značky ‎<pre> atd.), z textu stránky, než zpracoval zbývající wiki text. Tento proces byl znám jako 'stripping'. odstraněný obsah (je-li to relevantní) byl vložen zpět do stránky na konci analýzy.

S procesem analýzy tedy souvisely tři há4ky analyzátoru. ParserBeforeStrip byl volán před odstraněním, ParserAfterStrip byl volán po odstranění a ParserBeforeInternalParse byl volán těsně před skutečnou analýzou (a měl poskytnout mechanismus pro použití alternativního analyzátoru namísto standardního analyzátoru wikitextu MW).

In MW 1.14, the 'strip' stage was removed, which meant that there was no difference between ParserBeforeStrip and ParserAfterStrip, so the latter was deprecated. It also meant that the text passed into the hook now contains the full wikitext of the source page, including any <nowiki> tags, etc.

As of MW 1.36, both ParserBeforeStrip and ParserAfterStrip were completely removed, so you are now recommended to use ParserBeforeInternalParse instead of ParserBeforeStrip or InternalParseBeforeLinks instead of ParserAfterStrip, or possibly one of the other page rendering hooks if they more closely match your requirements.

Související odkazy