Как настроить Docbook с помощью таблицы стилей? Где я могу найти хорошие ресурсы?

Question

Я должен сделать некоторую форму документации проектов, которые я сделал, вместе со скриншотами и т. Д., И я хотел бы сделать это менее понятным, поэтому я попытался добавить CSS в свой файл, но это не сработало. После некоторого просмотра я обнаружил, что для этого понадобится XSL или XSLT, который я никогда не использовал, и не смог найти хорошего учебника / документации / примеров.

Answer 1

Вы должны различать разные части DocBook - авторинг и обработка (результат вывода).

авторинг

Разработка DocBook довольно проста - для достижения наилучшего результата используйте специальные XML-редакторы с графическим интерфейсом, такие как XMLMind XML Editor или OxygenXML Author, а не текстовые редакторы (я никак не связан с XMLMind или Oxygen). Конечно, вы можете спросить, почему я упомянул инструменты разработки вместо самой настройки и как эти инструменты связаны с настройкой? Ответ таков: любой XML-редактор сам по себе может быть полностью настроен так, как вам нужно для продуктивной работы. Там в основном ничего не связано со стилями DocBook XSL, но любой редактор может быть настроен так, чтобы получить наиболее подходящий результат для авторинга. И многие части этой настройки связаны с XSLT/XPath.

обработка

Эта часть полностью зависит от ваших знаний в области XSLT и, в то же время, какой результат вы хотите получить (ожидаете). Таблицы стилей DocBook были разработаны для получения результата (выходных файлов) независимо от ваших знаний XSLT, НО сложность результата будет полностью зависеть от уровня ваших знаний. Вот простой список, чтобы узнать, куда вам нужно идти:

1. Если вы ничего не знаете о XSLT - вы получите стандартный результат.

2. Если вы готовы покопаться в параметрах DocBook и настроить их - вы получите результат, более соответствующий вашим потребностям. Т.е. вы можете настроить шрифт своей страницы для PDF (body.font.master), выберите, какие заголовки документов включить в оглавление (generate.toc) и т. д. Вам нужно только один файл для настройки: <docbook-xsl-distro-dir>/<output_type>/param.xsl, где docbook-xsl-distro-dir - это ваш каталог с таблицами стилей DocBook XSL, <output_type> - тип результата, который нужно получить (fo > печать, html > HTML). Чтобы выяснить, для чего подходит каждый параметр, вы можете использовать либо справку DocBook XSL, либо / и (рекомендуется!) Книгу DocBook XSL: Полное руководство Боба Стейтона (доступна онлайн).

3. Если вы готовы углубиться в настройки - вам нужно получить действительно сложный результат для вашего вывода. В этом случае вам нужно:

   • познакомиться с XSLT (таблицы стилей DocBook XSL написаны на XSLT 1.0). Я бы порекомендовал XSLT Quickly (из публикации Мэннинга);
   • прочитать DocBook XSL: Полное руководство;
   • узнать HTML или XSL:FO (зависит от вывода).