[jbosstools-issues] [JBoss JIRA] Commented: (JBIDE-1703) Mavenize the docbook build

[Mark Newton (JIRA)]

    [ http://jira.jboss.com/jira/browse/JBIDE-1703?page=comments#action_12399143 ] 
            
Mark Newton commented on JBIDE-1703:
------------------------------------

I've migrated the build system for JBoss Tools documentation from the old Ant based system to the new Maven2 based system.

This means that the XSLT files previously found in resources/styles/en/*.xsl are now contained in a maven plugin called jbosstools-docbook-xslt.
Similarly the CSS, images, and JavaScript files are now contained in a maven plugin called jbosstools-jdocbook-style.

The source for these plugins can be found here:

https://svn.jboss.org/repos/jbosstools/trunk/documentation/jbosstools-docbook-xslt/
https://svn.jboss.org/repos/jbosstools/trunk/documentation/jbosstools-jdocbook-style/

The DocBook libraries, DTD and XSLT files that previously lived in resources/support are now contained in maven plugin called docbook which is referenced as a dependency from the jbosstools maven plugins.

Each project that wishes to use the new maven based build system must include a pom.xml similar to the ones already created here:

https://svn.jboss.org/repos/jbosstools/trunk/documentation/guides/userguide/Exadel-migration/pom.xml
https://svn.jboss.org/repos/jbosstools/trunk/documentation/guides/userguide/GettingStartedGuide/pom.xml
https://svn.jboss.org/repos/jbosstools/trunk/documentation/guides/userguide/Legacy-jsf-struts/pom.xml

These pom.xml files are very small as I've removed all of the duplicated information, as requested by Max, to a parent pom that is referenced. You can see the contents of this parent pom.xml here:

https://svn.jboss.org/repos/jbosstools/trunk/documentation/jbosstools-documentation/pom.xml

It depends on the jhighlight-1.0.jar and java2html.jar libraries that were previously contained in resources/support/lib using normal Maven dependencies. It also depends on the highlight.jar library which currently lives inside a local Maven repository on my machine as I need permission from the authors (Exadel) to publish it in our public repository at:

http://repository.jboss.org/maven2

All the other maven plugins mentioned above are already published in this public repository so once this final highlight.jar is published everything will work fine.

In the meantime if you want to install highlight.jar into your local repository to try out the new Maven based build you need to enter the following command from the directory where it is located on your local disk:

mvn install:install-file -Dfile=highlight.jar -DgroupId=com.exadel.docbook.colorer -DartifactId=highlight -Dversion=1.0 -Dpackaging=jar

Now that we fetch all of the build elements (DocBook 1.72, custom XSLT, common CSS, images, JavaScript and Highlighting libraries) using Maven you should be able to remove all of the following duplicated resources/ directories: 

JBoss Tools 2.0.0.GA Documentation
---------------------------------------------------

Seam Dev Tools Reference Guide - https://svn.jboss.org/repos/jbosstools/trunk/seam/docs/resources/
Visual Web Tools Reference Guide - https://svn.jboss.org/repos/jbosstools/trunk/jsf/docs/resources/
JBoss Server Manager Reference Guide - https://svn.jboss.org/repos/jbosstools/trunk/as/docs/resources/
jBPM Tools Reference Guide - https://svn.jboss.org/repos/jbosstools/trunk/jbpm/docs/resources/
Hibernate Tools Reference Guide - https://svn.jboss.org/repos/jbosstools/trunk/hibernatetools/docs/resources/
Legacy-jsf-struts guide - https://svn.jboss.org/repos/jbosstools/trunk/documentation/guides/resources/

Other locations
---------------------

documentation/development - https://svn.jboss.org/repos/jbosstools/trunk/documentation/development/resources/

If you want to merge the XSLT and CSS/images used by the default JBoss.org Look & Feel plugins with the JBoss Tools ones (to resolve some of the issues mentioned in the above comments) then the source is located here:

http://anonsvn.jboss.org/repos/labs/labs/jbosslabs/trunk/doc/jbossorg-docbook-xslt/
http://anonsvn.jboss.org/repos/labs/labs/jbosslabs/trunk/doc/jbossorg-jdocbook-style/

> Mavenize the docbook build
> --------------------------
>
>                 Key: JBIDE-1703
>                 URL: http://jira.jboss.com/jira/browse/JBIDE-1703
>             Project: Tools (JBoss Tools)
>          Issue Type: Task
>          Components: Build/Releng
>            Reporter: Max Andersen
>         Assigned To: Mark Newton
>             Fix For: 2.1
>
>         Attachments: eclipse.xsl, pom.xml, settings.xml
>
>
> Will give us the standard style + eclipse look'n'feel out of the box

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.jboss.com/jira/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira