🖥 Проекты

Podlite - лёгкий язык разметки для текстов, документации и баз знаний.
Axona – персональная система знаний

📄 Инфо · связь

Оглавление · Спецификации, RFC · Обо мне · Архив

rss · github · zag(at)cpan.org

✦ Недавнее

В проекты я стал добавлять глоссарии. Несколько раз у меня была ситуация, когда агент переходил на свои термины, и мне буквально приходилось выяснять у него, что он имеет в виду под каждым. Хоть в памяти агента и стоят правила не использовать жаргон и быть кратким, порой он все равно «съезжал» в какую-то свою терминологию.

С глоссариями подобных случаев у меня, вроде бы, пока не было: диалоги ведутся в рамках терминологии. Нашлось и еще несколько интересных плюсов. Термины глоссария используются при написании документации и статей о проекте, при контроле спецификаций и при формулировке задач.

Мои проекты и базы знаний в Podlite, поэтому как оформить глоссарий в других базах знаний, например на основе Markdown, сказать не могу: в Markdown просто нет таких средств. В Podlite запись о термине выглядит так.

=for defn :id<capture-overlay>
D<Окно быстрой заметки>
X<|разделы, Вышедшее приложение; capture overlay; quick-note panel>Окно поверх любого
приложения, в которое записывают мысль, не выбирая места. Открывается глобальной клавишей
C<⌃⌥N> или пунктом меню строки состояния; в нем одно поле, текст из него становится
быстрой заметкой. …

Здесь работают три средства языка. Блок =defn задает термин, и на него можно сослаться по :id. Код D<> отмечает сам термин (Definition), а код X<> — запись указателя: в нем я перечисляю синонимы, а также имя термина на другом языке. На основе X<> можно будет собирать предметный указатель.

Так глоссарий выглядит в Axona Desktop.