generate-javahelp goal

[GoogleCodeExporter]

I recently started using docbkx to generate html and pdf docs for a java
tool I'm working on. Would it be possible to add a javahelp target along
with these?

Original issue reported on code.google.com by thomas%s...@gtempaccount.com on 20 Feb 2009 at 11:07

[GoogleCodeExporter]

Hi,

I did some tests and it seems to be working without much trouble.
We have an issue with images src path not generated but it is maybe our sample
(http://code.google.com/p/docbkx-tools/source/browse/trunk/docbkx-samples/src/do
cbkx/sample2.xml)
makes use of entityref and it is maybe not well supported. We have to check the 
other
image declarations.

But as I am not a JavaHelp user could you tell us if we have to do clever things
after the docbook generation? Like making a jar ...

I attached what is generated in the sample I used, tell us if everything is okay
(except the image not being there)

Regards,
Cédric,

Original comment by MimilO...@gmail.com on 2 Mar 2009 at 8:43

Attachments:

• javahelp.zip

[GoogleCodeExporter]

Hi Cédric,

The plugin portion of my pom is

<plugin>
  <groupId>com.agilejava.docbkx</groupId>
  <artifactId>docbkx-maven-plugin</artifactId>
  <executions>
    <execution>
      <goals>
        <goal>generate-html</goal>
        <goal>generate-pdf</goal>
        <goal>generate-manpages</goal>
        <goal>generate-javahelp</goal>
      </goals>
      <phase>compile</phase>
    </execution>
  </executions>
</plugin>

and I am currently getting the error 

Error message:
Plugin: com.agilejava.docbkx:docbkx-maven-plugin:2.0.8 does not contain 
referenced
mojo: generate-javahelp

Am I using the wrong goal or is there a more recent version that has the java 
help goal?

The two repositories I have in my pom are

<repository>
  <id>java.net</id>
  <url>http://download.java.net/maven/2</url>
  <layout>default</layout>
</repository>
<repository>
  <id>agilejava</id>
  <url>http://agilejava.com/maven/</url>
  <layout>default</layout>
</repository>

Thanks for your help,

Thomas

Original comment by ThomasOB...@gmail.com on 3 Mar 2009 at 5:32

[GoogleCodeExporter]

Hi Thomas,

this feature is not yet available, I just gave it a try on my computer.
So as I am trying to implement it and as I do not have any knowledge of 
JavaHelp, do
you have any idea if we have to implement things after the docbook generation in
order to simplify the user life?
If not I will try to make it available as is in the 2.0.9-SNAPSHOT.

Cédric,

Original comment by MimilO...@gmail.com on 3 Mar 2009 at 5:42

[GoogleCodeExporter]

Hi Cédric,

For the JavaHelp in our projects after creating the JavaHelp files we replace 
the
index file with one we made by hand, we then update some configuration options 
in the
.hs file for favourites and bookmarks, then we pull in some images from 
different
parts of our project before creating a jar of all these files.

If docbkx generated the JavaHelp files and gave them as is we could update and 
add
the necessary resources before creating the jar. If you want to give the files 
in a
jar we would have to just un-jar it, make the necessary changes, and then 
create a
new jar.

Thomas

Original comment by ThomasOB...@gmail.com on 3 Mar 2009 at 6:04

[GoogleCodeExporter]

Original comment by MimilO...@gmail.com on 4 Mar 2009 at 11:17

• Changed state: Started
• Added labels: Type-Enhancement
• Removed labels: Type-Defect

[GoogleCodeExporter]

Hi,

you can give it a try with 2.0.9-SNAPSHOT
(http://code.google.com/p/docbkx-tools/wiki/HowToUseSnapshots)

Cedric,

Original comment by MimilO...@gmail.com on 5 Mar 2009 at 9:29

• Changed state: Fixed

[GoogleCodeExporter]

Original comment by MimilO...@gmail.com on 18 Mar 2009 at 9:24

• Added labels: Milestone-Release2.0.9