本GitHub库主要存放BearBin所写的一些小工具。
如果在大陆地区无法正常加载，请将链接内的cdn更换为fastly，或直接引用萌百站内的用户页js（下方使用方式中的注释行）。
- 用于快速刷新链接至/嵌入了某个页面的所有页面。
- 在高链入/嵌入量页面使用将会向服务器发送大量请求，请慎重使用！
被源初提着服务器账单找上门概不负责。 - 贡献者：鬼影233
使用：在common.js中加入
mw.loader.load("https://cdn.jsdelivr.net/gh/BearBin1215/MoegirlPedia@master/dist/gadgets/OneKeyPurge.min.js");
// 或 mw.loader.load("/index.php?title=User:BearBin/js/OneKeyPurge.js&action=raw&ctype=text/javascript");- 将Special:MassEdit页面改为批量编辑页面，可以输入页面列表或分类列表，按照指定的规则对页面进行批量替换。
使用：在common.js中加入
mw.loader.load("https://cdn.jsdelivr.net/gh/BearBin1215/MoegirlPedia@master/dist/gadgets/MassEdit.min.js");
// 或 mw.loader.load("https://mzh.moegirl.org.cn/index.php?title=User:BearBin/js/MassEdit.js&action=raw&ctype=text/javascript");- 在搜索页面提供高级搜索按钮，可以在面板中可视化地选择要使用的搜索代码。
使用：在common.js中加入
mw.loader.load("https://cdn.jsdelivr.net/gh/BearBin1215/MoegirlPedia@master/dist/gadgets/AdvancedSearch.min.js");- 从萌娘百科导出指定的页面，将页面及其历史导出为可以在其他MediaWiki站点直接导入的XML文件。在个人js页添加后，前往Special:ExportXML或Special:Export执行导出操作。
- 支持从分类获取页面。
- 目前支持导出历史，暂不支持递归导出模板。
- 由于缺少测试，导出的历史有被删除版本时可能和标准导出功能有一点偏差，欢迎反馈。
使用：在common.js中加入
mw.loader.load("https://cdn.jsdelivr.net/gh/BearBin1215/MoegirlPedia@master/dist/gadgets/ExportXML.min.js");
// 或 mw.loader.load("https://mzh.moegirl.org.cn/index.php?title=User:BearBin/js/ExportXML.js&action=raw&ctype=text/javascript");- 一键查询共享站的非链入使用，避免文件被误判为无使用。
使用：在共享站的common.js中加入
mw.loader.load("https://cdn.jsdelivr.net/gh/BearBin1215/MoegirlPedia@master/dist/gadgets/FileUsedNotLinked.min.js");
// 或 mw.loader.load("https://mzh.moegirl.org.cn/index.php?title=User:BearBin/js/FileUsedNotLinked.js&action=raw&ctype=text/javascript");- 给vector和moeskin的侧边栏区域各自加一个折叠按钮，折叠对应的内容。
使用：在common.js中加入
mw.loader.load("https://cdn.jsdelivr.net/gh/BearBin1215/MoegirlPedia@master/dist/gadgets/SidebarEnhance.min.js");
// 或 mw.loader.load("/index.php?title=User:BearBin/js/SidebarEnhance.js&action=raw&ctype=text/javascript");- 用于在嵌入了{{LyricsKai}}或其衍生模板的页面添加一个按钮，可以自由清除或恢复歌词的样式。
使用：在common.js中加入
mw.loader.load("https://cdn.jsdelivr.net/gh/BearBin1215/MoegirlPedia@master/dist/gadgets/LyricStyleToggle.min.js");
// 或 mw.loader.load("/index.php?title=User:BearBin/js/LyricStyleToggle.js&action=raw&ctype=text/javascript");- 可用于发星章等用途。
- 若用户拥有机器用户，使用此工具发送的消息都会被标记为机器人编辑，不会在最近更改出现。
使用：在common.js中加入
mw.loader.load("https://cdn.jsdelivr.net/gh/BearBin1215/MoegirlPedia@master/dist/gadgets/BatchSend.min.js");
// 或 mw.loader.load("/index.php?title=User:BearBin/js/BatchSend.js&action=raw&ctype=text/javascript");- 用以一次性移动大量页面，共享站理论上也能用。
- 可通过复制粘贴一次输入多个页面。
使用：在common.js中加入
mw.loader.load("https://cdn.jsdelivr.net/gh/BearBin1215/MoegirlPedia@master/dist/gadgets/BulkMove.min.js");
// 或 mw.loader.load("/index.php?title=User:BearBin/js/BulkMove.js&action=raw&ctype=text/javascript");- 可以直接从excel复制表格，生成对应的wikitable，并可以直接复制到剪贴板。
- 按钮添加在编辑工具栏的插入表格按钮右侧：
。 - 不支持老旧浏览器（如IE）。
使用：在common.js中加入
mw.loader.load("https://cdn.jsdelivr.net/gh/BearBin1215/MoegirlPedia@master/dist/gadgets/Excel2Wiki.min.js");
// 或 mw.loader.load("/index.php?title=User:BearBin/js/Excel2Wiki.js&action=raw&ctype=text/javascript");- 为Wikiplus小工具提供快速填充摘要的按钮。
- 编辑章节时支持在章节锚点后添加。
mw.loader.load("https://cdn.jsdelivr.net/gh/BearBin1215/MoegirlPedia@master/dist/gadgets/WikiplusSummary.min.js");
// 或 mw.loader.load("/index.php?title=User:BearBin/js/WikiplusSummary.js&action=raw&ctype=text/javascript");- 在Special:最新页面中添加面板，查询过去的新条目中属于某分类或其子分类的数量。
- 受服务器设置所限，最多统计过去90天的新条目。
使用：在common.js中加入
mw.loader.load("https://cdn.jsdelivr.net/gh/BearBin1215/MoegirlPedia@master/dist/gadgets/NewpagesCat.min.js");
// 或 mw.loader.load("/index.php?title=User:BearBin/js/NewpagesCat.js&action=raw&ctype=text/javascript");- 用于提醒相关用户组内的用户参与提案和人事案投票。
- 若用户拥有机器用户，使用此工具发送的消息都会被标记为机器人编辑，不会在最近更改出现。
使用：在common.js中加入
mw.loader.load("https://cdn.jsdelivr.net/gh/BearBin1215/MoegirlPedia@master/dist/gadgets/VoteRemind.min.js");
// 或 mw.loader.load("/index.php?title=User:BearBin/js/voteRemind.js&action=raw&ctype=text/javascript");主要文件
│ .eslintrc.js # eslint配置
│ .stylelintrc.js #stylelint配置
│ package.json # nodejs配置
│ tsconfig.json # typescript配置
│ pnpm-lock.yaml # lockfile
|
├─.github
│ └─workflows # GitHub Actions配置
│ GadgetSynchronize.yml # 自动同步dist至萌百
|
├─build # 打包配置
| pack.js # 打包脚本
│ webpack.common.js # webpack通用配置
│ webpack.dev.js # 开发配置
| webpack.prod.js # 生产配置
|
├─dist # 打包/编译输出
│ ├─gadgets
│ │ BatchSend.min.js
│ │ ...
│ |
│ └─oddments
│ CommentLink.js
│ ...
|
├─scripts # CI脚本
|
└─src # 源代码
├─components # 用到的一些组件
│ ├─Snake
| |
| └─Loger
|
├─gadgets # 工具源代码
│ ├─BatchSend
│ │ index.ts # 脚本代码
│ │ index.less # 样式表（不一定有）
│ |
│ ├─BulkMove
│ |
│ ├─Excel2Wiki
│ |
│ └─...
|
└─oddments # 小代码
CommentLink.js
EditFromOld.js
...
非常欢迎各路萌百人参与本项目的完善。如果您不懂代码，可以提出建议。如果您希望亲自参与完善，可以提出Pull request。
项目使用pnpm管理依赖，因此需在安装（node<18）或启用（node>=18）后通过pnpm指令安装依赖。
- 小工具源代码位于src/gadgets/目录，使用js、ts和vue3编写都可以，项目会通过webpack处理依赖并打包为单一的可执行js文件。对于需要引用样式表的工具，使用less编写样式表，通过
import语句在js或ts文件中调用。- 使用React和Vue编写的简单实例分别参考Example-React和Example-Vue。
- 项目使用preact的兼容层取代react以减小打包体积、优化性能，在实际编写中请自行查阅文档查看区别。
- 如非技术限制，建议使用react而非vue编写，在使用preact后打包体积为22KB+，而使用vue编写后打包体积为67KB+，已经接近了萌娘百科提交超时界限。
- dist/gadgets/Example-React.min.js: 22.736KB (23282字节)
- dist/gadgets/Example-Vue.min.js: 67.517KB (69137字节)
- 由于首先考虑支持react，本项目不支持使用jsx编写vue。如有需要，请使用渲染函数。
- 样式表有3种导入方式：
- 使用
import './foo.less'，这种情况下样式表经过webpack的处理会自动加载到<head>中。 - 使用
import styles from 'foo.less?module';，样式表将作为CSS Modules导入。 - 使用
import styles from './foo.less' assert { type: 'string' }，该情况下会将样式表内容作为字符串导入，less则会在编译后作为字符串导入。
- 使用
- 小代码于src/oddments/目录，并设定了专门的eslint规则使其仅适用es5语法。
- 使用指令进入开发模式：
开发模式下，所有gadgets都会自动打包输出至dist/dev/目录，文件发生变动会实时更新（Ctrl+S后自动打包）。调试时打开萌百，从对应的实时输出js文件复制到控制台直接运行。
pnpm start
- 开发完毕，打包：
pnpm build <gadget names>
<gadget names>为小工具名，可输入多个，例如pnpm build MassEdit BulkMove会打包src/gadgets/MassEdit和src/gadgets/BulkMove，直接执行pnpm build则打包全部小工具。 输出文件位于dist目录下。 打包完毕并提交后，Github Action会自动读取dist下发生变动的文件，并将其提交到萌百。