В апреле 2024 года Argumentum был карточной игрой, готовой к печати. Сегодня это ещё и публичный репозиторий, в котором каждая карта заново собирается из текстовых файлов — на восьми языках, со своими интеллект-картами и онтологией.
Иллюстрация: docs/publication/articles/illustrations/1a-du-texte-a-la-carte.png, репозиторий Argumentum, коммит 981e5233 — монтаж реального фрагмента таксономии (девятнадцать строк, включая заголовок) и реального рендера карты «Небрежный аргумент», строка 2,1.1 видна во фрагменте — путь, о котором рассказывает раздел «Как рождается карта».
Игра
Argumentum — карточная игра о софизмах, то есть о рассуждениях, которые кажутся верными, хотя на самом деле таковыми не являются. Карта описывает софизм, даёт его определение и пример. Мы учимся его распознавать, а затем противопоставлять ему убедительный аргумент.
В игре используются три колоды. Первая объединяет большие карты: софизмы, правила и карту-памятку. Вторая объединяет маленькие карты: сценарии, в которых нужно определить, какой софизм скрывается в заданной ситуации. Третья, отдельная, описывает добродетели аргументации: аргументы, которые выдерживают проверку.
Точка отсчёта, затем перестройка
Репозиторий существует с 20 марта 2020 года.
Одна версия долгое время оставалась эталонной: коммит 0087f0ec от 25 апреля 2024 года. Именно она производила полную игру. В период с 2025 по 2026 год производственная цепочка была приведена в порядок деталь за деталью и, главное, оснащена инструментами: у каждого этапа теперь есть своя проверка, и изменение, которое сломало бы карту, больше не пройдёт незамеченным.
Как рождается карта
Четыре этапа, все — на основе текстовых файлов.
Данные. Один CSV-файл на каждое семейство: таксономия софизмов, таксономия добродетелей, сценарии, правила. Одна строка на элемент и один столбец на язык. Это единственное место, где существует текст карты.
Шаблон. JSON-файл, содержащий HTML и CSS карты с пропусками, которые нужно заполнить. Движок рендеринга CardPen заполняет эти пропуски данными из CSV. Пропуски записываются в двойных фигурных скобках: это синтаксис шаблонов Handlebars — системы, которая заменяет метки значениями.
Изображение. Управляемый браузер открывает заполненный шаблон и сохраняет карту как изображение PNG в разрешении для печати.
Документ. Библиотека QuestPDF собирает страницы: лицевую и оборотную стороны, метки для обрезки и, для версии, которую можно распечатать дома, несколько карт на листе A4.
Что добавилось
Восемь языков. Французский, английский, русский, португальский, испанский, арабский, персидский и китайский. Два из них, арабский и персидский, пишутся справа налево, со шрифтом, предназначенным для их алфавита.
Ментальные карты. Вся таксономия, изображённая в виде дерева, по одной на каждый язык, экспортированная в SVG — формат векторного изображения, которое остаётся чётким при любом размере. HTML-страницы репозитория их отображают.
Онтология. Два файла OWL: один для софизмов, другой для добродетелей. Онтология — это формальное описание понятий и их связей, написанное для чтения машиной: она позволяет программе знать, что софизм принадлежит к семейству, что у него есть разновидности и как он связан с другими. Таксономия также описана там в SKOS — стандартном словаре для публикации тезауруса.
Print & Play. Помимо файлов, предназначенных для типографии, репозиторий создаёт страницы A4, которые можно распечатать дома, вырезать и играть.
Что содержит коробка
| Элемент |
Карты |
| Софизмы |
175 |
| Правила |
15 |
| Памятка |
1, напечатана в 7 экземплярах |
| Сценарии |
167 |
| Аргументативные добродетели (отдельная колода) |
131 |
Два замечания к этой таблице. Карту имеют 175 софизмов, но таксономия описывает 1 408 узлов: она спускается от больших семейств до частных случаев, и не все они заслуживают карты. Добродетели подчиняются тому же правилу.
Колода таро, таким образом, включает 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 (6 ноября 2026 года). Подсчёты выполнены по 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.