Jump to content


From mediawiki.org
This page is a translated version of the page Manual:$wgFragmentMode and the translation is 15% complete.
Wyjście: $wgFragmentMode
Determines how section IDs should be encoded
Wprowadzono w wersji:1.30.0 (Gerrit change 362326; git #Id304010)
Usunięto w wersji:nadal w użyciu
Dozwolone wartości:(array)
Domyślna wartość:[ 'html5', 'legacy', ] (1.37+)

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

[ 'legacy' ] (1.30)

Determines how section IDs should be encoded.


This array can contain 1 or 2 elements, each of them can be one of:

  • 'html5' - modern HTML5 style encoding with minimal escaping. Displays Unicode characters in many browsers' address bars.
  • 'legacy' - old MediaWiki-style encoding, e.g. 手紙 turns into .E6.89.8B.E7.B4.99.
  • 'html5-legacy' corresponds to the DEPRECATED $wgExperimentalHtmlIds mode. DO NOT use it for anything but migration off that mode (see below).

The first element of this array specifies the primary mode of escaping IDs. This is what users will see when they e.g. follow an [[#internal link]] to a section of a page.

The optional second element defines a fallback mode, useful for migrations. If present, it will direct MediaWiki to add an empty ‎<span> to every section with its id attribute set to the fallback-encoded title so that links using the previous encoding still works.

Example: you want to migrate your wiki from 'legacy' to 'html5'. On the first step, set this variable to [ 'legacy', 'html5' ]. After a while, when all caches (parser, HTTP, etc.) contain only pages generated with this setting, flip the value to [ 'html5', 'legacy' ]. This will result in all internal links being generated in the new encoding while old links (both external and cached internal) will still work. After a long time, you might want to ditch backwards compatibility and set it to [ 'html5' ]. After all, pages get edited, breaking incoming links no matter which fragment mode is used.

Zobacz też