Příručka:$wgUseTidy

From mediawiki.org
This page is a translated version of the page Manual:$wgUseTidy and the translation is 100% complete.
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

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 HTML ve wikitextu. 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é.

HTML tidy nenávratně a nečekaně zničí standardní HTML značky, když to bude chtít. Například wikitext jako [[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>&lt;tr&gt;&lt;td&gt;bar&lt;/td&gt;&lt;/tr&gt;</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&lt;/b&gt;</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.

Související odkazy