Top Categories · Home» » docbkx-maven-plugin. Docbkx Maven Plugin. A Maven plugin for generating HTML from DocBook. documentation you’re trying to generate as it exists in the . We have a bit more complex usage since we use the maven filtering plugin to. xalan xalan docbkx-maven-plugin ${project. version} site generate-html pre-site k docbook-xml runtime ant ant -trax.

Author: Shakagami Yotaxe
Country: Peru
Language: English (Spanish)
Genre: Software
Published (Last): 22 January 2008
Pages: 139
PDF File Size: 10.75 Mb
ePub File Size: 13.13 Mb
ISBN: 335-8-52208-395-9
Downloads: 48544
Price: Free* [*Free Regsitration Required]
Uploader: Mauzshura

This document provides an overview of the different features of the Maven Docbkx Plugin. This blog is about these good and bad days DocBook does not need to be hard at all, and – if you want to – DocBook authoring can be almost like The easiest way to customize your DocBook output is probably by changing property values, as outlined above.

You can use the following command to manually run the plugin for purpose of testing: Ahmed Ashour 3, 10 24 Many technical projects have documentation written in Docbook XML and checked in the source control system along with the source code.

What do I miss here? In the DocBook Plugin found at mojo. Also, there are other goals available to generate documentation in more formats including pdf. Normally you would of course want generation of the documents to happen automatically.

Look at the code snipped below to javen out how to do it. Maintaining the dependency by hand would be a lot of work, and there would be severe chance that it would go out whack in maveen. There is no target directory created and I do not see any meaningful output on the command line. Email Required, but never shown. The created custom stylesheets contain an import to urn: A Maven plugin for generating xhtml output from DocBook documents, using version 1.


See highlighted lines in this XSL snippet: For more detailed information on these customizable properties, please consult the online plugin documentation.


February 23rd, Tags: This makes it easy to ship documentation with the source and lets you keep versions of documentation in sync with the product version. Failed to transform to PDF: This is supported as of version 2.

This sample shows how to setup a dependency to docbook xml 4. You do not need to include all of the xml files, you instead need to follow the xincludes approach since you’re declaring its usage. Alas, I did not find this information on the plugin’s Changes Report page. This samples shows you how to use profiling stylesheets in this case the html one.

Rick-Rainer Ludwig 1, 1 18 You will probably find the includes property among the ones you will use most often. The later versions of the DocBook stylesheets support syntax highlighting.

Getting back to your includes usage, if your top level docbook file is index. This sample shows you how to generate EPub documents verion 2 and version 3 see http: The maven docbook plugin converts your docbook xml file to user friendly documentation in HTML.

You create a customization stylesheet that starts by importing the standard docbook. Within the entities section, you simply define an entity called version, and define it to be the value of the POM property version. The highlightXslthlConfig attribute can be used to configure xslthl to add new maevn, The good news is that there is a lot!

  JRC 2360AD PDF

Post Your Answer Discard By clicking “Post Your Answer”, you acknowledge that you have read our updated terms of serviceprivacy policy and cookie policyand that your continued use of the website is subject to these policies.

Java Moods: DocBook with Maven Issue

In this document, we will discuss every feature with an example, showing the relevant configuration code. There are however some significant differences:.

In all honesty, it is not that complicated at all.

I set up the docbkx-maven-plugin to generate PDF documentation for a source project. This has been bugging me for months now, but I was unable to figure it out. XInclude provides an alternative and much more sophisticated way to pull in data from other sources.

Docbkx Tools

The plugins packaged contain the stylesheets as well. No output during run of plugin Ask Question. After doing so, the document conversion issues an error which breaks the build:. I checked this documentation out. A Maven plugin for generating fo output from DocBook documents, using version 1.

View my complete profile.

Author: admin