用戶: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不能滿足您形形色色的需求，又或者是您在尋找一款對流動裝置更友好的快速編輯工具，那您不妨試試由機智的小魚君開發的小工具。是一個功能眾多的小工具集，且已被萌娘百科列入官方認可的小工具列表，在參數設置中即可一鍵啟用。關於的更多信息，請查閱詳細介紹。