Компилятор

Компилятор YstokHelp служит для разработки сложной книги помощи. Он поставляется в двух видах:

Приложение YstokHelp — программа с графическим пользовательским интерфейсом для Windows:
исполняемый файл yh.exe или дистрибутив (мастер установки) yhelp-m-n-bbb.exe.
Исходные тексты на языке Коммон Лисп, для работы с которыми требуется соответствующая система или среда программирования, например, LispWorks®, возможно, на другой платформе (*nix, MacOS и прочая).

При подготовке исходных статей нужно решить ряд задач:

вставка якорей и использование схемы help для гибких ссылок на якоря,
указание атрибута help для элементов HTML-разметки,
разбивка статей на сегменты,
определение книги помощи.

Определение книги помощи создаётся в специальном "файле проекта" и выглядит аналогично определению программной системы посредством ASDlite. Макрос define-book аналогичен asd:defsystem и базируется на подклассах стандартных компонентов ASDlite.

Исходные файлы статей могут включать разметку YHTML-Template. Шаблоны обеспечивают дополнительное наполнение страниц, облегчают их оформление и позволяют генерировать из одного источника разные варианты одной страницы, например, помещаемой в разные книги.

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