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

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

  1. Пишите документацию в формате Textile
  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?


docbook mylyn-wikitext
person Robert Munteanu    schedule 28.11.2011    source источник

Ответы (1)


arrow_upward
0
arrow_downward

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

src/main/docbkx/пользовательская-статья-html.xsl

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

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

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

This is documented at http://docbkx-tools.sourceforge.net/advanced.html

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

person AlChuck    schedule 14.08.2013