2024年4月,Argumentum 还是一套随时可打印的卡牌游戏。如今,它同时也是一个公开仓库:每张卡牌都由文本文件重建而成,支持八种语言,还附带思维导图和本体。
插图:docs/publication/articles/illustrations/1a-du-texte-a-la-carte.png,Argumentum 仓库,提交 981e5233 —— 由分类体系的一段真实摘录(十九行,含表头)与“草率的论证”卡牌的真实渲染图拼合而成,摘录中可见第 2,1.1 行 —— 即“一张卡牌如何诞生”一节所讲述的历程。
游戏
Argumentum 是一款关于谬误的卡牌游戏,谬误指的是那些看似有效、实则无效的推理。每张卡牌描述一种谬误,给出它的定义和一个例子。我们学习识别它,然后用站得住脚的论证来反驳它。
游戏使用三副牌。第一副汇集大卡牌:谬误、规则和一张备忘卡。第二副汇集小卡牌:情景卡,要求玩家识别特定情境中隐藏着哪种谬误。第三副单独成组,描述论证的美德:那些站得住脚的论证。
一个参照点,然后是重建
该仓库自 2020 年 3 月 20 日起存在。
有一个版本长期作为参照:2024 年 4 月 25 日的提交 0087f0ec。完整的游戏就是由它生成的。2025 年至 2026 年间,制作流程被逐件修复,更重要的是配备了工具:每个步骤现在都有自己的检查,会破坏卡牌的修改不再悄然通过。
一张卡牌如何诞生
四个步骤,全都从文本文件出发。
数据。每个类别一个 CSV 文件:谬误分类体系、美德分类体系、情景、规则。每个条目一行,每种语言一列。这是卡牌文字唯一存在的地方。
模板。一个 JSON 文件,包含一张卡牌的 HTML 和 CSS,其中留有待填的空位。渲染引擎 CardPen 用 CSV 的数据填充这些空位。空位写在双花括号之间:这是 Handlebars 模板的语法,一种用数值替换标签的系统。
图像。一个受程序控制的浏览器打开填充好的模板,并以印刷分辨率将卡牌截取为 PNG 图像。
文档。一个库 QuestPDF 负责组装页面:正面和背面、裁切标记,以及用于在家打印的版本,每张 A4 纸上排多张卡牌。
新增的内容
八种语言。法语、英语、俄语、葡萄牙语、西班牙语、阿拉伯语、波斯语和中文。其中两种,阿拉伯语和波斯语,从右向左书写,并使用专为其字母设计的字体。
思维导图。整个分类体系绘制成树状,每种语言一份,导出为 SVG —— 一种矢量图像格式,在任何尺寸下都保持清晰。仓库中的 HTML 页面会显示它们。
本体。两个 OWL 文件,一个用于谬误,一个用于美德。本体是对概念及其关系的形式化描述,专为机器阅读而编写:它让软件能够知道某种谬误属于哪个类别、有哪些变体,以及它与其他谬误如何关联。分类体系在其中也用 SKOS 进行了描述,SKOS 是用于发布叙词表的标准词汇。
Print & Play。除了供印刷厂使用的文件之外,仓库还生成可在家打印、裁剪并游玩的 A4 页面。
盒子里有什么
| 项目 |
卡牌 |
| 谬误 |
175 |
| 规则 |
15 |
| 备忘卡 |
1,印制 7 份 |
| 情景 |
167 |
| 论证美德(单独成组) |
131 |
阅读此表有两点说明。有 175 种谬误配有卡牌,但分类体系描述了 1408 个节点:它从大类一直下探到具体个案,并非所有个案都值得配一张卡牌。美德遵循同样的规则。
因此,塔罗牌组共有 197 张待制作的卡牌。加上 167 张情景卡,盒中共有 364 张。若再加上美德,则共有 495 张。
这些数字是在仓库的 CSV 文件上统计的,所依据的规则与自动检查相同,该检查会在每次修改时重新核对这一计数。
我们如何确保不出差错
这些检查并不照抄数字:它们重新计算,然后与已生成的内容对照。
一副牌的卡牌数量由配置和 CSV 推算得出。因此,数据文件中丢失一行会使验证失败,而不会悄悄地生成一个不完整的游戏。
页面尺寸直接在 PDF 本身上测量,容差为一毫米:即使页数正确,排版格式错误的文档也会被标出。
思维导图的链接会被逐一检查,其展示页面不得比其中所含的图更旧——否则页面显示的就是过时的树。
最后一项检查会打开牌组并读取其前几页,以确认规则按顺序出现在其中。它无法读取文字:这些页面是图像。因此,它将前几页的像素与规则卡牌的像素进行比较。
这些检查中只读取仓库的那些,会在每次提出修改时运行:卡牌计数、思维导图链接,以及 PDF 检查的验证样例,后者在专为检验而构造的案例上测试其逻辑。而打开已生成 PDF 的检查,则运行在刚刚重新生成游戏的机器上:一次完整的制作需要数小时,不会在每次修改时重复进行。
一切皆开放
代码以 LGPL-3.0 许可证发布:可以阅读、修改和再利用,条件是对代码本身的修改仍须遵循同一许可证。
编辑语料库——卡牌的文字——采用 Creative Commons BY-SA 4.0 许可证,允许再利用和改编,条件是署名并以相同方式共享。该许可证并不涵盖整个仓库:它仅适用于文件 LICENSE-CONTENT.md 中列出的七个文件,且仅限于这些文件——五个卡牌文本文件及由它们派生的两个本体。对于任何其他文件,适用的是代码许可证。
重建游戏只需一条命令,从仓库根目录执行:
dotnet run --project Generation/Converters/Argumentum.AssetConverter/Argumentum.AssetConverter.csproj
PDF 会写入项目的输出文件夹,每种语言一个子文件夹。为此需要 .NET 环境,以及由本地网站提供服务的卡牌渲染引擎;思维导图还需要 FreeMind,即绘制它们的软件。
接下来
仓库仍在不断推进:分类体系在不断完善,译文在不断校读,检查也随着新缺陷的发现而扩展。这样,游戏中的每张卡牌都能根据其文字重新生成,并且可以验证。
来源:Argumentum 仓库,提交 33f25e82(2026 年 11 月 6 日)。计数依据 Cards/Fallacies/Argumentum Fallacies - Taxonomy.csv、美德分类体系、Cards/Scenarii/Argumentum Scenarii - Cards.csv 和 Cards/Rules/Argumentum Rules - Cards.csv 得出。许可证:LICENSE 和 LICENSE-CONTENT.md。思维导图:文件夹 Cards/Fallacies/Mindmaps。本体:docs/ontology/argumentum.owl。