贡献规则
本规范适用于 Kloudy 内容的新建、编辑、补充、纠错、翻译与投稿。
- 具体模块的投稿须同时遵守本通用规范和对应模块的投稿规范;投稿前应阅读本词条下对应模块规范的完整内容。
内容与来源
- 新建前查重,编辑前阅读已有内容,避免重复或覆盖。
- 优先采用官网、官方文档、官方账号、原始论文或标准原文。来源应直接支持所写内容,搜索摘要不能代替原文。
- 易变信息注明适用日期或版本;证据不足时省略或说明不确定性,不凭印象补全。
- 用自己的话组织内容,简短引用并注明来源,不整段搬运。
ID
- 大多数资源 ID 只允许小写英文字母、数字和下划线
_。
- 部分资源允许用
/ 表示层级,按从宽泛到具体的顺序书写。
- 部分资源允许用点号
. 表示归属以消歧,主体在左,归属在右,从右向左理解;下划线连接同一名称内部的词,不表示归属。
- ID 应稳定、明确,创建前检查是否重复或容易产生歧义。
- 编辑既有资源时,不为统一格式随意更改 ID。
名称
- 有正式原名的资源,主名称使用原名;译名填写在多语言或辅助名称中,不覆盖原名。
- 展示名称时保留原文,不裁剪、改写,也不以译名、ID 或“未命名”等内容替代缺失的原名。
简介
- 只写有可靠来源、能帮助理解资源本身的实质内容。
- 不重复名称、资源类型、署名或已有字段,不解释字段填写方式;职责、属性和关联使用对应字段记录。
- 没有有效资料时,简介可以留空,不为填满字段编写空泛说明;编辑时不因此清空已有简介。
编辑状态机
修改正式内容后进入草稿,提交审核并成功发布后回到正式版本。新建内容从草稿开始。
驳回、版本冲突和发布执行失败都显示为“草稿(已保存)”,具体原因保留在审核说明中,可以直接修改字段后保存或重新提交。版本切换只改变查看内容,不触发状态流转;可用操作以页面权限为准。
适用内容与当前差异
这套状态机描述保存草稿、提交审核和发布的标准路径。下表按当前可用的编辑入口核对;“完整”表示同时提供版本查看、逐版本删除和投稿操作。
下列入口均使用相同的草稿、投稿与审核流程;版本菜单可查看现有版本,并逐个删除非正式版本。
编辑状态与操作
下方展示编辑器底部的状态与操作栏。灰色按钮表示当前不可用;实际操作还需满足必填信息、投稿身份与页面权限要求。
点击示例按钮可查看操作说明,不会保存或提交内容。状态旁的“切换版本”菜单列出实际存在的版本;同为未保存状态时,菜单中可能有已保存草稿,也可能没有。非正式版本项旁提供删除入口。
当前内容与正式版本一致,尚无草稿,保存和提交不可用。要修改正式内容,从资源的编辑入口开始。
本次修改还没有已保存草稿。可以保存草稿,也可以直接提交;离开前应先保存。
已有草稿再次修改:编辑中的内容尚未保存,版本菜单同时有“编辑中的草稿”和“已保存草稿”;保存后编辑中版本消失。
已保存内容可以提交审核;驳回、冲突或发布失败后仍显示此状态,直接修改字段即变为未保存草稿。具体原因见审核说明。
等待审核,不能直接编辑或保存。“撤回投稿”替代提交按钮,撤回后可继续修改并重新提交。
版本切换与草稿管理
只有产生未保存修改时才显示“编辑中的草稿”;保存成功后,该项消失并以“已保存草稿”为当前版本。再次修改后,编辑中的草稿重新出现。正式版本在存在时可切换查看。查看已保存草稿或正式版本时,保存、提交和发布不可用;返回编辑中的草稿后再操作。新建内容尚无正式版本时,不显示正式版本入口。
版本列表的非正式版本项旁提供删除按钮。删除“编辑中的草稿”会丢弃未保存修改,若有已保存草稿则回到上次保存的内容;删除“已保存草稿”只删除服务器草稿,保留当前未保存内容。正式版本不能删除。
驳回、版本冲突和发布失败统一显示“草稿(已保存)”,修改字段后变为未保存草稿;保存或提交时由编辑流程处理后端状态。发布失败也可以交由管理员在审核页面处理并重试。