docbook

docbook wysiwyg editor for the web

Is there any ready-to-go docbook editor for web applications out there? I'm thinking of something like FCKeditor or TinyMCE that returns a docbook xml code back to the web application. I am aware that FCKeditor is customizable to do this, but I have not heard of anyone who did this. ...

Title pages of book in docbook 5.0

I am looking into structuring book (fiction) in docbook 5.0. I have got several introductory pages like about the book, about the author, about the publisher (with copyright, isbn info about the printer and the pagesetter), bastard title, title page. I am unsure, if it is better to structure all this in the info element or try to build ...

problem with image urls in htmlhelp created by docbook xsl

I have a Docbook XML document that has some images with special characters in their names (German umlauts). I'm using Saxon 6.5.5 and the Docbook xslt Stylesheets to create HTMLHelp files based on that document. Unfortunately the filenames are then url-encoded (% and hexadecimal code), which internet explorer can't deal with (with firefo...

DocBook macros?

Is there any way of defining macros (like tex macros o latex defines) in DocBook documents? DocBook is very verbose, and macros would help a lot. I didn't find them in quickstart tutorials. If so, could anyone provide a simple example or a link to? Thanks ...

How to generate pdf from docbook 5.0.

I've written a docbook 5.0 document with the header: <?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/Ma...

Docbook-xslt chapter id matching

Dear all, I would like to write a xslt rule if it matches a certain chapter ID that it sets autolabel to zero on the section. in pseudo code: IF CHAPTER == LOGBOOK SECTION.AUTOLABEL = 0 ELSE SECTION.AUTOLABEL = 1 ENDIF But after reading the docbook xsl website and docbook xsl reference i'm still unable to figure out how to d...

Copying paragraph content

In my DocBook document I have several sections, which follow this pattern: the section name the short description the long description I'd like to create an index of these sections. But I need it to be a table, which is formatted the following way: | link_with_section_name | short_description | | <link id="section1_id">the section n...

Easily (as in WYSIWYG) customize the docbook output

I've used DocBook in the past and I love the idea behind the separation of content from presentation. I am very comfortable editing XML directly. In my extensive search to find the best documenting solution for my needs I am always coming back to this one solution: DocBook -> Build system (ant, make, etc.) -> Output I have seen lots of...

Docbook+Ant: Could not find variable with the name of fop.extensions

After a lot of spent time trying to get my article to compile in Ant with Docbook, I can't seem to make FO compilation work. I'm using Xalan 2.7.0, and everything else (both single-page and chunked HTML) compiles perfectly. It's only when I try to compile to FO that I get this error: Fatal Error! org.apache.xml.utils.WrappedRuntimeExce...

Need advice - Developing a flexible documentation system, heavily focused on localization

I've been charged with building a documentation system/platform. Here's a short list of the major requirements: Easily localized : This will need to support a dozen or so languages out of the gate. (the ability for non-technical personnel to add/update translations would be a big plus, though not 100% required) Flexibility in output ...

Link to other document's title in DocBook

I'm putting together a few documents using DocBook. Almost all of them will refer to each other in some way, so I put together a bibliography section (using <bibliography). Is there some way, e.g. using <olink>, to automatically pull in the titles of the other documents? <biblioentry id="foo"> <abbrev>FOO</abbrev> <title>what do I...

Can ENTITY declarations be nested in referenced XML files?

I'm working on a rather large DocBook XML document. The main book has the chapters but includes all the subsections by reference using entities. Something like this: main.book.xml: <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [ <!ENTITY section1 SYSTEM "../fragmen...

Docbook: describing user interface required fields

I try to figure out how to describe in docbook "required fields" of UI. Does anybody know "best practice" for "required fields" in docbook? ...

Docbook Dblatex - how to omit header on first page of chapter?

Hi, I'm using dblatex to convert a book formatted using Docbook into a PDf, and everything is working great, however for the life of me I can't figure out how to suppress the inclusion of a header on the first page of each chapter? Of course I want that page to "count" in terms of the overall page count, however I don't want the book ti...

Combining phpdoc with existing docbook

I'd like to include some phpdoc-generated documentation into my already existing docbook documentation. My idea was to let phpdoc generate the documentation in the docbook-format and then import parts (based on packages and subpackages) of it using XInclude. I'm using Docbook 5 for my documentation. Is there any way to achieve this? ...

Emphasized text in docbook, fo, pdf out put.

I am trying to emphasize a character of some static text to render into the footer of my pdf, but can't figure out the right combination of tags in my xsl. How can I accomplish this? Example: <!-- Footer content --> <xsl:template name="footer.content"> <xsl:param name="pageclass" select="''"/> <xsl:param name="sequence" select="...

Need 'e-novative DocBook Environment (eDE)' Install Files

The 'e-novative DocBook Environment' is a brain dead simple DocBook toolchain built specifically for the Win32 platform by a company called e-novative GmbH. The company appears to have went out of business. Their website [http://www.e-novative.de] is dead and apparently the install files for their DocBook environment have somehow managed...

best way to implement custom pretty-printers

The documentation for the pprint module mentions that the method PrettyPrinter.format is intended to make it possible to customize formatting. I gather that it's possible to override this method in a subclass, but this doesn't seem to provide a way to have the base class methods apply line wrapping and indentation. Am I missing somethi...

Using a remote stylesheet that includes other stylesheets with relative paths

I'd like to do an XSL transform on a DocBook document using lxml.etree.XSLT. Although the documentation mentions that etree.XSLT() takes a first parameter of xslt_input, I can't seem to find any docs on what this parameter is meant to be. Passing it a file that is open for reading seems to work; passing it a filename in a string does n...

Doing an XSL transform of a branch of a Docbook element tree

I'd like to use the docbook XSL stylesheets to render various parts of a document, without transforming the entire thing. The complication is that some of these parts have <footnoteref> elements whose linkend attributes are not located within the same chunk. In other words, I want to process a branch of the tree which includes the <foo...