Manual:Live preview/zh-hans

实时预览是MediaWiki的一项用以预览的功能，它可以在不重新加载原有HTML代码的情况下显示条目或章节的预览。

优点

• 传入流量更少：不会再次从服务器获取wiki代码和所有菜单，
• 响应时间更短，
• 编辑窗体中的光标位置不变。

缺点：只更新预览区域，这意味着：

• 不更新跨wiki链接、分类以及使用模板列表，
• 遗失非必需的css文件（例如，假如用户添加了<source>标签），
• 不执行脚本（例如可排序表格）。

技术细节

当通过“edit"（编辑）操作（action）提交页面时，倘若设定了特定的标识，则会返回所给MediaWiki标记字符串的实时预览。

下列index.php的参数应通过POST请求传递：

1. title=Page_Title
2. wpPreview=true
3. live=true
4. wpTextbox1=String

结果就是该字符串的预览被作为wpTextbox1的值传递给客户端。类似于浏览页面时对index.php使用action=render参数的结果。

只当所给字符串包含类似{{PAGENAME}}的魔术字时，才会真正使用到标题参数。

实现

此功能须通过编辑表单中的“实时预览”按钮，及其所使用的JavaScript代码实现。该按钮应将带有live标识的文本提交给服务器，并显示返回的预览。

维基媒体各项目目前并未启用实时预览，可能出于对某些早期浏览器的兼容性尚不完善的原因。

然而，已可使用部分用户的脚本，例如qPreview和Quick Preview。

亦能使用内建的preview.js脚本。

其他用途

实时预览还能被用于编辑窗体以外的用途。例如，（在Linux中）执行下列命令，会显示中文维基百科当前的14位时间戳：

curl -f -m 60 -d "" "http://zh.wikipedia.org/w/index.php?title=Main_Page&action=edit&wpPreview=true&live=true&wpTextbox1=20130617134036"

注意目前API中也有相似的预览功能。

启用实时预览

实时预览的启用与否取决于LocalSettings.php中的$wgLivePreview变量。要激活该功能，你还需要在“我的参数设置”的“编辑”中予以开启。