Jump to content

Manuel:$wgTidyConfig

From mediawiki.org
This page is a translated version of the page Manual:$wgTidyConfig and the translation is 100% complete.
Tidy: $wgTidyConfig
Configuration de l'outil de post-traitement HTML à utiliser pour corriger le code HTML non valide.
Introduit dans la version :1.26.0 (Gerrit change 235401; git #2c6c954e)
Retiré dans la version :Encore utilisé
Valeurs autorisées :(tableau) ou null
Valeur par défaut :[] (1.36+)

[ 'driver' => 'RemexHtml' ] (1.31-1.35)

null (1.26-1.30)

Détails

Configuration de l'outil de post-traitement HTML. Initialiser avec un tableau de paramètres pour activer un outil externe. HTML Tidy de Dave Raggett est généralement utilisé. Voir http://www.w3.org/People/Raggett/tidy/.

RemexHtml est sur le point de remplacer Tidy

S'il vaut nul et que $wgUseTidy est à true, les paramètres de configuration obsolètes seront utilisés à la place. S'il vaut nul et que $wgUseTidy est à false, une fonction de repli en pur PHP sera utilisée à la place.

Les clés sont :

  • driver – Il peut valoir :
    • RaggettInternalHHVM – Utiliser l'extension HHVM à fonctionnalité limitée
    • RaggettInternalPHP – Utiliser l’extension PECL
    • RaggettExternal – ouvrir le shell pour exécuter un binaire externe (tidyBin)
    • Html5Depurate – utiliser le service externe Depurate (supprimé en 1.32) Gerrit change 431531
    • Html5Internal – utiliser la bibliothéque PHP Balancer (supprimé en 1.32) Gerrit change 431531
    • RemexHtml – utiliser la bibliothéque PHP RemexHtml
  • tidyConfigFile – Chemin vers le fichier de configuration pour les pilotes Raggett
  • debugComment – true si vous voulez ajouter un commentaire à la sortie avec des messages d'avertissement
  • tidyBin – Pour RaggettExternal, chemin du binaire tidy.
  • tidyCommandLine – Pour RaggettExternal, options supplémentaires de la ligne de commande.

Exemple

Configurer MediaWiki pour utiliser le package PECL tidy :

$wgTidyConfig = [
    'driver' => 'RaggettInternalPHP',
    'tidyConfigFile' => "$IP/includes/tidy/tidy.conf",
];

ou utiliser le binaire tidy :

$wgTidyConfig = [
    'driver' => 'RaggettExternal',
    'tidyConfigFile' => "$IP/includes/tidy/tidy.conf",
    'tidyBin' => 'tidy',
    'tidyCommandLine' => '',
];

Le lien entre $wgTidyConfig et les paramètres utilisés par les anciennes versions de MediaWiki ($wgTidyInternal , $wgUseTidy , $wgTidyBin , $wgTidyConf , $wgTidyOpts , $wgDebugTidy ) est approximativement :

$wgTidyConfig = $wgUseTidy ? [
    'driver' => $wgTidyInternal ? 'RaggettInternalPHP' : 'RaggettExternal',
    'tidyConfigFile' => $wgTidyConf,
    'debugComment' => $wgDebugTidy,
    'tidyBin' => $wgTidyBin,
    'tidyCommandLine' => $wgTidyOpts,
] : null;