در آوریل ۲۰۲۴، Argumentum یک بازی کارتی آمادهٔ چاپ بود. امروز آن همچنین مخزنی عمومی است که هر کارتش از پروندههای متنی بازسازی میشود، به هشت زبان، با نقشههای ذهنی و هستیشناسی خودش.
تصویر: docs/publication/articles/illustrations/1a-du-texte-a-la-carte.png، مخزن Argumentum، کامیت 981e5233 — تلفیقی از یک بخش واقعی از طبقهبندی (نوزده سطر، با احتساب سرایند) و از رندر واقعی کارت «استدلال سرسری»، با ردیف 2,1.1 که در این بخش دیده میشود — مسیری که بخش «کارت چگونه متولد میشود» روایت میکند.
بازی
Argumentum یک بازی کارتی دربارهی مغالطههاست، یعنی همان استدلالهایی که معتبر به نظر میرسند بیآنکه معتبر باشند. هر کارت یک مغالطه را توصیف میکند و تعریف و یک مثال برای آن میآورد. یاد میگیریم آن را بشناسیم و سپس استدلالی را که استوار میماند در برابرش بگذاریم.
بازی با سه دسته کارت انجام میشود. دستهی نخست کارتهای بزرگ را گرد هم میآورد: مغالطهها، قواعد و یک کارت یادآور. دستهی دوم کارتهای کوچک را گرد هم میآورد: سناریوها، که در آنها باید تشخیص داد کدام مغالطه در یک موقعیت معین پنهان شده است. دستهی سوم، جدا از آنها، فضیلتهای استدلالورزی را توصیف میکند: استدلالهایی که استوار میمانند.
یک نقطهی مرجع، سپس بازسازی
این مخزن از ۲۰ مارس ۲۰۲۰ وجود دارد.
یک نسخه مدتها مرجع باقی ماند: کامیت 0087f0ec، مورخ ۲۵ آوریل ۲۰۲۴. همین نسخه بود که بازی کامل را تولید میکرد. میان ۲۰۲۵ و ۲۰۲۶، زنجیرهی تولید قطعه به قطعه بازسازی شد و مهمتر از آن، به ابزار مجهز شد: اکنون هر مرحله کنترل خودش را دارد و تغییری که کارتی را خراب کند دیگر بیصدا از نظر نمیگذرد.
کارت چگونه متولد میشود
چهار مرحله، همه بر پایهی پروندههای متنی.
دادهها. یک پروندهی CSV برای هر خانواده: طبقهبندی مغالطهها، طبقهبندی فضیلتها، سناریوها، قواعد. یک سطر برای هر عنصر و یک ستون برای هر زبان. این تنها جایی است که متن یک کارت وجود دارد.
قالب. یک پروندهی JSON که HTML و CSS یک کارت را با جاهای خالیِ قابل پر شدن در بر دارد. موتور رندر، CardPen، این جاهای خالی را با دادههای CSV پر میکند. جاهای خالی میان آکولادهای دوتایی نوشته میشوند: این نحو قالبهای Handlebars است، سامانهای که برچسبها را با مقدارها جایگزین میکند.
تصویر. یک مرورگر کنترلشده با برنامه، قالب پرشده را باز میکند و کارت را بهصورت تصویر PNG با وضوح چاپ ثبت میکند.
سند. یک کتابخانه، QuestPDF، صفحهها را سرهم میکند: روی کارت و پشت آن، نشانهای برش و، برای نسخهای که در خانه چاپ میشود، چند کارت در هر برگ A4.
آنچه افزوده شده است
هشت زبان. فرانسوی، انگلیسی، روسی، پرتغالی، اسپانیایی، عربی، فارسی و چینی. دو تا از آنها، عربی و فارسی، از راست به چپ نوشته میشوند و فونتی مخصوص الفبایشان دارند.
نقشههای ذهنی. کل طبقهبندی بهشکل درخت ترسیم شده، یکی برای هر زبان، و با قالب SVG خروجی گرفته شده است — قالبی برای تصویر برداری که در هر اندازهای واضح میماند. صفحههای HTML مخزن آنها را نمایش میدهند.
هستیشناسی. دو پروندهی OWL، یکی برای مغالطهها و دیگری برای فضیلتها. هستیشناسی توصیفی صوری از مفاهیم و روابط آنهاست که برای خواندن توسط ماشین نوشته شده است: به نرمافزار امکان میدهد بداند یک مغالطه به یک خانواده تعلق دارد، گونههایی دارد و با مغالطههای دیگر چگونه مرتبط است. طبقهبندی در آنجا به زبان SKOS نیز توصیف شده است، که واژگانی استاندارد برای انتشار یک اصطلاحنامه است.
Print & Play. افزون بر پروندههای مخصوص چاپخانه، مخزن صفحههای A4 تولید میکند تا در خانه چاپ شوند، بریده شوند و با آنها بازی شود.
آنچه جعبه در بر دارد
| عنصر |
کارتها |
| مغالطهها |
۱۷۵ |
| قواعد |
۱۵ |
| کارت یادآور |
۱، چاپشده در ۷ نسخه |
| سناریوها |
۱۶۷ |
| فضیلتهای استدلالی (دستهی جدا) |
۱۳۱ |
دو نکته برای خواندن این جدول. ۱۷۵ مغالطه کارت دارند، اما طبقهبندی ۱٬۴۰۸ گره را توصیف میکند: از خانوادههای بزرگ تا موارد خاص پایین میرود و همهی آنها شایستهی کارت نیستند. فضیلتها از همین قاعده پیروی میکنند.
بنابراین دستهی تاروت ۱۹۷ کارت برای ساخت دارد. با ۱۶۷ سناریو، جعبه ۳۶۴ کارت دارد. اگر فضیلتها را هم بیفزاییم، ۴۹۵ کارت میشود.
این عددها روی پروندههای 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 (۶ نوامبر ۲۰۲۶). شمارشها بر پایهی 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.