Jump to content

Manuel:$wgFragmentMode

From mediawiki.org
This page is a translated version of the page Manual:$wgFragmentMode and the translation is 100% complete.
Sortie: $wgFragmentMode
Détermine la manière dont les ID des sections sont encodés
Introduit dans la version :1.30.0 (Gerrit change 362326; git #Id304010)
Retiré dans la version :Encore utilisé
Valeurs autorisées :(tableau)
Valeur par défaut :[ 'html5', 'legacy' ] (1.37+)

[ 'legacy', 'html5' ] (1.31-1.36)

[ 'legacy' ] (1.30)

Détermine la manière dont les ID des sections sont encodés.

Détails

Ce tableau contient 1 ou 2 éléments, chacun d'eux pouvant avoir une valeur parmi :

  • 'html5' - encodage moderne dans le stye HTML5 moderne avec un minimum d'échappements. Affiche les caractères Unicode dans les barres d'adresses de nombreux navigateurs.
  • 'legacy' - ancien style d'encodage de MediaWiki, par exemple 手紙 devient .E6.89.8B.E7.B4.99.
  • 'html5-legacy' correspond au mode $wgExperimentalHtmlIds qui est OBSOLETE. NE PAS UTILISER pour autre chose que la migration hors de ce mode (voir ci-dessous).

Le premier élément du tableau indique le mode primaire d'échappement des IDs. C'est ce que voient les utilisateurs quand par exemple ils suivent un [[#internal link]] vers une section de page.

Le second élément qui est optionnel, définit un mode de repli et sert lors des migrations. S'il est présent, il indiquera à MediaWiki d'ajouter un ‎<span> vide à chaque section avec son attribut id et défini sur le titre encodé de repli afin que les liens utilisant le codage précédent fonctionnent toujours.

Exemple : vous souhaitez migrer votre wiki de 'legacy' vers 'html5'. A la première étape, mettre cette variable à [ 'legacy', 'html5' ]. Après un certain temps, quand tous les caches (analyseur, HTTP, etc.) ne contiennent que des pages générées avec ce paramètre, basculer la valeur sur [ 'html5', 'legacy' ]. Cela entraînera la génération de tous les liens internes dans le nouvel encodage, tandis que les anciens liens (à la fois les externes et les internes en cache) continueront à fonctionner. Après un long moment, vous voudrez peut-être abandonner la compatibilité arrière et l'initialiser sur [ 'html5' ]. Après tout cela, les pages sont éditées, en cassant les liens entrants, peu importe le mode fragment utilisé.

Voir aussi