You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "Nathan Sowatskey (JIRA)" <ji...@codehaus.org> on 2009/07/10 15:37:22 UTC

[jira] Created: (DOXIA-347) Nested APT file directories and PDF generation

Nested APT file directories and PDF generation
----------------------------------------------

                 Key: DOXIA-347
                 URL: http://jira.codehaus.org/browse/DOXIA-347
             Project: Maven Doxia
          Issue Type: New Feature
          Components: Book
    Affects Versions: 1.2
         Environment: OSX 10.5.7, Java 5, Maven 2.2
            Reporter: Nathan Sowatskey


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

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (DOXIA-347) Nested APT file directories and PDF generation

Posted by "Lukas Theussl (JIRA)" <ji...@codehaus.org>.
    [ http://jira.codehaus.org/browse/DOXIA-347?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=183635#action_183635 ] 

Lukas Theussl commented on DOXIA-347:
-------------------------------------

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.

> Nested APT file directories and PDF generation
> ----------------------------------------------
>
>                 Key: DOXIA-347
>                 URL: http://jira.codehaus.org/browse/DOXIA-347
>             Project: Maven Doxia
>          Issue Type: New Feature
>          Components: Book
>    Affects Versions: 1.2
>         Environment: OSX 10.5.7, Java 5, Maven 2.2
>            Reporter: Nathan Sowatskey
>
> 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

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (DOXIA-347) Nested APT file directories and PDF generation

Posted by "Nathan Sowatskey (JIRA)" <ji...@codehaus.org>.
    [ http://jira.codehaus.org/browse/DOXIA-347?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=183649#action_183649 ] 

Nathan Sowatskey commented on DOXIA-347:
----------------------------------------

Thanks. It doesn't work. Would you like to me to provide a test case to help facilitate a fix, or is the description sufficient?

> Nested APT file directories and PDF generation
> ----------------------------------------------
>
>                 Key: DOXIA-347
>                 URL: http://jira.codehaus.org/browse/DOXIA-347
>             Project: Maven Doxia
>          Issue Type: New Feature
>          Components: Book
>    Affects Versions: 1.2
>         Environment: OSX 10.5.7, Java 5, Maven 2.2
>            Reporter: Nathan Sowatskey
>
> 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

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] Commented: (DOXIA-347) Nested APT file directories and PDF generation

Posted by "Lukas Theussl (JIRA)" <ji...@codehaus.org>.
    [ http://jira.codehaus.org/browse/DOXIA-347?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=183654#action_183654 ] 

Lukas Theussl commented on DOXIA-347:
-------------------------------------

A test case always helps... if you have something ready please attach it. But I don't promise anything, I'm not very familiar with the book code.

> Nested APT file directories and PDF generation
> ----------------------------------------------
>
>                 Key: DOXIA-347
>                 URL: http://jira.codehaus.org/browse/DOXIA-347
>             Project: Maven Doxia
>          Issue Type: New Feature
>          Components: Book
>    Affects Versions: 1.2
>         Environment: OSX 10.5.7, Java 5, Maven 2.2
>            Reporter: Nathan Sowatskey
>
> 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

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] (DOXIATOOLS-23) Nested APT file directories and PDF generation

Posted by "Dennis Lundberg (JIRA)" <ji...@codehaus.org>.
     [ https://jira.codehaus.org/browse/DOXIATOOLS-23?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Dennis Lundberg updated DOXIATOOLS-23:
--------------------------------------

    Affects Version/s:     (was: doxia-linkcheck-1.2)
                       doxia-book-1.2
    
> Nested APT file directories and PDF generation
> ----------------------------------------------
>
>                 Key: DOXIATOOLS-23
>                 URL: https://jira.codehaus.org/browse/DOXIATOOLS-23
>             Project: Maven Doxia Tools
>          Issue Type: New Feature
>          Components: Book
>    Affects Versions: doxia-book-1.2
>         Environment: OSX 10.5.7, Java 5, Maven 2.2
>            Reporter: Nathan Sowatskey
>
> 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

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://jira.codehaus.org/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

[jira] (DOXIATOOLS-23) Nested APT file directories and PDF generation

Posted by "Dennis Lundberg (JIRA)" <ji...@codehaus.org>.
     [ https://jira.codehaus.org/browse/DOXIATOOLS-23?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Dennis Lundberg moved DOXIA-347 to DOXIATOOLS-23:
-------------------------------------------------

          Component/s:     (was: Book)
                       Book
    Affects Version/s:     (was: 1.2)
                       1.2
                  Key: DOXIATOOLS-23  (was: DOXIA-347)
              Project: Maven Doxia Tools  (was: Maven Doxia)
    
> Nested APT file directories and PDF generation
> ----------------------------------------------
>
>                 Key: DOXIATOOLS-23
>                 URL: https://jira.codehaus.org/browse/DOXIATOOLS-23
>             Project: Maven Doxia Tools
>          Issue Type: New Feature
>          Components: Book
>    Affects Versions: 1.2
>         Environment: OSX 10.5.7, Java 5, Maven 2.2
>            Reporter: Nathan Sowatskey
>
> 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

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: https://jira.codehaus.org/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira