Questions tagged [docbook]

DocBook provides a system for writing structured documents using SGML or XML (semantic markup). It is particularly well-suited to books and papers for technical documentation. Earlier versions of DocBook were formally defined as document type definitions (DTDs). From version 5.0 onwards, SGML support is discontinued and the official definition is a RELAX NG schema.

DocBook provides a system for writing structured documents using SGML or XML (semantic markup). It is particularly well-suited to books and papers for technical documentation. Earlier versions of DocBook were formally defined as document type definitions (DTDs). From version 5.0 onwards, SGML support is discontinued and the official definition is a RELAX NG schema.

http://docbook.org/

352 questions
3
votes
2 answers

DocBook 5 to PDF transform failing with error: "fo:flow" is missing child elements. Required content model: marker*

I've inherited a doc publishing process that takes DocBook and builds html and PDF output, using Apache FOP for both. This project had been started, but never completed. With lots of tweaking, I've able to get most of the doc sets to build (20+),…
Rob
  • 123
  • 2
  • 9
3
votes
1 answer

Enabling line-wrap in a docbook programlisting and adding a line wrap symbol

We have some programmer's manual where the example source code lines do not fit to an A4 page when converted to PDF. Since manually line-breaking the code is too much and manual work, I am thinking about enabling line-wrapping for long lines.…
Paul
  • 2,474
  • 7
  • 33
  • 48
3
votes
1 answer

Docbook: Chapter number and word "Chapter" in header

I'm writing documentation in DocBook and want to publish it in PDF with headers and footers. For this purpose I have this style:
Dmitry Arestov
  • 1,427
  • 12
  • 24
3
votes
1 answer

Is there a way to avoid IE7 quirks mode while rendering XML + CSS?

I've got some DocBook documentation styled with a CSS xml-stylesheet declaration. It looks great in Firefox, but IE7 doesn't seem to understand the CSS child selectors (e.g. section > title { ... }). I think this is because IE is running in quirks…
Steven Huwig
  • 20,015
  • 9
  • 55
  • 79
3
votes
2 answers

Docbook to HTML conversion tools (other than jade)

Are there any alternative tools for the conversion of Docbook documents (V4 or V5) to (X)HTML other than the standard Jade tool and the associated DSSSL stylesheet?. Of course XSLT is an option. I am looking for something more robust and handy…
user2665694
3
votes
1 answer

Can I use xinclude and entities in the same XML file?

I'm working in DocBook 5.0, creating a writing/editing/production environment. I validate my XML against the RNG schema version of DB5. To make my environment easier to use, I like to break up my books into multiple files, using xinclude to pull…
jbz
  • 163
  • 7
3
votes
2 answers

Is there a better method than to reuse a complicated table in DocBook?

Consider the DocBook article in test.xml which contains an that is repeated at the beginning of each section. Consider also that the is actually much more complicated than this example shows. This example…
alx9r
  • 3,675
  • 4
  • 26
  • 55
2
votes
1 answer

Docbook and strikethrough functionality

How to add to Docbook strikethrough functionality? I mean something like this this is striked example text. I mean HTML output generation.
scdmb
  • 15,091
  • 21
  • 85
  • 128
2
votes
1 answer

Jboss Maven JdocBook Plugin, Multiple Executions

My team is working on a webservice project, and I am working on creating the documentation for the web service API. I have used a custom JavaDoc doclet to create two xml outputs of the available methods, one for internal developers and one for…
sterbap1
  • 41
  • 3
2
votes
1 answer

Docbook XSL: Set a default size/scale for imagedata elements?

Writing some stylesheets for DocBook. Edit: per the comment below: Yes, this means I am writing customizations based on the DocBook-XSL stylesheets, not rewriting existing DocBook stylesheets. Is it possible, via an XSL stylesheet, to set a default…
DanM
  • 7,037
  • 11
  • 51
  • 86
2
votes
3 answers

Transform XHTML article to Docbook

I need to transform some article about information technologies from format XHTML or HTML in to format Docbook. Then i need to transform the Docbook format in to pdf. But i have got a problem with the first sentence. I dont now how to transform…
jantursky
  • 1,122
  • 1
  • 10
  • 21
2
votes
2 answers

DocBook to OOXML

Our users are asking for a simple way to convert DocBook XML to OOXML (DocBook to Word DOCX) and back. The editing in house is done in Oxygen XML Editor but sometimes they have to send files for editing to other people and Word is still the de facto…
Mike Starov
  • 7,000
  • 7
  • 36
  • 37
2
votes
1 answer

How to customize DocBook for non-technical writing?

I know that the Text Encoding Initiative's guidelines define an XML vocabulary for non-technical text (such as poetry, fiction, etc.) but would like to stick to DocBook if possible, even though it has no XML elements for dialogues, poetry, etc.
toraritte
  • 6,300
  • 3
  • 46
  • 67
2
votes
1 answer

Docbook: configuring the name of the toc file?

From a Docbook document, I apply an xslt stylesheet that with xsltproc is able to produce the table of content file along with files per chapters. I would like to know if there is a way to specify the name of the generated toc file because what I…
Laurent T
  • 1,070
  • 4
  • 13
  • 25
2
votes
1 answer

is there a simple example of a php snippet highlighted in docbook with pdf output?

I've been trying to highlight the code in a programlisting block in docbook. The code is the following: Is there a simple example of how can this be outputted to pdf with…
andrés
  • 412
  • 6
  • 14