Manual:$wgFragmentMode

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:$wgFragmentMode and the translation is 45% complete.

Other languages:
English • ‎magyar • ‎polski • ‎中文 • ‎日本語
構文解析: $wgFragmentMode
セクション ID がどのようにエンコードされるべきかを決定します
導入されたバージョン:1.30.0 (Gerrit change 362326; git #Id304010)
除去されたバージョン:使用中
許容される値:(配列)
既定値:[ 'legacy', 'html5' ] (1.31-)
[ 'legacy' ] (1.30)

Determines how section IDs should be encoded.

詳細

この配列は1つまたは2つの要素を含むことができます。各要素は以下のいずれかです:

  • 'html5' - 最小限のエスケープであるモダンな HTML5 スタイルエンコーディング。多くのブラウザのアドレスバーにおいて Unicode 文字が表示されるようにします。
  • 'legacy' - 古い MediaWiki スタイルエンコーディング。例:啤酒 は .E5.95.A4.E9.85.92 になります。
  • 'html5-legacy' 非推奨$wgExperimentalHtmlIds モードに対応します。そのモードを止めるための移行以外では使用しないでください(以下を参照)。

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 empty <span> to every section with its id attribute set to fallback encoded title so that links using the previous encoding would still work.

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.

関連項目