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: Kajidal Akilkis
Country: Iran
Language: English (Spanish)
Genre: Environment
Published (Last): 3 October 2015
Pages: 264
PDF File Size: 11.79 Mb
ePub File Size: 11.59 Mb
ISBN: 148-4-27044-702-6
Downloads: 59285
Price: Free* [*Free Regsitration Required]
Uploader: Tygodal


Simply include a reference to the. The fact that it is plain old XML just makes it a very interesting candidate for completely automating your document generation. Yes, there are a few other plugins.

Take some time to think that over Stack Overflow works best with JavaScript enabled. The result looks like: Gneerate a Reply Cancel.

So now we are able to render different types of output. Simply specify it as additional goals. The result looks like:. February 23rd, Tags: In the parent pom I specified the version to be used as well as the reference to the docbook version to use:.

Docbkx Maven Plugin – javalibs

That is, we must use a namespace in our custom stylesheet to be able to select any docbook element! In the parent pom I specified the version to be used as well as the reference to the docbook version to use: The remainder of the document will broken up into several pieces, depending pluyin the policies you specified with customization properties.

That you means you can always rely on the plugin’s documentation to know which parameters you could docbx in.

Sometimes, we argue with each other. Sign up using Email and Password. This tutorial shows you how to write your first docbook documentation in a Maven project.


Note that this feature is still fairly experimental. Just take a look here and compare it with yours: In all honesty, it is not that complicated at all. Many technical projects have documentation written in Docbook XML and checked in the source control system along with the source code.

The only problem that might get in the way if you are thinking about generating DocBook sources is the fact that Maven does not really provide a clear hook or phase for 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 no-time. And with all of the XML based metadata available in your projects, it would actually be incredibly easy to accomplish. The advanced XInclude mode is activated by specifying the additional ‘generatedSourceDirectory’ parameter. The plugin goal used above generate-html converts the docbook xml to html.


There is no target directory created and I do not see any meaningful output on the command line. A Maven plugin for generating xhtml5 output from DocBook documents, using version 1. 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.

Write a simple docbook file Create the following file: The procedure is simple.

Do I have a chance to get a meaningful log file from docbkx? As no goal is specified nor attached to a phase, you must specify it on the command line like ‘docbkx: Sign up using Facebook.


This sample shows the webhelp output, a browser and platform independent output with a docbmx search engine. Instead of being a reference plugi, this document is intended to get you started, and at least to get some flavour of the scope of this plugin.

As of version 2. You can always refer to other fonts installed on your system, but then there is a chance that your audience does not have those fonts installed causing your document to be completely unreadable. Using this configuration, you can build a document from the sources by invoking docbkx: I checked this documentation out. This sample shows how to skip the plugin execution in an easy way.

See more info here. I managed to find my own post here which you referenced, and a solution! In order to use it, add a language attribute to the DocBook element containing your sources, and set it to the language of the sources within that element.

The plugin provides this flexibility by allowing you to pass a reference to your own stylesheet.

Docbkx Tools

I think that issue should be clearly noted with the docbkx-maven-plugin Maven plugin, because in the end it is an incompatability between versions 2. Rick-Rainer Ludwig 1, 1 18 Well, that did the trick — after spending a couple of hours of investigation The trick is how to locate the ‘standard’ docbook.

Henerate using this import: This sample shows how to setup a dependency to docbook xml 4.

Posted in <a href="" rel="category tag">Life</a>