Příručka:$wgUseTidy
| Tato funkce byla odstraněna z jádra MediaWiki ve verzi 1.33.0. Jaká existují jiná alternativní řešení této funkcionality, zjistíte na stránce $wgTidyConfig. |
| Tidy: $wgUseTidy | |
|---|---|
| Použijte tidy, abyste se ujistili, že výstup HTML je rozumný. |
|
| Zavedeno od verze: | 1.3.0 |
| Nepoužívá se od verze: | 1.26.0 (Gerrit change 235401; git #2c6c954e) |
| Odstraněno od verze: | 1.33.0 (Gerrit change 467972; git #6db35b3c) |
| Povolené hodnoty: | (boolean) |
| Výchozí hodnota: | false |
| Další nastavení: Podle abecedy | Podle funkce | |
Podrobnosti
Použijte "HTML tidy", abyste se ujistili, že výstup HTML je zdravý.
HTML tidy je bezplatný nástroj, který opravuje nefunkční HTML. Viz w:HTML tidy a http://www.w3.org/People/Raggett/tidy/
Možná budete chtít nastavit tento nástroj a nastavit $wgUseTidy=true, abyste zajistili, že výstupy wiki budou přiměřeně čisté a vyhovující HTML, i když zlomyslní nebo pošetilí uživatelé přidají na wiki stránky poškozené/špatně naformátované HTML.
Všimněte si, že MediaWiki již provádí některé vestavěné kontroly a opravy uživatelského HTML a omezuje rozsah HTML značek a atributů, které lze použít (pokud nenastavíte $wgRawHtml=true Dangerous!)
Omezení jsou popsána na Help:HTML in wikitext.
Logiku tohoto lze nalézt v includes/Sanitizer.php.
Proto se můžete rozhodnout, že spouštění HTML kódu na výstupu není nutné.
[[Link|<div>Text</div>]] ve skutečnosti nevytvoří odkaz, na který lze kliknout. Bylo zjištěno několik desítek konkrétních chyb, které pravděpodobně nikdy nebudou opraveny (viz úkol T4542 a jeho seznam blokátorů). Pokud povolíte Tidy, čeká vás svět bolesti.
Konfigurace
Umístění konfiguračního souboru tidy lze nastavit pomocí $wgTidyConf - před MediaWiki 1.10 to bylo vyžadováno. V pozdějších verzích je k dispozici výchozí pracovní nastavení.
To však nemusí vždy fungovat. Další informace o instalaci naleznete v části $wgTidyInternal.
Účinky
Tidy je stále vyžadován pro kombinaci wiki tabulky a syntaxe HTML tabulky, stejně jako jednoduchý wikikód a značkování ve stylu HTML.
| příklad | kód | Analyzátor bez Tidy | Tidy |
|---|---|---|---|
| Smíšené vnořené značky. | {|
|| foo
<tr><td>bar</td></tr>
|}
|
<table>
<tr>
<td> foo
<p><tr><td>bar</td></tr></p>
</td></tr></table>
|
<table>
<tr><td>foo</td></tr>
<tr><td>bar</td></tr>
</table>
|
| Smíšené značky otevřít/zavřít. | '''foo</b>
|
<b>foo</b></b>
|
<b>foo</b>
|
| Vnoření seznamu definic | ; hi
:# one
|
<dl><dt> hi
<ol><li> one</li></ol>
</dt></dl>
|
<dl><dt>hi</dt><dd>
<ol><li>one</li></ol>
</dd></dl>
|
Tidy dokáže opravit většinu špatných HTML, což může být špatný uživatelský vstup, jako je $kód nebo konfliktní či špatně napsaná rozšíření (a dokonce i některé chyby v základním softwaru). Neřeší však všechny striktní problémy s ověřováním XHTML, jako jsou duplicitní hodnoty atributů xml ID nebo ID začínající čísly.