User:Bhsd/Inspector

Inspector是一款由User:Bhsd开发、源自LLWiki的快速编辑工具，以CC BY-NC-SA 4.0协议将部分核心功能引入萌娘百科使用。以下使用指南同样以CC BY-NC-SA 4.0协议引自LLWiki。

功能介绍

这个小工具会在桌面版用户打开内容页面时加载，加载后在页面右侧添加一个可隐藏的编辑区，左侧显示页面原有内容。进行编辑后可以随时预览，确认无误后可以经API提交。由于采用原处预览的方式，预览效果与编辑完成后的实际效果基本一致。与此同时，左侧页面、右侧源代码的并排呈现方式也便于比对代码与显示效果。

以下列举一些具体功能：

• 编辑区正确高亮Wikitext、JavaScript、CSS或Lua语法并标注行号。
• 右键点击“提交”按钮可以修改本次编辑摘要。
• 双击段落标题可以进入段落编辑模式，双击页面标题可以回到全文编辑模式。
• 段落编辑时，自动生成的编辑摘要可以正确地指向对应段落的hash值。
• 随时可以复原成未编辑的状态。
• 原处预览，预览的CSS样式与实际效果一致，且能够正确加载mw-collapsible类、{{Tabs}}等常用JS，编辑模板页面时也能够正确预览修改后的模板的嵌入效果。
• 除正文外，还能预览分类、显示标题和<indicator>。
• 提交编辑时检测有无编辑冲突，无法判断时跳转到页面历史以方便检查。
• 編輯區按下Ctrl+F或⌘ Cmd+F可以进行文字查找，Ctrl+G或⌘ Cmd+G查找下一处，⇧ Shift+Ctrl+G或⇧ Shift+⌘ Cmd+G查找上一处。还可以进一步开启文本正则查找与替換功能（使用方法见#偏好设置）。
• 开启地区字词预览功能时，右键点击“预览”按钮可以更改预览所用的内容语言（开启方法见#偏好设置）。
• 编辑区宽度调节（开启方法见#偏好设置）。
• HTML字符实体转换（开启方法见#偏好设置）。
• 在差异页面可快速跳转至差异所在行（开启方法见#偏好设置）。

基本使用方法

在您的个人JS页面添加以下代码：

mw.loader.load('/index.php?title=user:bhsd/js/inspect.js&action=raw&ctype=text/javascript');

按需加载

您也可以将上面的加载代码替换为為以下内容，这将向网页右上角的“更多”菜單中加入一項“Inspector”，只在需要時手動点击以加載Inspector編輯器：

if (mw.config.get( 'wgIsArticle' ) && mw.config.get( 'skin' ) == 'vector') {
    mw.loader.using( 'mediawiki.util' ).then(function() {
        $(mw.util.addPortletLink('p-cactions', '#', 'Inspector')).click(function(e) {
            e.preventDefault();
            this.remove();
            mw.loader.load('/index.php?title=user:bhsd/js/inspect.js&action=raw&ctype=text/javascript');
        });
    });
}

偏好设置

您可以在个人JS页面定义一个名为window.inspector的全局对象进行偏好设置。这个对象的声明需要位于加载这个小工具之前。以下列出这个对象可选的设置：

默认摘要

summary: '我的默认摘要'

这里的文字部分可以自定义，作为每次编辑的默认摘要。注意段落编辑时指向段落的链接是必定存在的，不需要也不能写入默认摘要。

开启地区字词预览功能

variants: true

提供“大陆简体”、“臺灣繁體”和“香港繁體”三种语言变体用于预览，右键“预览”按钮即可随时切换。

开启正则查找与替换功能

replace: true

在编辑区按下Ctrl+F或⌘ Cmd+F键时将打开一个可以随意拖拽的对话框，对话框提供了严格/不区分大小写/正则等数种模式的查找与替换功能，替换区可以使用分行的文字，发生误操作时还可以撤销最后一次替换。按下Ctrl+H或⌘ Cmd+H可直接替换下一处。Ctrl+G或⌘ Cmd+G仍然作为查找下一处的快捷键。

自由调节编辑区宽度

resizable: true

编辑区处于开启状态时，在左侧可以用鼠标拖拽调节宽度。

HTML字符实体

entity: true

在编辑区按下Ctrl+/或⌘ Cmd+/键时将当前选中的文字替换为对应的HTML字符实体。

跳转至差异所在行

diff: true

在差异页面进行全文编辑时，双击页面上方差异（table.diff）的任一行即可跳转到编辑区源代码的对应行。

使用与默认编辑器类似的上下布局（beta）

layout: 'vertical'

合并示范

window.inspector = {
	summary: "我的默认摘要",
	variants: true,
	replace: true,
	resizable: true,
	entity: true,
	diff: true
};
mw.loader.load( '/index.php?title=user:bhsd/js/inspect.js&action=raw&ctype=text/javascript' );

未来的更新

目前还有很多LLWiki版原有的功能尚未引入，未来可能会继续更新以提供新功能。这些功能一般会以可选的形式加入，欢迎萌百的各位小工具使用者将这个帮助页面加入监视列表以便随时了解最新功能。

友情链接

如果Inspector不能满足您形形色色的需求，又或者是您在寻找一款对移动设备更友好的快速编辑工具，那您不妨试试由机智的小鱼君开发的小工具。是一个功能众多的小工具集，且已被萌娘百科列入官方认可的小工具列表，在参数设置中即可一键启用。关于的更多信息，请查阅详细介绍。