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

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

0 голосов
/ 26 сентября 2018

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

1 Ответ

0 голосов
/ 27 сентября 2018

Вы должны различать разные части 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> print, html> html).Чтобы выяснить, для чего подходит каждый параметр, вы можете использовать DocBook XSL Reference или / и (рекомендуется!) Книгу DocBook XSL: Полное руководство Боба Стэйтона (доступно *)1036 * онлайн ).

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

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