Как генерировать PDF из Docbook 5.0

StackOverflow https://stackoverflow.com/questions/2615002

Вопрос 

<?xml version="1.0" encoding="UTF-8"?>
<book version="5.0" xmlns="http://docbook.org/ns/docbook"
      xmlns:xlink="http://www.w3.org/1999/xlink"
      xmlns:xi="http://www.w3.org/2001/XInclude"
      xmlns:svg="http://www.w3.org/2000/svg"
      xmlns:m="http://www.w3.org/1998/Math/MathML"
      xmlns:html="http://www.w3.org/1999/xhtml"
      xmlns:db="http://docbook.org/ns/docbook">

и Docbook2PDF на Ubuntu 9.10 печатает много сообщений об ошибках и не делает ни одного документа PDF. Ошибки:

openjade:test.xml:2:0:E: prolog can't be omitted unless CONCUR NO and LINK EXPLICIT NO and either IMPLYDEF ELEMENT YES or IMPLYDEF DOCTYPE YES
openjade:test.xml:2:0:E: no document type declaration; will parse without validation
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/print/dbtitle.dsl:18:5:E: flow objects at the root must be all of class scroll or all of class page-sequence or simple-page-sequence
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/print/dbbibl.dsl:704:4:E: flow objects at the root must be all of class scroll or all of class page-sequence or simple-page-sequence

DOCBook2PDF для документа в формате Docbook 4.5 с нормальным заголовком, как: 

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">

работает совсем хорошо.

Есть ли способ генерировать PDF из Docbook 5.0?

Это было полезно?

Решение

Я вижу три варианта (доступны в Debian / Ubuntu) для генерации PDF из Docbook:

  • JADE, который предоставляет команду docbook2pdf, которую использовал Ascher. Джейд древний и работает с SGML, который предвидит XML и не поддерживает Unicode; Это также не хватает поддержки DocBook 5.

  • то Docbook-XSL таблицы стилей которые проходят через xsl-fo. Docbook-XSL для Docbook 4.5, Docbook-XSL-NS для Docbook5. Используйте FOP, чтобы перейти от XSL-FO в PDF. Трубопровод: DOCBook5 - (XSL) -> XML.FO - (FOP) -> PDF. Команды участвуют: XSLTProc, FOP.

  • DBLATEX, который в первую очередь ориентирован на Docbook4.5, но был обновлен для некоторых из Docbook5.

XMLTO может управлять двумя последними двумя, хотя в настоящее время он в настоящее время по умолчанию подключается к Docbook-XSL и не Docbook-XSL-NS.

Краткое руководство пользователя Docbook5

Предварительные условия

sudo aptitude install docbook5 docbook-xsl-ns xsltproc fop xmlto libxml2-utils xmlstarlet

Проверка

xmlstarlet val --err --xsd /usr/share/xml/docbook/schema/xsd/5.0/docbook.xsd book.xml

PDF вывод

xsltproc /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/fo/docbook.xsl book.xml > book.fo
fop -fo book.fo -pdf book.pdf

Другие советы

Помимо заголовка, который вы дали, вы пробовали меньший пример, как этот из Docbook 5.0: окончательное руководство ?

<?xml version="1.0" encoding="UTF-8"?>

<book xmlns='http://docbook.org/ns/docbook'>
  <title>An Example Book</title>
  <titleabbrev>Example</titleabbrev>
  <info>
    <legalnotice><para>No notice is required.</para></legalnotice>
    <author><personname>
      <firstname>Norman</firstname><surname>Walsh</surname>
    </personname></author>
  </info>

  <dedication>
  <para>
      This book is dedicated to you.
  </para>
  </dedication>

  <preface>
    <title>Foreword</title>
    <para>
        Some content is always required.
    </para>
  </preface>

  <chapter>
    <title>A Chapter</title>
    <para>
        Content is required in chapters too.
    </para>
  </chapter>

  <appendix>
    <title>Optional Appendix</title>
    <para>
        Appendixes are optional.
    </para>
  </appendix>
</book>

Просто сделали его в PDF через одну из моих средних сред. Можете ли вы дать небольшой пример (или несколько разделенных onces), содержащие некоторое содержание, которое делает использование всех необходимых дополнительных пространств имени.

Если вышеприведенный пример не работает, и вы заинтересованы в том, как я настроил мою среду чтения Создание содержимого документа доступно на сайте проекта Maven. Отказ Просто замените пример с приведенным выше приведенным выше DocBood 5.0. Только docbkx-maven-plugin представляет интерес, по отношению к этому вопросу. (PS: Для этого требуется некоторые базовые знания Java и Maven2.)

Публика

Вы можете использовать Публика Чтобы опубликовать вашу документ XML в форматах PDF, HTML и HTML. Puredan используется Red Hat в рамках своей внутренней документации набора инструментов и является приложением открытого исходного кода, размещенного проектом Fedora. Инструмент использует «бренды» для достижения модульности при нанесении стилей к публикации контента. Эта предустановленная манера, просматривая широкий спектр CMS или инструменты документации.

Руководство документации JBoss

Хороший пример инструмента в действии является JBoss Press Gang Документация, который сам по себе является отличным ресурсом The Document Document Community Community на использование Docbook XML в документации JBoss. Версии HTML и PDF были сгенерированы с помощью Purectan.

Существуют значительные различия между Docbook 4.5 и 5.0. И эти различия могут предотвратить преобразование вашего документа.

Если вы хотите проверить достоверность вашего документа 5.0, вы можете использовать следующий инструмент командной строки:

  1. Это инструмент Java, поэтому вам нужно иметь недавнюю среду Runtime Java.

  2. Инструмент jing. Вы можете скачать его с веб-сайта ThaiOpensource:http://www.thaiopensource.com/relaxng/jing.html.

  3. Вам также понадобится файл Relax NG для Docbook 5.0. Он снабжен дистрибутивом Docbook 5.

  4. Запустите проверку проверки со следующей командной строкой:
    Java -jar path_to_jing / jing.jar -t -i path_to_docbook5 / docbook.rng document.xml

Если есть некоторые сбои, они должны быть возвращены таким образом: ошибка в URL "Файл: ..... / document.xml", строка № 211, столбец № 59: плохое значение для атрибута «ID» из пространства имен »http://www.w3.org/xml/1998/ruespace.«Прошедшее время 968 + 166 = 1134 миллисекунд

http://docbookpublishing.com. Поддерживает документы Docbook 5.0. Это онлайн-сервис для Docbook для форматирования PDF. Вы также можете представить документы Docbook через API для отдыха.

Перейти к затмению и установить Редактирование и обработка документов для плагина Eclipse (DEP4E). Отказ Вы можете найти его, собираясь на рынок и найдите там docbook. Этот плагин создаст пример Docbook и может опубликовать в HTML, PDF и даже на электронную книгу.

Или проверить DEP4E веб-сайт, Прочитайте Краткое руководство стартера раздел 3. Начало работы, чтобы получить представление о том, что это возможности.

Сообщение WordPress пост в стиле документации:http://hashfold.com/techfold/wordpress-how-to-generate-docbook-style-posts/

Лицензировано под: CC-BY-SA с атрибуция
Не связан с StackOverflow
scroll top