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

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

1 голос
/ 28 ноября 2011

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

  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 Ответ

0 голосов
/ 15 августа 2013

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

src / main / docbkx / custom-article-html.xsl

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

src /main / docbkx / custom-article-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

...