« Return to Thread: Unable to generate xdoc format book with TOC

Re: Unable to generate xdoc format book with TOC

by Lukas Theussl-4 :: Rate this Message:

Reply to Author | View in Thread


This issue is fixed in doxia 1.1:

http://jira.codehaus.org/browse/DOXIA-157

And yes, it should be released soon...

-Lukas


Ahana wrote:

>
> Dave - I get the following when I run "mvn -X site" command.
>
> <snip>
> [DEBUG] Configuring mojo
> 'org.apache.maven.doxia:doxia-maven-plugin:1.0-alpha-10
> :render-books' -->
> [DEBUG]   (f) basedir = C:\Documents and
> Settings\doxiauser\my-maven\my-web-app
> [DEBUG]   (f) directory = src/books/af-book/xdoc
> [DEBUG]   (f) descriptor = src/books/af-book/bookdescriptor.xml
> [DEBUG]   (f) id = xdoc
> [DEBUG]   (f) formats = [org.apache.maven.doxia.plugin.Format@6754d6]
> [DEBUG]   (f) books = [org.apache.maven.doxia.plugin.Book@1f2cea2]
> [DEBUG]   (f) generatedDocs = C:\Documents and
> Settings\doxiauser\my-maven\my-web-
> app\target\generated-site
> [DEBUG] -- end configuration --
> [INFO] [doxia:render-books {execution: default}]
> [DEBUG] Locating files to include in the book:
> [DEBUG] Basedir: C:\Documents and Settings\doxiauser\my-maven\my-web-app
> [DEBUG] Includes: **/*
> [DEBUG] Excludes:
> [DEBUG] Dumping document <-> id mapping:
> [DEBUG]  Chapter1=C:\Documents and
> Settings\doxiauser\my-maven\my-web-app\src\book
> s\af-book\xdoc\Chapter1.xml, parser: doc-book  <<<=====
> [INFO]
> ------------------------------------------------------------------------
> [ERROR] BUILD ERROR
> [INFO]
> ------------------------------------------------------------------------
> [INFO] Error while generating book in format 'xdoc'.
> <snip>
>
> Embedded error: No document that matches section with id=Chap1Sec1.
> [INFO]
> ------------------------------------------------------------------------
>
> It seems that the problem is that the parser used is that of doc-book rather
> than xdoc.
> Is there anyway for me to force the parser that should be used? - Thanks.
>
>
>
> dhallammail-apache wrote:
>
>>Hi Ahana,
>>
>>Try running
>>
>>mvn -X site
>>
>>which should help you see what it's complaining about.  Post back if you
>>still can't figure out what's wrong and include the section from the
>>bottom of the output that's relevent, i.e. not the bits that are checking
>>pom dependencies, etc.
>>
>>Regards,
>>
>>Dave
>>
>>
>>
>>
>>________________________________
>>From: Ahana <ahana.tur@...>
>>To: doxia-users@...
>>Sent: Monday, 5 January, 2009 0:27:28
>>Subject: Unable to generate xdoc format book with TOC
>>
>>
>>Hi,
>>
>>I am unable to generate the book in xdoc format using maven. The error
>>that
>>I am
>>getting is shown below.
>>
>>C:\Documents and Settings\doxiauser\my-maven\my-web-app>mvn site
>>[INFO] Scanning for projects...
>>WAGON_VERSION: 1.0-beta-2
>>[INFO]
>>------------------------------------------------------------------------
>>[INFO] Building my-web-app
>>[INFO]    task-segment: [site]
>>[INFO]
>>------------------------------------------------------------------------
>>[INFO] [doxia:render-books {execution: default}]
>>[INFO]
>>------------------------------------------------------------------------
>>[ERROR] BUILD ERROR
>>[INFO]
>>------------------------------------------------------------------------
>>[INFO] Error while generating book in format 'xdoc'.
>>
>>Embedded error: No document that matches section with id=Chap1Sec1.
>>[INFO]
>>------------------------------------------------------------------------
>>[INFO] For more information, run Maven with the -e switch
>>[INFO]
>>------------------------------------------------------------------------
>>
>>I would appreciate if someone can tell me why this is happening or point
>>me
>>to
>>a sample xdoc book (source code) on the net. I have not been able to find
>>any
>>and am stuck with this error.  Have tried various things listed on Doxia
>>website
>>about having unique id's or anchoring with the 'a' tag.
>>
>>I have my book which is just two files - Chapter1.xml and Chapter2.xml.
>>The
>>pom.xml
>>is defined as follows according to Doxia. The test files are below:
>>
>>pom.xml (Relevant part shown)
>>------------------------------
>>
>><plugin>
>>  <groupId>org.apache.maven.doxia</groupId>
>>  <artifactId>doxia-maven-plugin</artifactId>
>>  <version>1.0-alpha-10</version>
>>  <executions>
>>     <execution>
>>         <phase>pre-site</phase>
>>         <goals>
>>         <goal>render-books</goal>
>>     </goals>
>>     </execution>
>>   </executions>
>>   <configuration>
>>        <books>
>>             <book>
>>             <directory>src/books/af-book/xdoc</directory>
>>         <descriptor>src/books/af-book/bookdescriptor.xml</descriptor>
>>         <formats>
>>            <format>
>>                 <id>xdoc</id>
>>            </format>
>>         </formats>
>>        </book>
>>    </books>
>>    </configuration>
>></plugin>
>>
>>bookdescriptor.xml
>>------------------
>>
>><book>
>>  <id>test-example-book</id>
>>  <title>Test Book</title>
>>  <chapters>
>>    <chapter>
>>      <id>Chapter1</id>
>>      <title>Chapter1</title>
>>      <sections>
>>        <section>
>>          <id>Chap1Sec1</id>
>>        </section>
>>        <section>
>>          <id>Chap1Sec2</id>
>>        </section>
>>      </sections>
>>    </chapter>
>>    <chapter>
>>      <id>Chapter2</id>
>>      <title>Chapter2</title>
>>      <sections>
>>        <section>
>>          <id>Chap2Sec1</id>
>>        </section>
>>        <section>
>>          <id>Chap2Sec2</id>
>>        </section>
>>      </sections>
>>    </chapter>
>>  </chapters>
>></book>
>>
>>Chapter1.xml
>>-------------
>>
>><?xml version="1.0" encoding="UTF-8"?>
>><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Maven//EN"
>>"http://www.apache.org/dtds/xdoc_1_0.dtd">
>><document>
>>  <properties>
>>    <title id="Chapter1">Chapter1</title>
>>    <author email="user@...">Domain User</author>
>>  </properties>
>>
>>  <body>
>>    <section id="Chap1Sec1" name="Chap1Sec1">
>>        This is chapter one - section one.
>>    </section>
>>
>>    <section id="Chap1Sec2" name="Chap1Sec2">
>>        This is chapter one - section two.
>>    </section>
>>  </body>
>></document>
>>
>>Chapter2.xml
>>-------------
>>
>><?xml version="1.0" encoding="UTF-8"?>
>><!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation Maven//EN"
>>"http://www.apache.org/dtds/xdoc_1_0.dtd">
>><document>
>>  <properties>
>>    <title id="Chapter2">Chapter2</title>
>>    <author email="user@...">Domain User</author>
>>  </properties>
>>
>>  <body>
>>    <section id="Chap2Sec1" name="Chap2Sec1">
>>        This is chapter two - section one.
>>    </section>
>>
>>    <section id="Chap2Sec2" name="Chap2Sec2">
>>        This is chapter two - section two.
>>    </section>
>>    
>>  
>>  </body>
>></document>
>>
>>Thanks,
>>A
>>--
>>View this message in context:
>>http://www.nabble.com/Unable-to-generate-xdoc-format-book-with-TOC-tp21283547p21283547.html
>>Sent from the Doxia - Users mailing list archive at Nabble.com.
>>
>>
>>
>>
>
>

 « Return to Thread: Unable to generate xdoc format book with TOC