03.11.2026 - Argumentum: от карточной игры к воспроизводимому репозиториюНовости | Argumentum
Перейти к основному содержимому

Argumentum: от карточной игры к воспроизводимому репозиторию

03.11.2026 Эволюция
Argumentum: от карточной игры к воспроизводимому репозиторию

В апреле 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.

‹ Назад к списку

Свяжитесь с нами

Подписка на рассылку

Не удалось подтвердить вашу подписку.
Ваша подписка подтверждена.

Рассылка

Подпишитесь на нашу рассылку, чтобы следить за новостями Argumentum.

Мы используем Sendinblue в качестве маркетинговой платформы. Отправляя эту форму, вы подтверждаете, что предоставленная вами информация будет передана Sendinblue как обработчику данных в соответствии с его условиями использования.