Компиляция книги помощи

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

  1. Запуск компилятора.
    Выполняется с помощью функции compile-book.
  2. Сохранение якорей.
    По мере завершения книги помощи, все встречающиеся в ней якоря, должны быть помещены в отдельный файл для эффективной работы функции помощи во времени исполнения программы.

Компилятор собирает книгу в целевой папке следующим образом:

  1. создаёт соответствующую структуру подпапок,
  2. копирует без изменения вспомогательные папки и файлы, например, графические,
  3. транслирует исходные статьи с возможным разбиением на страницы сегментов,
  4. генерирует навигационные страницы предметного указателя и подробного оглавления.