Details
-
Type:
New Feature
-
Status:
Open
-
Priority:
Major
-
Resolution: Unresolved
-
Affects Version/s: doxia-book-1.2
-
Fix Version/s: None
-
Component/s: Book
-
Labels:None
-
Environment:OSX 10.5.7, Java 5, Maven 2.2
Description
Hi
I have a chapter declared like this in xxx.xml:
<chapter>
<id>xxx_Integration</id>
<title>xxx Integration</title>
<sections>
<section>
<id>xxx/index</id>
</section>
</sections>
</chapter>
Where:
src/site/apt/xxx/integraion
Contains some documentation specific to xxx.
When I try to use mvn site with this config in pom.xml:
<book>
<directory>src/site/apt</directory>
<descriptor>src/site/xxx.xml</descriptor>
<formats>
<format>
<id>pdf</id>
</format>
</formats>
</book>
I get this error:
ERROR] BUILD ERROR
[INFO] ------------------------------------------------------------------------
[INFO] Error while generating book in format 'pdf'.
Embedded error: No document that matches section with id=xxx/index.
I don't know whether this should work, or whether this is a new feature request.
Thanks
Nathan
I think this should work. It's not very intuitive though since slashes are not legal characters in Doxia id's. But as far as I know, the section id is only used by the book code to resolve relative links between different source documents, so slashes are necessary if you have sub-directories.
Anyway, I think the book descriptor is too complicated in general and should be replaced by something more usable. It's probably going to be deprecated in a future major doxia release.