doxia-book-maven-plugin - How do I bind book sections to markdown files?

classic Classic list List threaded Threaded
3 messages Options
Reply | Threaded
Open this post in threaded view
|

doxia-book-maven-plugin - How do I bind book sections to markdown files?

Oliver Schrenk
Hi,

I want to use the markdown files I use for site generation under
`src/site/markdown` to also generate a pdf using doxia-book-maven-plugin.

I created an examplary `book.xml` under `src/books/book.xml`

    <book xmlns="http://maven.apache.org/BOOK/1.0.0" xmlns:xsi="
http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://maven.apache.org/BOOK/1.0.0
http://maven.apache.org/xsd/book-1.0.0.xsd">
        <id>book</id>
        <title>RefProc Snapshot Process Syntax Guide</title>
        <chapters>
            <chapter>
                <id>bind</id>
                <title>Bindings</title>
                <sections>
                    <section>
                        <id>01-stuff.md</id>
                    </section>
                </sections>
            </chapter>
        </chapters>
    </book>

My `pom.xml` looks like this:

    ...
    plugin>
        <groupId>org.apache.maven.doxia</groupId>
        <artifactId>doxia-book-maven-plugin</artifactId>
        <version>1.3-SNAPSHOT</version>
        <executions>
            <execution>
                <phase>pre-site</phase>
                <goals>
                    <goal>render-books</goal>
                </goals>
            </execution>
        </executions>
        <configuration>
            <books>
                <book>
                    <directory>src/site/markdown</directory>
                    <descriptor>src/books/book.xml</descriptor>
                    <formats>
                        <format>
                            <id>pdf</id>
                        </format>
                    </formats>
                </book>
            </books>
        </configuration>
    </plugin>
    ...

I get

    [ERROR] Failed to execute goal
org.apache.maven.doxia:doxia-book-maven-plugin:1.3-SNAPSHOT:render-books
(default) on projectsnapshot-io-gson: Error while generating book in format
'pdf'. No document that matches section with id=01-json.md. -> [Help1]


Which is to be expected as I have no clue on how to map my markdown files
to the various chapters and sections and I can't find any infos on it.

Does anybody know how to do this?

Best regards
Oliver Schrenk
Reply | Threaded
Open this post in threaded view
|

Re: doxia-book-maven-plugin - How do I bind book sections to markdown files?

Lukas Theussl-4

If you only want to generate a pdf parallel to the site, you should
rather use the maven-pdf-plugin [1] instead of the
doxia-book-maven-plugin. It works better in my experience.

HTH,
-Lukas

[1] http://maven.apache.org/plugins/maven-pdf-plugin/


Oliver Schrenk wrote:

> Hi,
>
> I want to use the markdown files I use for site generation under
> `src/site/markdown` to also generate a pdf using doxia-book-maven-plugin.
>
> I created an examplary `book.xml` under `src/books/book.xml`
>
>     <book xmlns="http://maven.apache.org/BOOK/1.0.0" xmlns:xsi="
> http://www.w3.org/2001/XMLSchema-instance"
>         xsi:schemaLocation="http://maven.apache.org/BOOK/1.0.0
> http://maven.apache.org/xsd/book-1.0.0.xsd">
>         <id>book</id>
>         <title>RefProc Snapshot Process Syntax Guide</title>
>         <chapters>
>             <chapter>
>                 <id>bind</id>
>                 <title>Bindings</title>
>                 <sections>
>                     <section>
>                         <id>01-stuff.md</id>
>                     </section>
>                 </sections>
>             </chapter>
>         </chapters>
>     </book>
>
> My `pom.xml` looks like this:
>
>     ...
>     plugin>
>         <groupId>org.apache.maven.doxia</groupId>
>         <artifactId>doxia-book-maven-plugin</artifactId>
>         <version>1.3-SNAPSHOT</version>
>         <executions>
>             <execution>
>                 <phase>pre-site</phase>
>                 <goals>
>                     <goal>render-books</goal>
>                 </goals>
>             </execution>
>         </executions>
>         <configuration>
>             <books>
>                 <book>
>                     <directory>src/site/markdown</directory>
>                     <descriptor>src/books/book.xml</descriptor>
>                     <formats>
>                         <format>
>                             <id>pdf</id>
>                         </format>
>                     </formats>
>                 </book>
>             </books>
>         </configuration>
>     </plugin>
>     ...
>
> I get
>
>     [ERROR] Failed to execute goal
> org.apache.maven.doxia:doxia-book-maven-plugin:1.3-SNAPSHOT:render-books
> (default) on projectsnapshot-io-gson: Error while generating book in format
> 'pdf'. No document that matches section with id=01-json.md. -> [Help1]
>
>
> Which is to be expected as I have no clue on how to map my markdown files
> to the various chapters and sections and I can't find any infos on it.
>
> Does anybody know how to do this?
>
> Best regards
> Oliver Schrenk
>

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]

Reply | Threaded
Open this post in threaded view
|

Re: doxia-book-maven-plugin - How do I bind book sections to markdown files?

Oliver Schrenk
Yeah, I might try that as there seems to be no one else out there who had this usecase before. I was hoping that someday doxia would support a docx sink.

For now I defaulted to pandoc.

Cheers
Oliver

Am 17.08.2012 um 11:23 schrieb Lukas Theussl <[hidden email]>:

>
> If you only want to generate a pdf parallel to the site, you should
> rather use the maven-pdf-plugin [1] instead of the
> doxia-book-maven-plugin. It works better in my experience.
>
> HTH,
> -Lukas
>
> [1] http://maven.apache.org/plugins/maven-pdf-plugin/
>
>
> Oliver Schrenk wrote:
>> Hi,
>>
>> I want to use the markdown files I use for site generation under
>> `src/site/markdown` to also generate a pdf using doxia-book-maven-plugin.
>>
>> I created an examplary `book.xml` under `src/books/book.xml`
>>
>>    <book xmlns="http://maven.apache.org/BOOK/1.0.0" xmlns:xsi="
>> http://www.w3.org/2001/XMLSchema-instance"
>>        xsi:schemaLocation="http://maven.apache.org/BOOK/1.0.0
>> http://maven.apache.org/xsd/book-1.0.0.xsd">
>>        <id>book</id>
>>        <title>RefProc Snapshot Process Syntax Guide</title>
>>        <chapters>
>>            <chapter>
>>                <id>bind</id>
>>                <title>Bindings</title>
>>                <sections>
>>                    <section>
>>                        <id>01-stuff.md</id>
>>                    </section>
>>                </sections>
>>            </chapter>
>>        </chapters>
>>    </book>
>>
>> My `pom.xml` looks like this:
>>
>>    ...
>>    plugin>
>>        <groupId>org.apache.maven.doxia</groupId>
>>        <artifactId>doxia-book-maven-plugin</artifactId>
>>        <version>1.3-SNAPSHOT</version>
>>        <executions>
>>            <execution>
>>                <phase>pre-site</phase>
>>                <goals>
>>                    <goal>render-books</goal>
>>                </goals>
>>            </execution>
>>        </executions>
>>        <configuration>
>>            <books>
>>                <book>
>>                    <directory>src/site/markdown</directory>
>>                    <descriptor>src/books/book.xml</descriptor>
>>                    <formats>
>>                        <format>
>>                            <id>pdf</id>
>>                        </format>
>>                    </formats>
>>                </book>
>>            </books>
>>        </configuration>
>>    </plugin>
>>    ...
>>
>> I get
>>
>>    [ERROR] Failed to execute goal
>> org.apache.maven.doxia:doxia-book-maven-plugin:1.3-SNAPSHOT:render-books
>> (default) on projectsnapshot-io-gson: Error while generating book in format
>> 'pdf'. No document that matches section with id=01-json.md. -> [Help1]
>>
>>
>> Which is to be expected as I have no clue on how to map my markdown files
>> to the various chapters and sections and I can't find any infos on it.
>>
>> Does anybody know how to do this?
>>
>> Best regards
>> Oliver Schrenk
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [hidden email]
> For additional commands, e-mail: [hidden email]
>

---------------------------------------------------------------------
To unsubscribe, e-mail: [hidden email]
For additional commands, e-mail: [hidden email]