Hi Ahana,

Yes, the problem is that it's using the doc-book parser.  I thought that might 
be what it was as I had the same problem a few days ago.  I replaced the xdoc 
with a doc-book format document and it worked fine.  Trouble is I have all my 
docs in xdoc.

I've been posting on this mailing list for examples of generating PDFs from 
xdoc using doxia and had no responses.  I wanted to reuse the xdoc that I had 
for the site generated by maven.  But it appears that this just doesn't work in 
the same way as site.

You could use apt as the format.  That worked fine - the difference is that the 
name of the apt file is the id, i.e. blah.apt matches when id="blah".

Then the problem I encountered was styling.  The PDF that I was generating 
looked rubbish.  I used to run the old maven 1.x PDF plugin and had no problems 
customising the front page and contents page, etc. but I can't find any 
documentation on how to do this with doxia.  Again, I've asked the mailing list 
for examples or documentation but have had no replies.

I've since given up and am using latex to generate PDFs that look good.

I'm really disappointed with doxia - I was really looking forward to having a 
single source of docs (xdoc) that could be rendered into different formats but 
I just can't get anything useful out of it apart from the HTML site and HTML 
book.

Sorry I have nothing particularly positive to help you.

Dave




________________________________
From: Ahana <[email protected]>
To: [email protected]
Sent: Monday, 5 January, 2009 18:21:24
Subject: Re: Unable to generate xdoc format book with TOC



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.for...@6754d6]
[DEBUG]   (f) books = [org.apache.maven.doxia.plugin.b...@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 <[email protected]>
> To: [email protected]
> 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="[email protected]">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="[email protected]">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.
> 
> 
> 
> 

-- 
View this message in context: 
http://www.nabble.com/Unable-to-generate-xdoc-format-book-with-TOC-tp21283547p21296299.html
Sent from the Doxia - Users mailing list archive at Nabble.com.


      

Reply via email to