Manual:Live preview/zh

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

优点

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

缺点：只更新预览区域，这意味着：
 * 不更新跨wiki链接、分类以及使用模板列表，
 * 遗失非必需的css文件（例如，假如用户添加了&lt;source>标签），
 * 不执行脚本（例如可排序表格）.

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

下列index.php的参数应通过POST请求传递：
 * 1) title=Page_Title
 * 2) wpPreview=true
 * 3) live=true
 * 4) wpTextbox1=String

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

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

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

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

然而，已可使用部分用户的脚本，例如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="

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

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