Manuel:$wgUseTidy

This page is a translated version of the page Manual:$wgUseTidy and the translation is 100% complete.

Cette fonctionnalité a été supprimée du noyau Mediawiki dans la version 1.33.0. Voyez $wgTidyConfig comme manière alternative pour utiliser cette fonctionnalité.

Tidy: $wgUseTidy
Utilisez Tidy pour vérifier que la sortie HTML est saine.
Introduit dans la version :	1.3.0
Obsolète dans la version :	1.26.0 (Gerrit change 235401; git #2c6c954e)
Retiré dans la version :	1.33.0 (Gerrit change 467972; git #6db35b3c)
Valeurs autorisées :	(booléen)
Valeur par défaut :	`false`
Autres paramètres : Alphabétique \| Par fonction

Détails

Utilisez HTML Tidy pour vérifier que la sortie HTML est saine.

HTML Tidy est un outil gratuit qui répare le HTML cassé. Voir HTML tidy et http://www.w3.org/People/Raggett/tidy/

Vous pouvez configurer cet outil et définir $wgUseTidy=true, pour vous assurer que le wiki produit un HTML raisonnablement propre et conforme, même lorsque des utilisateurs malveillants ou stupides ajoutent du code HTML corrompu ou mal formaté aux pages du wiki.

Notez que MediaWiki effectue déjà quelques vérifications et corrections intégrées au code HTML de l'utilisateur, et limite la gamme de balises et d'attributs HTML pouvant être utilisés (sauf si vous définissez $wgRawHtml =true, ce qui est dangereux !). Les limites sont décrites sur Aide:HTML dans le wikicode . La logique est décrite sur includes/parser/Sanitizer.php. Par conséquent, vous pouvez décider qu'il n'est pas nécessaire d'appliquer HTML Tidy sur la sortie.

Le code HTML nettoyé va irréversiblement et de manière inattendue modifier le code HTML standard quand il le décidera. Par exemple du wikicode tel que [[Link|<div>Text</div>]] ne pas pas produire actuellement de lien cliquable. Il y a plusieurs dizaines de bogues spécifiques identifiés qui ne seront probablement jamais corrigés (voir tâche T4542 et sa liste de points bloquants). Si vous activez Tidy, vous entrez dans une zone dangereuse.

Configuration

L'emplacement du fichier de configuration de Tidy peut être déclaré à l'aide de $wgTidyConf - avant MediaWiki 1.10, cela était nécessaire. Dans les dernières versions, nous fournissons un fonctionnement par défaut.

Néanmoins ceci ne fonctionne pas toujours. Voir $wgTidyInternal pour quelques informations d'installation.

Actions

Tidy est encore nécessaire pour mixer la syntaxe des tableaux wiki avec celle des tableaux HTML, ainsi que les balises simples de wikicode avec les balises de style HTML.

exemple

code

analyse syntaxique sans Tidy

avec Tidy

Mixer des balises imbriquées.

{|
|| 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>

Mixer des balises d'ouverture et de fermeture.

'''foo</b>

<b>foo&lt;/b&gt;</b>

<b>foo</b>

Indenter la définition de liste

; 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 peut corriger la plupart du code HTML incorrect, qui peut être une mauvaise saisie de l'utilisateur comme

<table><tr></td></table>

ou résulter d'un conflit entre extensions mal écrites (et même de certains bogues du logiciel principal).

Cependant, il ne résout pas tous les problèmes de validation XHTML stricts, tels que les valeurs d'attributs d'identifiant xml dupliqués ou les identifiants commençant par des nombres.

Voir aussi