维基百科:维基百科工具/编辑工具
 | 此頁面目前處於閒置狀態，僅供歷史參考而保留。 此頁面最後更新於2021年3月20日 (六) 03:23 (UTC)。此頁面的內容可能已無明確的共識支持，或是不再與討論的主題相關。若您希望重啟討論，請至互助客棧尋求更廣泛的意見。 |
目前中文維基百科可以訂製編輯工具欄按鈕，请注册一个维基用户，登录后可以在參數設置的“小工具”面板中勾選你所需要的的編輯工具擴展。
本操作指南只適用於維基百科舊面板MonoBook，預設面板Vector的使用說明請到可用性小組維基查閱。
說明
大多數情況下，用戶只需勾選常用或全功能編輯按鈕擴展之一即可。
| 编辑按钮扩展 | 调用脚本页面 | 說明 | 維護者 |
|---|---|---|---|
| （不勾選） | 维基系统MediaWiki内建 | 維基系統內建的編輯按鈕布局 | |
| EE1 常用 | MediaWiki:edittool-default.js | 提供比內建按鈕更多的常用按鈕； | |
| EE2 全功能 | MediaWiki:edittool-plus.js | 較完整的按鈕，系統載入編輯頁面按钮图像的開銷較大； | |
| EE3 用戶自定義 | User:你的用戶頁名/customEdittools.js | 用戶自定義編輯按鈕擴展； | 你 |
| EE4 管理員用 | Wikipedia:維基百科工具/編輯工具/admin.js | 包含刪除管理、轉換管理 | User:Fdcn |
| EE5 刪除管理 | Wikipedia:維基百科工具/編輯工具/vfd.js | 生成一個管理刪除的下拉選單，應與其它按鈕擴展組合 | User:Alexsh User:Fdcn |
| EE6 語言轉換 | Wikipedia:維基百科工具/編輯工具/zhc.js | 生成一個管理轉換的下拉選單，應與其它按鈕擴展組合 | |
| EE7 参考文献 | Wikipedia:維基百科工具/編輯工具/cite.js | 在编辑工具栏的"条目编辑"下拉选单中增加参考文献高级模板，必須與其它有articleEdit選單的按鈕擴展組合 | |
| EE8 参考文献工具 | MediaWiki:Gadget-refToolbar.js | 在编辑工具栏增加一个“引用”按钮，可以快捷的使用文献引用模板。参考Wikipedia:RefToolbar（英文）及本地說明文件Wikipedia:參考文獻工具列。 |
用戶自定義佈局模式，可參照MediaWiki:edittool-plus.js來自行建立。 为了实现更多的功能，可以同時勾選多個按鈕擴展以組合成一個更強大的按鈕工具欄。
效果
- 系統內建編輯按鈕
- EE1 常用编辑按钮扩展
- EE2 全功能編輯按鈕擴展
自定义编辑按钮布局
- 建立用户自定义布局
參數設置中，選擇「小工具」，復將“用戶自定義編輯按鈕擴展”勾選。
現在您可以仿照MediaWiki:edittool-default.js或MediaWiki:edittool-plus.js页面在User:你的用戶頁名/customEdittools.js页面下输入脚本代码；
高階應用
当人们调用了一个已建立的布局或模式并使用一段时间之后，可能觉得这个布局未必能完全符合个人的习惯或需要，希望对这个布局进行少量的调整，比如果要增加或去除幾個按鈕或下拉選單。这时人们不必费事建一個全新的編輯按鈕擴展腳本文件，而是可以通过对已有編輯按鈕擴展和“用戶自定義”編輯按鈕擴展的联合调用来实现布局微调。例如若对“全功能”編輯按鈕擴展进行微调，只需在同時勾選EE2與EE3，然後在用戶布局脚本頁面中进行修改以实现对前一个布局的微调。
在一个腳本文件中，每一個增加按鈕（或下拉選單）的函數調用，它的第一個參數就是該按鈕（或下拉選單）的id值，用這個id值就可以進行刪減操作。數組mwCustomEditButtons存放著所有按鈕或下拉選單的信息和相关的方法。
下表中的工具对象可是是一个按钮、下拉选单或用户自行定义的其它编辑工具对象。(文档未完成)
以下設定只是MonoBook面板的設定，不能對Vector的新wikiEditor作出更改，要對Vector的作出更改，請參見可用性小組網頁 （英文）。
| 动作 | API | 说明 |
|---|---|---|
| 获得已有工具对象 | mwCustomEditButtons[id] | id为字符串值或下标数字 |
| 新增加加一个按钮 | addEditButton(id,{
src : '图像在Commons计划的URL后半部分',
tagOpen : '插入前缀',
sampleText : '示例文字',
tagClose : '插入后缀',
speedTip : '弹出提示',
width : '按钮宽度',//本行可省略
action : 按钮的行为 //本行可省略
});
|
加入一个按钮到编辑工具栏最后的位置 第一个参数是一个字符串，要求是唯一标志这个按钮的。 |
| 新建一个按钮 | createEditButton(id,attrs);
|
返回一个按钮对象，但这个按钮只是产生出来，还没有加入到编辑工具栏中，看不见。 两参数同addEditButton，第二个参数请参照addEditButton示例用字面量表示。 |
| 新增加一个下拉选单 | addDropdownMenu(id,text,options,attrs);
|
把一个下拉选单加入到编辑工具栏的最后。 参数id:唯一标志这个按钮的字符串； |
| 新建一个下拉选单 | createDropdownMenu(id,title,attrs);
|
返回一个下拉选单对象，但这个下拉选单只是产生出来，还没有加入到编辑工具栏中，看不见。 参数id:唯一标志这个按钮的字符串； |
| 插入一个工具 | mwCustomEditButtons.insert(item,ref,pos);
|
把一个工具对象加入到编辑工具栏中。 参数item:要插入的工具对象； 参数ref:参照工具对象（可以是按钮对象或下拉选单对象），省略时插入到编辑工具栏的最后，指定时放在参照工具对象之前或之后； |
| 删除一个工具 | mwCustomEditButtons.remove(id);
|
把一个工具对象（按钮对象或下拉选单）从编辑工具栏中删除。 参数id:要删除的工具对象或其id值 |
| 下拉选单增加项 | 待补全文档 | |
| 下拉选单减少项 | 待补全文档 |