那些秋叶纪念网站编辑指南
项目结构
那些秋叶 One-Among.Us 是开源网站。文章和源代码均储存于 GitHub,由三个仓库组成:data
主要存放文章和评论,web
主要存放前端代码,backend
存放后端代码。如果想要做内容的更新,只需要关注 data
仓库的结构就好。
评论是机器人自动同步上去的,只需要在网站上填写。
编写的原则
我们的目的是做一个小的纪念馆,而不是 wiki。因此,我们更鼓励用写作来抚慰不在世和在世的各位跨儿朋友以及我们的盟友们(allies)。无论逝者是什么性别身份,我们希望给读者看到的是,「原来,ta 们曾经是和我一样的,鲜活的生命。」因此,过于夸张或者过于冷静的描写都是需要避免的。
写作的风格比起 wiki 来说是相对自由的,但仍然需要遵守一些基本的原则,例如:
- 所写内容要尽量做到真实;
- 如果有大段的引用,需要标明出处;
- 可以使用一些社群内,或者说「圈内」的术语,但是如果愿意的话,请尽量在第一次出现的时候加上注释。
编写逝者条目应该使用第三人称。请注意使用适当的代词,尊重逝者本人的意愿。对非二元性别者、无性别者、性别不明确者等,如无本人说明,请用「ta」作为代词(目前我们没有找到更好的中文词语来替代),或者在行文中不使用代词。
在各种语文的条目中都应当使用通行规范标点。仅有一处特殊情况:如无特殊说明,无论是哪种中文版本,引号都请使用直角引号「」(外层)和『』(内层)代替 “” 和 ‘’,除非所引用内容并非中文。英文引号需要使用 “” 和 ‘’,而不是没有弯曲度的 " 或者 '。
如果要引用外部来源,请使用网络档案馆链接服务,比如 Internet Archive 和 archive.today 等 (参见 data/#141 的讨论)。
为了保护我们的读者,如果逝者是自杀离去的,请尽量淡化具体的方式。如果是采取药物的方式,不可以写出具体的药品名称或剂量。如果涉及和自杀相关的报道,还请参照世界卫生组织的 媒体工作者预防自杀指南(可以从链接下载中文版)。
逝者条目命名规范
网页路由与data仓库内的目录名
data
仓库内 people
目录下的目录名直接被用于网页路由的生成,例如:
https://www.one-among.us/profile/noname 页面对应 github:one-among-us/data/people/noname
目录
贡献者在创建新条目时,建议参考如下原则对目录进行命名:
- 请贡献者在不引起混淆的情况下尽可能使用确认为逝者个人持有的,最具有公共性的线上身份标识作为目录名称或命名参考。一般而言,我们认为这一标识应当按照如下顺序选取:
- 逝者最广为人知的身份标识,尽可能只包含字母/数字/下划线,尽可能不包含 slash
/
空格␣
及其他需要转义的字符 - twitter/X username
- telegram username
- fediverse username
- 其他类似性质论坛/IM/社交网络中用于标识用户的唯一ID,包括但不限于 discord/IRC/个人网站/wechat
- 逝者最广为人知的身份标识,尽可能只包含字母/数字/下划线,尽可能不包含 slash
- 请尽可能以 twitter/X username 字符限制作为目录命名参照:
- 目录名长度在4~15个字符之间
- 仅使用字母,数字与下划线
_
- 考虑到现实世界的不确定性,无法通过简单的命名规则完全规避重名的可能。贡献者需一定程度上自行保障目录名称和逝者之间的对应并避免歧义。出现冲突时,请优先考虑避让先前已录入的条目并发邮件到
info [at] one-among [dot] us
加以确认。
收录的标准
我们纪念两类逝者:
- 跨性别者、跨性别者、非二元性别人士、非常规性别者(transgender, transsexual, non-binary, and gender non-conforming people, 总称 TGD)。只要确认其 TGD 身份,就可以收录。不应该因为 TGD 人士的品行问题而选择拒绝收录和纪念,但可以以后人的视角在介绍中作公正的评判;
- 对 TGD 社群有感情的友跨人士(allies)。这里的标准比较宽松。
我们维护了一份只有 One Among Us 在任志愿者能看到的「不愿被收录人士的名单」,一旦发现 Pull Requests 或者 Issues 中有名单内提到的人,我们会手动关闭。这份名单我们认为不应该公开查阅,但是如果有确认名单或者希望自己不被收录的需求,请发邮件到 info [at] one-among [dot] us
联系我们。
用 GitHub 来修改和提交
如果想要继续,你首先需要以下知识:
git
的基本使用:克隆仓库、commit、rebase 到主分支、在上游和本地间同步;- GitHub 的基本使用:复刻源码、创建 PR、与其他 GitHub 用户合作;
- YAML 基本语法:缩进规则、横线、空格与引号的使用、处理特殊字符;
- Markdown 基本语法。
或者你也可以直接把想要修改或增加的部分发邮件到 info [at] one-among [dot] us
。我们的工作人员会把它们转成恰当格式上传。我们并不需要贡献者有任何技术知识,你完全可以以你喜欢的方式工作。任何形式的贡献都同样会被认可。
Under construction