Using docbook for maven site generation, howto

[David Delbecq-2]

Hello,

i tried to find out documentation on how to use docbook for site
generation in maven. I found out from the simple docbook module that the
directory must be named "docbook" and the files must have extension
"xml". I have this directory structure:

> $ ls src/site/docbook/
> docbook.xml

however, after i run mvn site, i don't see in target/site my docbook.html, and
see no error in the run. Other formats (apt, xdoc) work properly.
Do i need to add something to get this working? I tried


>       <extensions>
>          <extension>
>             <groupId>org.apache.maven.doxia</groupId>
>             <artifactId>doxia-module-docbook-simple</artifactId>
>             <version>1.0-alpha-11</version>
>          </extension>
>       </extensions>

But it doesn't seem to have any effect. Here are useful information about running environment:

$ mvn --version
Maven version: 2.0.9
Java version: 1.6.0_06
OS name: "linux" version: "2.6.24-16-generic" arch: "i386" Family: "unix"

$ mvn -U help:describe -Dplugin=site
[INFO] Plugin: 'org.apache.maven.plugins:maven-site-plugin:2.0-beta-6'
-----------------------------------------------
Group Id:  org.apache.maven.plugins
Artifact Id: maven-site-plugin
Version:     2.0-beta-6
Goal Prefix: site
Description:

Maven Plugins


regards,
David Delbecq

[Lukas Theussl-4]

This was pointed out only recently: [1,2]. I'm not sure where the
problem is but probably this should be filed for the site plugin, as on
the doxia level everything seems to work.

HTH,
-Lukas

[1]
http://www.nabble.com/doxia-maven-fails-to-convert-docbook-files-td16491342.html
[2] http://jira.codehaus.org/browse/DOXIASITETOOLS-10


David Delbecq wrote:

> Hello,
>
> i tried to find out documentation on how to use docbook for site
> generation in maven. I found out from the simple docbook module that the
> directory must be named "docbook" and the files must have extension
> "xml". I have this directory structure:
>
>
>>$ ls src/site/docbook/
>>docbook.xml
>
>
> however, after i run mvn site, i don't see in target/site my docbook.html, and
> see no error in the run. Other formats (apt, xdoc) work properly.
> Do i need to add something to get this working? I tried
>
>
>
>>      <extensions>
>>         <extension>
>>            <groupId>org.apache.maven.doxia</groupId>
>>            <artifactId>doxia-module-docbook-simple</artifactId>
>>            <version>1.0-alpha-11</version>
>>         </extension>
>>      </extensions>
>
>
> But it doesn't seem to have any effect. Here are useful information about running environment:
>
> $ mvn --version
> Maven version: 2.0.9
> Java version: 1.6.0_06
> OS name: "linux" version: "2.6.24-16-generic" arch: "i386" Family: "unix"
>
> $ mvn -U help:describe -Dplugin=site
> [INFO] Plugin: 'org.apache.maven.plugins:maven-site-plugin:2.0-beta-6'
> -----------------------------------------------
> Group Id:  org.apache.maven.plugins
> Artifact Id: maven-site-plugin
> Version:     2.0-beta-6
> Goal Prefix: site
> Description:
>
> Maven Plugins
>
>
> regards,
> David Delbecq
>
>

[Lukas Theussl-4]

Actually, did you try this:

   <build>
     <plugins>
       <plugin>
         <artifactId>maven-site-plugin</artifactId>
         <version>2.0-beta-6</version>
         <dependencies>
           <dependency>
             <groupId>org.apache.maven.doxia</groupId>
             <artifactId>doxia-module-docbook-simple</artifactId>
             <version>1.0-alpha-10</version>
           </dependency>
         </dependencies>
       </plugin>
     </plugins>
   </build>

this seems to work for me...

-Lukas


Lukas Theussl wrote:

> This was pointed out only recently: [1,2]. I'm not sure where the
> problem is but probably this should be filed for the site plugin, as on
> the doxia level everything seems to work.
>
> HTH,
> -Lukas
>
> [1]
> http://www.nabble.com/doxia-maven-fails-to-convert-docbook-files-td16491342.html 
>
> [2] http://jira.codehaus.org/browse/DOXIASITETOOLS-10
>
>
> David Delbecq wrote:
>
>> Hello,
>>
>> i tried to find out documentation on how to use docbook for site
>> generation in maven. I found out from the simple docbook module that the
>> directory must be named "docbook" and the files must have extension
>> "xml". I have this directory structure:
>>
>>
>>> $ ls src/site/docbook/
>>> docbook.xml
>>
>>
>>
>> however, after i run mvn site, i don't see in target/site my
>> docbook.html, and see no error in the run. Other formats (apt, xdoc)
>> work properly.
>> Do i need to add something to get this working? I tried
>>
>>
>>
>>>      <extensions>
>>>         <extension>
>>>            <groupId>org.apache.maven.doxia</groupId>
>>>            <artifactId>doxia-module-docbook-simple</artifactId>
>>>            <version>1.0-alpha-11</version>
>>>         </extension>
>>>      </extensions>
>>
>>
>>
>> But it doesn't seem to have any effect. Here are useful information
>> about running environment:
>>
>> $ mvn --version
>> Maven version: 2.0.9
>> Java version: 1.6.0_06
>> OS name: "linux" version: "2.6.24-16-generic" arch: "i386" Family: "unix"
>>
>> $ mvn -U help:describe -Dplugin=site
>> [INFO] Plugin: 'org.apache.maven.plugins:maven-site-plugin:2.0-beta-6'
>> -----------------------------------------------
>> Group Id:  org.apache.maven.plugins
>> Artifact Id: maven-site-plugin
>> Version:     2.0-beta-6
>> Goal Prefix: site
>> Description:
>>
>> Maven Plugins
>>
>>
>> regards,
>> David Delbecq
>>
>>
>