Manual:Live preview

From MediaWiki.org
Jump to: navigation, search

Live preview is a feature of MediaWiki which allows showing a preview of an article or section on an edit form without reloading the remaining HTML code of the form.

It has some bugs, see live preview tracking bug for an up to date list.

Enabling live preview[edit | edit source]

Live preview is on or off depending on a setting in the "editing" tab of your user preferences page, by default off.

Advantages[edit | edit source]

  • less incoming traffic: wikicode and all the menus are not received from the server again,
  • faster response time,
  • same cursor position in the editing window.

Disadvantages[edit | edit source]

Only preview area is updated, which means:

  • scripts are not executed if they do not use the wikipage.content hook.
  • some parts of the interface like interlanguage links, transclusion list etc might not be updated correctly.

Technical details[edit | edit source]

A live preview makes use of the Parse API and the difftotext-option of the Revisions API, to submit the new version of the text in order to receive parsed preview or diff changeset in the Edit page.

See also[edit | edit source]

Language: English  • 日本語 • 中文