关于本次构建
名称
本项目的正式名称是 Library of the Citadel。它与 Atom-KB 自有的 Library 是两个彼此独立的项目:两者在不同的存储中保存不同的内容,本构建既不镜像、也不同步、更不取代 Atom-KB 的那一个。即便将来配置了两者之间的链接,那也只是一个指针,而不是权威来源关系。
内容状态
本次部署在世界食谱中包含 28 条记录:17 条有来源记录,8 条原创实用笔记,3 条示例记录。 共包含二十八条记录,分为三类。十七条是有来源的记录:十三条新手烤箱食谱和四道小份新手甜品,每条都注明其用量、温度与时间出自哪个页面,以及所给温度阈值背后的食品安全权威机构;它们已对照来源核对,但未在此处的任何厨房中试做,也不可供发布。八条是“快手空气炸锅”栏目中的原创实用笔记,写于此处而非取自别处:它们不带任何来源,因为它们不对任何已发表的食谱作出主张;凡其中给出需要炸到的温度,都会把读者交还给他们所在地的食品安全权威机构。另外三条是用于演示的示例记录,用来把大厅、画廊、搜索、地区筛选与详情视图端到端地搭建并检查一遍。没有任何记录附带图片、正宗性主张或试做结果。要加入一条有来源的记录,需要 record_class 为 'sourced'、至少一个明确的来源 URL,以及一次权利审核;一条实用笔记则需要 record_class 为 'practical-note' 且完全不带来源。src/rules.mjs 中的内容规则会强制这两道关卡。
与之并立的是故事集,一个独立的原创虚构作品书架,架上有7 篇已发表作品。故事不是知识记录:它不作任何事实主张,因此既谈不上有来源、经过审核,也无从验证;它以作者本人的文字发表,而不是作为知识发表。 现收录七篇已发表的作品。架上的作品都是虚构写作:不作任何事实、历史或教义上的主张,也不引用任何来源,因为它并不概述任何东西;作品以署名作者本人的文字发表,权利保留。每篇作品都按作者写作时所用的语言呈现,英文页面会写明那是哪种语言。本架上的任何内容都不经机器翻译,也不对它作出任何承诺。
第三间展室是Agent Nursery,一个以建设同名机构为长期目标的项目;机构尚未成立或运营。本栏目现有1 册已发表手册。手册在此以作者本人的原稿保存,每种语言一份文件,每次构建都会校验,使已发表的正文无法与描述它的记录悄悄分离。 一份随经验修订的活文档。v0.1 记录此刻的理解,日后可能被补充、改变或撤回;若有改变,会说明改了什么、为什么改。
有来源的记录是什么
- 它会写明用量、烤箱温度与时间出自哪个页面,以及该页面的访问日期;凡记录中给出温度阈值,也会注明所依据的食品安全权威机构。
- 其做法由本项目以自己的措辞写成。不转载任何来源文字或照片,被引用页面的权利仍归其作者与出版方所有。
- 它已对照来源核对,但本项目并未实际烹制或试做,也没有经过任何专业食品安全审核。若来源只给出含糊的判断标准,记录会在旁边给出有出处的温度阈值。
原创实用笔记是什么
- 它是在本仓库这里写下的日常烹饪内容 —— 既不是概述自别人的页面,也不是用于演示的示例记录。凡其中给出需要做到的温度,都会把读者交还给他们所在地公布的食品安全权威机构,因为本记录并不自行指名任何机构。
- 它不带任何来源,而这是诚实的状态,不是缺口:它不对任何已发表的食谱作出主张,因此也没有什么需要引用。一旦某条笔记真的有了来源,它会被提升为有来源的记录,而不是事后补上注释。
- 它没有在此处的试验厨房里做过,没有经过任何专业食品安全审核,也不可供发布。其中的时间与温度是给你自己那台机器的起点,而不是核验过的结果。
示例记录不是什么
- 它没有经过研究,也不带任何来源 URL。来源列表是空的,而不是填上一个占位符。
- 它不对任何菜肴的历史、起源、正宗性或地域归属作出主张。
- 它没有被实际烹制或测试过,也没有报告任何结果。
- 它不包含图片,其图片权利审核状态也明确写明了这一点。
- 示例记录上的地区与菜系标签只是为了让筛选界面有东西可筛。它们的
label_basis字段记录了这些标签仅供演示。 - 它的译文只是同一段示例文字的另一种语言版本。翻译一条示例记录,并不会让它变得经过研究、有据可查、经过试做或通过审核。
语言
本构建为每一种界面语言各生成一整套页面。英文是有据可查的默认语言,直接从站点根路径提供;其他每种语言都有自己的路由前缀,因此深层链接本身就带着语言信息,页面也会在 lang 属性中声明该语言。
页眉中的切换控件会把所选语言保存在 localStorage 的 library-of-the-citadel.locale 键下。存储有可能不可用 —— 隐私浏览、沙箱文档、用户设置都可能导致这一点 —— 此时切换控件在本次访问中依然可用,只是不会被记住。除此之外不保存任何数据,也不涉及账号、Cookie 或服务器。
界面文本对每种受支持的语言都完整翻译。记录正文则逐条翻译:某条记录若没有所选语言的译文,会在一条可见提示之后按原始英文显示,而不是留下空白字段或泄漏原始键名。
部署配置
- 基路径
/library-of-the-citadel/- 界面语言
- English (English, /library-of-the-citadel/); 中文 (Chinese (Simplified), /library-of-the-citadel/zh/)
- Citadel 链接
- 未配置 —— 页眉中的位置渲染为不可点击状态
- 后端
- 无;部署出来的站点只有静态文件
- 外部请求
- 无;不获取字体、图片、分析脚本或任何第三方脚本
基路径与 Citadel 链接在 config/site.config.json 中设置,两者都可以在构建时用环境变量覆盖。源码中没有编入任何仓库名或主机名。