查看“︁Bleap Wiki:编辑规范”︁的源代码

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

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

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

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

== 三、页面结构规范 ==
同类页面应保持'''统一结构'''（原则见 [[Bleap Wiki:编辑规范/编辑方针|编辑方针]]）。

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

=== 3.2 曲包页 / 3.3 装扮物品页 ===
* 曲包页添加 <code><nowiki>[[Category:曲包]]</nowiki></code>；装扮物品按物品类型归类
* 字段清单随首批评审页面逐步固定，新增字段请先讨论

=== 3.4 列表与数据页（重要） ===
本站的'''曲目列表、曲包列表、定数表、曲师列表、谱师列表'''均为 '''JSON 数据页 + Lua 模块'''渲染，
不是手写表格：

{| class="wikitable"
! 数据页 !! 渲染模块 !! 说明
|-
| [[模板:曲目列表.json]] || [[模块:曲目列表]]／[[模块:定数表]]／[[模块:曲包列表]] || 结构必须为对象 <code>{"songs":[…],"special":[…]}</code>
|-
| [[模板:曲师映射.json]]／[[模板:谱师映射.json]] || [[模块:曲师列表]]／[[模块:谱师列表]] || 名称映射（显示名、排序）
|-
| [[模板:曲师简介]]／[[模板:谱师简介]] || 同上 || 简介文本（按章节）
|}

* '''禁止'''直接编辑列表页中的表格：改动会在下次渲染时被覆盖
* 修改数据页后需'''刷新列表页缓存'''（<code>?action=purge</code> 或空编辑）
* 数据页结构写错会导致'''所有列表页空白'''：改动前先阅读 [[模板:曲目列表.json/Docs]]，
  重大或结构性改动先在讨论版说明
* 现在有'''结构自检'''：数据页缺失/JSON 语法错/缺少 <code>songs</code> 数组时，
  列表页会显示'''红色报错'''并自动归入 [[:分类:数据页异常]]（不再静默渲染成空表）
* 编辑数据页时页面顶部会出现结构提示（Editnotice）

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

== 四、数据维护流程 ==
=== 4.1 新曲上线 ===
# 更新 [[模板:曲目列表.json]]：新增曲目条目（曲名、曲师、谱师、定数、曲绘文件名、链接名等）
# 同步定数（见 4.2 的优先级）
# 创建曲目页：使用预载模板或工具生成骨架（含 {{tl|曲目信息框}} 与分类）
# 上传曲绘：命名 <code>曲绘-{曲名}.png</code>，按第七节挂版权模板
# 刷新相关列表页缓存

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

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

=== 4.4 曲师／谱师映射与署名 ===
* 署名（曲师、谱师）的'''拆词规则统一由 [[模块:署名解析]] 提供'''：
  会把 <code>A vs B</code>、<code>A / B</code>、<code>A feat. B</code>、<code>A & B</code> 等拆成单人名，
  括号内容作为注释；<code>w/csθ</code>、<code>↑=192.333kb/s</code>、<code>t+pazolite</code> 这类"单人名义"在白名单里不拆
* [[模板:曲师映射.json]]／[[模板:谱师映射.json]] 只保留三个字段：
  <code>显示名</code>（必用）、<code>简介</code>、<code>排序键</code>（可选覆盖，未填则按默认排序）。
  '''已删除无用的 <code>_曲目数</code>'''——它没有任何模块读取、也无法随 [[模板:曲目列表.json]] 更新，只会悄悄过期
* 曲目数改为'''列表页实时统计'''（每个曲师标题下显示"共 N 首曲目"，谱师显示"共 N 张谱面（涉及 M 首曲目）"）
* 新曲上线后，请到 [[Bleap Wiki:映射检查]] 查看是否有未建映射的名字；补映射时键 = 归一化名（去空格 + 全小写）

=== 4.5 工具 ===
'''站内工具（所有编辑者可用）'''
* [[待建曲目]]：曲目页建设进度看板（由 [[模块:曲目待建清单]] 渲染）——列出数据页全部曲目，
  已建的显示蓝链、未建的显示红链，并带「预载创建」入口一键建页
* {{tl|曲目页面/预载}}：新建曲目页时套用的骨架（由 [[模块:曲目页面]] 渲染）
* [[模板:曲目列表.json/Docs]]：数据页字段说明

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

'''服务器端工具（需 shell 权限，普通编辑者不可用）'''
* `wiki-tool/update`：批量推送曲目数据、同步定数（<code>--sync-constants</code>）、生成曲目页（<code>--create-song-pages</code>）
* `wiki-tool/protocol`：版权与协议内容推送、文件页批量标注
* 需要批量操作时，请在 [[Bleap Wiki:待办项]] 登记并联系管理员

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

=== 5.1 提示与标记模板 ===
本站有三类提示件，'''作用域和受众不同，不要用混'''：

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

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

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

== 六、文件上传 ==
* 命名规范见 [[Bleap Wiki:编辑规范/文件上传|文件上传规范]]
* 上传时必须填写'''来源'''、'''作者／权利人'''，并选择'''许可协议'''
* 上传后文件页应包含：
<pre>
{{文件信息
|描述=…|来源=…|作者=…|授权=…}}
{{版权-官方素材}}
</pre>
* 来源与授权缺失的文件会归入 [[:分类:授权待补文件]]，请及时补全

== 七、版权与来源 ==
* '''官方素材'''（曲绘、立绘、图标、新闻图等）一律使用 {{tl|版权-官方素材}}，
  '''不得'''改挂 CC 模板；其版权归官方及相应权利人，本站仅作介绍展示
* '''自创文件'''由上传者选择协议：{{tl|版权-CC-BY-SA-4.0}}／{{tl|版权-CC-BY-NC-SA-4.0}}／
  {{tl|版权-CC-BY-NC-4.0}}／{{tl|版权-保留所有权利}}。
  注意：非商业（NC）协议与本站文字使用的 CC BY-SA 4.0 '''互不兼容'''，NC 文件的改编必须继续采用 NC
* 引用游戏内文本、官方公告须注明来源（版本号 + 获取方式）
* '''不得整体复制'''其他网站的条目文字或表格数据；可以参考后自行整理并注明出处
* 从其他语言资料（日文／英文）'''翻译或转述'''内容时：须'''标注来源'''并'''人工校对'''，
  不得直接粘贴机翻结果
* 本站原创内容以 CC BY-SA 4.0 释出：其他站点引用时须'''署名并采用相同协议'''（详见 [[Bleap Wiki:版权]]）

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

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

== 十、违规处理与申诉 ==
* 处理分级：提醒与引导 → 警告 → 短期封禁（1 天／7 天）→ 长期封禁；
  破坏性编辑（清空、广告、谣言）可直接回退并封禁
* 首次违规以提醒和引导为主（见 [[Bleap Wiki:编辑规范/编辑方针|编辑方针]]）
* '''申诉渠道'''：<!-- 待站长填写：例如 QQ 群 / 站内讨论版 / 邮箱 -->
* 对处理有异议时，请在讨论版提出申请，由管理员复核

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

[[Category:项目]]