#7 maven integration

[Igor Jacy Lino Campista]

Hi there,

I just thought of some 2 idea improvements:

There has a been an interesting development recently with the DITA OT maven plugin ( http://mojo.codehaus.org/dita-maven-plugin/\). It allows as part of a continuous integration build to process DITA content. Is there any possibility to have maven integration for the DITA2Confluence tool ?

Basically the DITA2Confluence tool could be re-created to a maven plug-in that could be used even easier (increasing its adoption). All of the jars that are included in the lib directory of the binary distribution are already available in the maven repository.

With a simple pom.xml it could be possible to compile the DITA to the wiki format. And if desired, it could also be also published.

Being a maven plug-in allows for a much wider audience and enables easier distribution, easier dependency management and continues integration.

Another idea is that the DITA2Confluence tools can build its documentation using the dita-maven-plugin. A simple pom.xml there (as shown in the site) could do this.

Cheers, Igor

[Lisa Dyer]

Hi Igor,

I think a Maven/DITA2Confluence integration is a great idea. Thanks for suggesting it. And I agree that it would increase adoption as you say. I'll put this in queue as a high priority for scoping -- we are just now starting to gathering ideas for the next release (1.2.3 or 1.3, date is TBD).

One thing to note, with the DITA OT being part of the proposed integrated system, there is a potential classpath issue as reported here https://sourceforge.net/projects/dita2wiki/forums/forum/864449/topic/3233285?message=7298502. It's quite possible that those classpath issues are now fixed in DITA OT, though.

Re your other idea...by "build its own documentation using the maven plugin", do you mean, to get the std DITA OT outputs such as PDF and HTML for the DITA2Confluence User Guide? Or something else?

- lisa

[Igor Jacy Lino Campista]

Hi Lisa

Great. :)

For classpath issues (if any) one idea would be to contact the author of the dita-maven-plugin, he most likely had to deal with some. He even submitted some bugs to the DITA OT project that got fixed as well. So that would be a good starting poing.

Exactly, the user guide PDF/html would be generated using the dita maven plugin. (example is here https://svn.codehaus.org/mojo/trunk/mojo/dita-maven-plugin/src/it/dita-to-pdf/ ).

Cheers,
Igor

[Igor Jacy Lino Campista]

Hi Lisa,

I added a draft pom.xml that tries to compile the sources and also generate the user guide PDF.

It contains/declares all the dependencies (all jars that in the lib directory) except for :
one: multiexcerpt-plugin-2.0.jar
that jar seems not available in any maven repository. Maybe the confluence guys would like to deploy the jar to a maven repository.

There are 2 other ones that are giving problems:
1) javax.mail:mail:jar:1.3.3
2) javax.xml:saaj-api:jar:1.3

these belong to sun, and therefore are usually not in any maven repository and only as a download in a website. In such cases, projects usually deploy the artifacts locally.

The generation of DITA->PDF assumes that you have unpacked the DITA-OT as follows:

<dita.dir>${project.parent.basedir}/lib/target/DITA-OT1.5</dita.dir>

Cheers,
Igor

[Igor Jacy Lino Campista]

draft pom that compiles sources and generates the PDF for the user guide

[Igor Jacy Lino Campista]

My previous comment, is just that the dita2confluence project sources can be compiled only using maven. It does not have any plug-in functionality (the intent of the original thread)

[Lisa Dyer]

Hi Igor,

Thanks for your pom.xml contribution! I will take it under testing next week barring unforeseen.

Development work on creating the Maven plugin functionality has begun, and I estimate we'll have something to test in mid to late January. Would you be willing to test it?

I will inquire into a possible maven distro of the multi-excerpt plugin, but there might be a commercial limitation. I think it's fine for it to be a JAR that people can download...it's only required if the DITA source uses the <conref> element (the multi-excerpt plugin programs the wiki to make transcluded text readonly).

Update to follow.

Cheers,

- lisa

[Nobody/Anonymous]

Hi Lisa,

Sorry, forgot to answer you this one. Yes I would like to test it.

Cheers,
Igor

[Igor Jacy Lino Campista]

Hi Lisa,

Is there any update on this request ?
(As soon as there is something, I can put it to test )

-Igor

[Lisa Dyer]

Hi Igor,

Yes I do have a distro ready to test. I'm in the middle of something right now but I will send it to you next week. What's a good address to send?

- lisa

[Igor Jacy Lino Campista]

Great :) , My address is

icampista (at) gmx.de

-Igor