Jump to content

Manual:$wgFragmentMode/diq

From mediawiki.org
This page is a translated version of the page Manual:$wgFragmentMode and the translation is 5% complete.
Output: $wgFragmentMode
Determines how section IDs should be encoded
Introduced in version:1.30.0 (Gerrit change 362326; git #Id304010)
Removed in version:Still in use
Allowed values:(array)
Default value:[ 'html5', 'legacy', ] (1.37+)

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

[ 'legacy' ] (1.30)

Determines how section IDs should be encoded.

Details

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.


Bıvênên