Предварительная обработка содержимого файла Docbook

В настоящее время я использую цепочку инструментов документации, которая имеет следующие шаги:

  1. Написать документацию в текстильном формате
  2. Преобразование текстильной документации в Docbook ( Mylyn WikiText)
  3. Конвертировать Docbook в PDF (плагин maven docbkx)

Я в основном удовлетворен процессом, и я хотел бы настроить отображение таблиц и изображений в PDF. А именно, я хотел бы применить следующие преобразования:

  1. informaltable -> informaltable rules="all"
  2. imagedata -> imagedata scalefit="1" width="100%" contentdepth="100%"

Я уже настроил пользовательскую таблицу стилей, но я не уверен, могут ли эти преобразования выполняться или как.

Как я могу применить эти преобразования, учитывая существующий файл docbook?

Источник

1 ответ

Это, вероятно, слишком поздно, чтобы быть полезным для вас, но я все равно решил ответить. Если у вас есть таблица стилей XSL, которая переопределяет определенное поведение обычных таблиц стилей (то, что Боб Стейтон называет "слоем настройки"), вы можете просто добавить в файл pom строку, которая говорит плагину docbkx об его использовании. Для преобразования XHTML это элемент htmlCustomization. Например,

SRC / главная /docbkx/ заказ статья-html.xsl

Для вывода PDF это будет элемент foCustomization:

SRC / главная /docbkx/ заказ статья-print.xsl

Хитрость заключается в том, что в этом файле настройки вы должны изменить оператор импорта, чтобы использовать символический путь, который ожидает плагин:

Это задокументировано по адресу http://docbkx-tools.sourceforge.net/advanced.html

Моя проблема заключалась в том, что я также использовал свои собственные пользовательские страницы заголовков, которые также импортировались в мой слой настройки, и я не мог понять, как сообщить плагину, где его найти. Я мог бы жить с макетом титульной страницы по умолчанию в моем выводе HTML, но не для печати. Я наконец сдался и сейчас пытаюсь подключиться к XML-плагину Maven и напрямую применить XSLT-преобразование. Еще раз, я застрял, хотя. Как только я получаю файлы fo для промежуточного шага в PDF, я не могу найти плагин Maven, который может применять к ним FOP. На самом деле я нашел плагин для Maven Central, но я не могу найти документацию о том, как на самом деле его использовать. Просто это: http://mavenhub.com/mvn/central/org.apache.xmlgraphics/fop/1.0

Источник
Другие вопросы по тегам