跳至內容

Bleap Wiki:编辑规范

出自Bleap Wiki

编辑规范：Bleap Wiki 的编辑操作细则。 原则性内容（为什么这样要求）见子页 编辑方针。

一、账号与权限

  • 注册账号后即可编辑（注册需通过验证码）
  • 新账号需注册满 4 天且编辑满 10 次（成为自动确认用户）后才能上传文件
  • 自动确认用户即可编辑本站数据页（如 模板:曲目列表.json），但重大或结构性改动须先在讨论版提出
  • 上传时必须选择许可协议并填写来源（见第六、七节）
  • 管理员：Admin（站务、权限、页面删除、版本删除）
  • 批量编辑权限（机器人标记/批量工具）须申请，见第九节

二、命名空间与页面命名

命名空间 编号 用途 示例
（主） 0 一般条目 游戏界面
User: 2 用户页与个人沙盒 User:Admin/沙盒
Bleap Wiki: 4 站务页面 Bleap Wiki:编辑规范
File: 6 文件描述页 File:曲绘-NRG.png
模板: 10 模板与 JSON 数据页 模板:曲目列表.json
分类: 14 分类 分类:官方素材文件
模块: 828 Lua 渲染模块 模块:曲目列表
曲目: 3000 单曲页面 曲目:NRG
装扮物品: 3010 装扮类物品页面 （待建）

命名规则

  • 曲目页：曲目:{曲名}。曲名以游戏内显示名为准；含特殊字符时按实际标题处理，
 例如 曲目:＃palettechifuyu 使用全角 ＃ 以规避标题解析问题
  • 曲包页：曲包:{包名}　·　装扮物品页：装扮物品:{物品名}
  • 文件命名：见 文件上传规范
  • 曲目／曲包／装扮物品页面按上述命名规则直接创建即可；
 主命名空间的新页面（如机制、术语类条目）建议先在讨论版提出，避免与他人撞车
  • 角色页与剧情页沿用现有命名方式（如 角色设定-{角色名}），暂不调整

三、页面结构规范

同类页面应保持统一结构（原则见 编辑方针）。

3.1 曲目页

  • 使用 {{曲目信息框}}，字段完整填写；数据类字段不手写数字，由数据页与模块生成
  • 谱师名保持游戏内原名，不要自行翻译或改写
  • 名称翻译、定数调整历史写在「游戏相关」章节
  • 歌词段落：纯音乐曲目留空即可（模块默认显示「纯音乐，请欣赏」）；有人声的曲目请填写歌词或暂留「（待补充）」
  • 曲目页必须添加 [[Category:曲目]]
  • 新曲建页可使用本页第十一节的工具与预载模板

3.2 曲包页 / 3.3 装扮物品页

  • 曲包页添加 [[Category:曲包]]；装扮物品按物品类型归类
  • 字段清单随首批评审页面逐步固定，新增字段请先讨论

3.4 列表与数据页（重要）

本站的曲目列表、曲包列表、定数表、曲师列表、谱师列表均为 JSON 数据页 + Lua 模块渲染， 不是手写表格：

数据页 渲染模块 说明
模板:曲目列表.json 模块:曲目列表／模块:定数表／模块:曲包列表 结构必须为对象 {"songs":[…],"special":[…]}
模板:曲师映射.json／模板:谱师映射.json 模块:曲师列表／模块:谱师列表 名称映射（显示名、排序）
模板:曲师简介／模板:谱师简介 同上 简介文本（按章节）
  • 禁止直接编辑列表页中的表格：改动会在下次渲染时被覆盖
  • 修改数据页后需刷新列表页缓存（?action=purge 或空编辑）
  • 数据页结构写错会导致所有列表页空白：改动前先阅读 模板:曲目列表.json/Docs，
 重大或结构性改动先在讨论版说明
  • 现在有结构自检：数据页缺失/JSON 语法错/缺少 songs 数组时，
 列表页会显示红色报错并自动归入 分类:数据页异常（不再静默渲染成空表）
  • 编辑数据页时页面顶部会出现结构提示（Editnotice）

3.5 语言标注（日文／繁体原名）

  • 游戏内的原名一律保持原字：日文汉字、假名、繁体都不要自行改成简体（转换由页面级开关控制，见下）
  • 需要标注语言时用 {{Lang}}：光速105号XXX線
    • 该模板输出带 lang 属性的 span，并让所在页面不再进行繁简转换；未使用该模板的页面仍会转换
  • 不要手写 -{…}-：曲目页与各列表页由数据模块整页声明了"不转换"，转换器不运行时该标记不会被处理，
 会原样显示成 -{光速105号XXX線}-（此问题已于 2026-10-03 修复）
  • 数据页里的 lang 字段（如 "lang": "ja"）会让模块自动用 {{Lang}} 包裹曲名，无需在页面里重复写

四、数据维护流程

4.1 新曲上线

  1. 更新 模板:曲目列表.json：新增曲目条目（曲名、曲师、谱师、定数、曲绘文件名、链接名等）
  2. 同步定数（见 4.2 的优先级）
  3. 创建曲目页：使用预载模板或工具生成骨架（含 {{曲目信息框}} 与分类）
  4. 上传曲绘：命名 曲绘-{曲名}.png，按第七节挂版权模板
  5. 刷新相关列表页缓存

4.2 定数标准

  • 定数优先级：解包数据 ≈ 官方公告 > 游戏内显示
 —— 游戏内通常只显示整数或「整数+」，精确小数点值以解包数据与官方公告为准
  • 两者冲突时以官方公告为最终依据，并在页面注明来源版本
  • 定数调整需同步更新历史记录（写入「游戏相关」章节）

4.3 版本更新

  • 版本更新后核对新曲、新装扮、活动信息，更新 Bleap Wiki:待办项
  • 顺手检查旧数据是否失效（下架曲目、改动数值）

4.4 曲师／谱师映射与署名

 会把 A vs B、A / B、A feat. B、A & B 等拆成单人名，
 括号内容作为注释；w/csθ、↑=192.333kb/s、t+pazolite 这类"单人名义"在白名单里不拆

 显示名（必用）、简介、排序键（可选覆盖，未填则按默认排序）。
 已删除无用的 _曲目数——它没有任何模块读取、也无法随 模板:曲目列表.json 更新，只会悄悄过期
  • 曲目数改为列表页实时统计（每个曲师标题下显示"共 N 首曲目"，谱师显示"共 N 张谱面（涉及 M 首曲目）"）
  • 新曲上线后，请到 Bleap Wiki:映射检查 查看是否有未建映射的名字；补映射时键 = 归一化名（去空格 + 全小写）

4.5 工具

站内工具（所有编辑者可用） 

 已建的显示蓝链、未建的显示红链，并带「预载创建」入口一键建页

已上线的站内自检

  • 数据页结构自检：模块:数据页校验（被 曲目列表／曲包列表／定数表／曲目页面／曲师列表／谱师列表 调用）——
 数据页不存在、JSON 语法错、缺少 songs、songs 为空时显示红色报错并归入 分类:数据页异常
  • 数据页编辑提示：MediaWiki:Editnotice-10-*.json（曲目列表／曲师映射／谱师映射）

服务器端工具（需 shell 权限，普通编辑者不可用）

  • `wiki-tool/update`：批量推送曲目数据、同步定数（--sync-constants）、生成曲目页（--create-song-pages）
  • `wiki-tool/protocol`：版权与协议内容推送、文件页批量标注
  • 需要批量操作时，请在 Bleap Wiki:待办项 登记并联系管理员

五、编辑操作

  • 改动前先点「显示预览」；重大改动必须填写编辑摘要，小改动建议填写
  • 小改动（错别字、格式）可勾选「小编辑」
  • 改动他人内容若有异议，先在讨论版沟通，不要连续回退（避免编辑战）
  • 撤销与回退：优先用「撤销」（保留记录），必要时用「回退」
  • 明显破坏（清空页面、插入广告／谣言／恶作剧）管理员可直接回退

5.1 提示与标记模板

本站有三类提示件，作用域和受众不同，不要用混：

模板 放在哪 谁看得见 用来表达
{{维护提示}} 页面最顶部 仅登录用户 整页状态：维护／谨慎／禁止／待补／过时／施工
{{编辑提示}} 页面顶部或对应小节 仅登录用户 编辑指引：该去哪里改（数据页、来源、模板）
{{标记}} 行内，贴在句子或表格单元后面 所有人 局部内容质量：存疑／过时／原创

{{标记}}：内容标记（读者可见的"小卡片"，鼠标悬停显示备注） 

本曲定数在 v1.0.3.14 后未再核对{{标记|类型=过时}}。
解锁方式仅在剧情模式中出现{{标记|类型=存疑|备注=官方未公布}}。
该译名为编者推断{{标记|类型=原创|备注=未见官方中译}}。
  • 类型：存疑（橙，内容存疑／未经证实／官方未公布）／过时（灰，过时内容／未补全）／原创（紫，原创研究／来源不清）；缺省为"存疑"
  • 备注：可选，写具体缘由，鼠标悬停显示；参数名与 {{维护提示}}、{{编辑提示}} 保持一致
  • 备注里不要写英文双引号 "（会截断悬停提示属性），需要引号请用「」
  • 按类型自动归入 分类:内容存疑／分类:内容过时／分类:原创研究，便于集中清理
  • 使用建议
    • 少而准：一段内容贴一个标记，不要逐句贴
    • 处理完请及时移除标记；长期挂着的标记会失去提醒作用
    • 只是"以后要写"的计划性内容请用 {{维护提示}} 或到 Bleap Wiki:待办项 登记，不要用 {{标记}}

5.2 编辑摘要

  • 摘要写清"改了什么、依据是什么"（例：定数同步 v1.0.3.14（游戏内实测））
  • 批量/机器人编辑请在摘要中注明工具与来源

六、文件上传

  • 命名规范见 文件上传规范
  • 上传时必须填写来源、作者／权利人，并选择许可协议
  • 上传后文件页应包含：
{{文件信息
|描述=…|来源=…|作者=…|授权=…}}
{{版权-官方素材}}

七、版权与来源

  • 官方素材（曲绘、立绘、图标、新闻图等）一律使用 {{版权-官方素材}}，
 不得改挂 CC 模板；其版权归官方及相应权利人，本站仅作介绍展示

 {{版权-CC-BY-NC-4.0}}／{{版权-保留所有权利}}。
 注意：非商业（NC）协议与本站文字使用的 CC BY-SA 4.0 互不兼容，NC 文件的改编必须继续采用 NC
  • 引用游戏内文本、官方公告须注明来源（版本号 + 获取方式）
  • 不得整体复制其他网站的条目文字或表格数据；可以参考后自行整理并注明出处
  • 从其他语言资料（日文／英文）翻译或转述内容时：须标注来源并人工校对，
 不得直接粘贴机翻结果
  • 本站原创内容以 CC BY-SA 4.0 释出：其他站点引用时须署名并采用相同协议（详见 Bleap Wiki:版权）

八、讨论与共识

  • 页面讨论：使用页面顶部的评论／讨论版（FlowThread）
  • 待办认领：在 Bleap Wiki:待办项 登记或认领，避免多人同时改同一项
  • 重大改动（页面重命名、批量改动、数据页结构调整）建议公示 7 天，无异议后执行；紧急破坏可先处理后说明
  • 方针类修改（本规范、编辑方针、版权与隐私政策等）
 须经管理员之间讨论后再执行，不应由单人直接改动

九、机器人、批量编辑与工具

  • 批量编辑须先申请，由管理员确认后授予批量编辑权限
  • 权限有效期约一个月，到期由管理员复核是否续期（可视编辑者活跃度调整）
  • 批量编辑必须遵守：
 ** 每次批量编辑都带变更标签，便于筛选、统计与回退
 ** 编辑摘要写明批次用途
 ** 具备可回退能力（保留旧内容或可一键还原）
 ** 不与人工编辑争抢同一批页面
  • 现役工具：`wiki-tool/update`（曲目数据）、`wiki-tool/protocol`（版权内容与文件标注），
 使用记录见 Bleap Wiki:待办项

十、违规处理与申诉

  • 处理分级：提醒与引导 → 警告 → 短期封禁（1 天／7 天）→ 长期封禁；
 破坏性编辑（清空、广告、谣言）可直接回退并封禁
  • 首次违规以提醒和引导为主（见 编辑方针）
  • 申诉渠道：
  • 对处理有异议时，请在讨论版提出申请，由管理员复核

十一、附：常见任务速查

我想… 怎么做
加一首新曲 见第四节 4.1：数据页 → 同步定数 → 建页 → 传曲绘 → 刷缓存
改一个定数 改 模板:曲目列表.json 对应字段（按 4.2 优先级核对来源）→ 刷新列表页缓存
上传一张曲绘 命名 曲绘-{曲名}.png → 许可选「官方素材」→ 文件页自动带版权模板
补一个曲师简介 编辑 模板:曲师简介 对应章节，或在 Bleap Wiki:待办项 认领
标记某段内容可能不准 用 {{标记}}（见 5.1），并在 备注 写明缘由
提示"这一页有问题" 用 {{维护提示}}（页首，仅登录可见）
报告错误 在对应页面讨论版留言，或通过 Bleap Wiki:Contact 联系
第一次用这个 wiki 读 Bleap Wiki:新手入门
看哪些曲目还没建页 待建曲目（进度看板，红链＝未建）
取自「https://wiki.liushuilingling.com/index.php?title=Bleap_Wiki:编辑规范&oldid=5826」