Nabble - Doxia - Users

Books and POM Hierarchies

2008-10-06T03:44:35Z

dear list members!

is it possible to reflect a POM hierarchy (with modules) when setting up
a book?

example POM:

- TOP_POM
- SUB_POM_1
- SUBSUB_POM_1
- SUBSUB_POM_2
- SUB_POM_2

so i want to have a book descriptor in TOP_POM project's site, where i
reference the sub-projects' sites and it's chapters.

is this possible?

thx in advance!
joachim

--
http://www.fastmail.fm - Email service worth paying for. Try it for free

Generating a PDF from an APT file

2008-09-29T05:43:18Z

Hello!

I want to create a PDF document from an APT (almost plain text) file.

I want the PDF document to have a title page. However, the resulting
PDF document doesn't have any title page, it begins straight with the
chapter/sections.

My POM looks like this:

<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>at.swDev</groupId>
<artifactId>marketingDb</artifactId>
<packaging>jar</packaging>
<version>1.0-SNAPSHOT</version>
<name>marketingDb</name>
<url>http://www.xing.com/profile/Dmitri_Pissarenko</url>
<build>
<plugins>
<plugin>
<artifactId>maven-site-plugin</artifactId>
<version>2.0-beta-7</version>
</plugin>

<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/doc/maintenance-manual</directory>
<descriptor>src/doc/maintenance-manual.xml</descriptor>
<formats>
<format>
<id>pdf</id>
</format>
</formats>
</book>
</books>
</configuration>
</plugin>
</plugins>
</build>

<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
</dependencies>
</project>

The book descriptor is as shown below.

<book>
<id>maintenance-manual</id>
<title>Marketing-DB Maintenance Manual</title>
<author>Dmitri Pissarenko</author>
<date>29.09.2008</date>
<chapters>
<chapter>
<id>how-tos</id>
<title>How-tos</title>
<sections>
<section>
<id>section1</id>
</section>
</sections>
</chapter>
</chapters>
</book>

All other files can be found in the attached zip file.

What should I change in order to get a title page in my document?

Is there any tutorial about how to configure the layout (fonts,
colours, headlines etc.) of the generated PDF?

Thanks in advance

Dmitri Pissarenko
--
http://www.xing.com/profile/Dmitri_Pissarenko

dev.zip (11K) Download Attachment

Re: doxia book and pdf generation

2008-07-31T01:06:21Z

I forgot that we actually have a branch for site-plugin and
project-info-report-plugin using doxia-beta-1:

https://svn.apache.org/repos/asf/maven/plugins/branches/maven-site-plugin-doxia-beta-1/
https://svn.apache.org/repos/asf/maven/plugins/branches/maven-project-info-reports-plugin-doxia-beta-1/

I haven't looked at it since before my vacation but IIRC this, together
with maven-2.0.x from trunk, is all you need.

HTH,
-Lukas

Lukas Theussl wrote:

> Hi Dave,
>
> The main problem is that you need to use a custom build of the maven
> core because of [1]. The current trunk of 2.0.x branch has already doxia
> bumped to beta-1, so you can just install from svn (the current 2.0.10
> RCs have the doxia dep reverted so they won't work).
>
> After that you have to make sure that no doxia-alpha's are brought in
> transitively from any plugins, I remember specifically the site-plugin
> and project-info-report-plugin, with their deps on reporting tools
> (maven-reporting-impl/api, doxia-tools), causing trouble. You will have
> to install those with updated deps as well.
>
> It's not very convenient so I don't really want to promote it for now,
> but we are trying to get beta-1 out soon now, so it can be used in
> maven-2.0.11, see [2]. In the meantime, any testing feedback will be
> welcome!
>
>
> HTH,
> -Lukas
>
> [1] http://jira.codehaus.org/browse/MNG-3402
> [2] http://docs.codehaus.org/display/MAVEN/Doxia+Release+Plan
>
>
> Dave Syer wrote:
>
>> Lukas,
>>
>> Since you find the unpublished versions of Doxia more usable, would
>> you be
>> able to share with us how to configure and use them? I tried a couple of
>> times just setting the <version/> of doxia-maven-plugin to
>> 1.0-beta-1-SNAPSHOT (and various other flavours) and all I got was plexus
>> class loader issues and a build error with no hints about what I did
>> wrong.
>>
>> Dave.
>>
>>
>> Lukas Theussl-3 wrote:
>>
>>>
>>> No, no idea when beta-1 will be released. It's been formally ready
>>> since a while but there was some resistance because we made some API
>>> changes which could cause backward compatibility problems. The
>>> current maven-2.0.x core branch is running with doxia-beta-1 but it
>>> is not yet used by the site-plugin which means it hasn't got any
>>> real-world testing. That said, it's far more usable for me...
>>>
>>> Cheers,
>>> -Lukas
>>>
>>>
>>> sandraB wrote:
>>>
>>>> Do you have an approximative release date for the next published
>>>> version
>>>> ?
>>>> Sandra
>>>>
>>>>
>>>> Lukas Theussl-3 wrote:
>>>>
>>>>
>>>>> There were several issues in the book module that are fixed in the
>>>>> (unpublished) beta-1 version of doxia, see eg [1,2,3]. I suspect at
>>>>> least some of those are responsible for what you see but it's hard
>>>>> to be sure with the info that you provide. You can attach a
>>>>> complete test project to jira if you want someone to check.
>>>>>
>>>>> HTH,
>>>>> -Lukas
>>>>>
>>>>>
>>>>> [1] http://jira.codehaus.org/browse/DOXIA-157
>>>>> [2] http://jira.codehaus.org/browse/DOXIA-160
>>>>> [3] http://jira.codehaus.org/browse/DOXIA-166
>>>>>
>>>>>
>>>>> sandraB wrote:
>>>>>
>>>>>
>>>>>> Hi,
>>>>>>
>>>>>> I'm trying to use doxia plugins to generate a pdf book and a xdoc
>>>>>> files
>>>>>> to
>>>>>> generate the site, but I've got several errors : - The
>>>>>> doxia:render-books generate xdoc files with a end-tag </document>
>>>>>> at
>>>>>> the end of the files but without any start-tag <document> ==> I've
>>>>>> got a
>>>>>> parser exception in the next step
>>>>>> - When I generate the site (site:site and site:run), the
>>>>>> http://localhost:8080 show website without any styles and img.
>>>>>> - The pdf files is not formated correctly. The sections, subsections,
>>>>>> <ul>
>>>>>> tags, <li> tags, ... have disappeared.
>>>>>> Could you please help me to resolve these issues ?
>>>>>>
>>>>>> Thanks in advance
>>>>>> Sandra
>>>>>>
>>>>>> Here is my pom.xml :
>>>>>>
>>>>>> <plugin>
>>>>>> <artifactId>maven-site-plugin</artifactId>
>>>>>> <version>2.0-beta-6</version>
>>>>>> <dependencies>
>>>>>> <dependency>
>>>>>> <groupId>org.apache.maven.doxia</groupId>
>>>>>> <artifactId>doxia-module-docbook-simple</artifactId>
>>>>>> <version>1.0-alpha-11</version>
>>>>>> </dependency>
>>>>>> </dependencies>
>>>>>> </plugin> <plugin>
>>>>>> <groupId>org.apache.maven.plugins</groupId>
>>>>>> <artifactId>maven-compiler-plugin</artifactId>
>>>>>> <version>2.0</version>
>>>>>> <configuration>
>>>>>> <source>1.4</source>
>>>>>> <target>1.4</target>
>>>>>> </configuration>
>>>>>> </plugin>
>>>>>> <plugin>
>>>>>> <groupId>org.apache.maven.doxia</groupId>
>>>>>> <artifactId>doxia-maven-plugin</artifactId>
>>>>>> <version>1.0-alpha-11</version>
>>>>>> <executions>
>>>>>> <execution>
>>>>>> <phase>pre-site</phase>
>>>>>> <goals>
>>>>>> <goal>render-books</goal>
>>>>>> </goals>
>>>>>> </execution>
>>>>>> </executions>
>>>>>> <configuration>
>>>>>> <books>
>>>>>> <book>
>>>>>> <directory>src/books</directory>
>>>>>> <descriptor>src/books/test.xml</descriptor>
>>>>>> <formats>
>>>>>> <format>
>>>>>> <id>xdoc</id>
>>>>>> </format>
>>>>>> <format>
>>>>>> <id>pdf</id>
>>>>>> </format>
>>>>>> </formats>
>>>>>> </book>
>>>>>> </books>
>>>>>> </configuration>
>>>>>> </plugin>
>>>>>>
>>>>>>
>>>
>>
>

Re: doxia book and pdf generation

2008-07-30T02:00:30Z

Hi Dave,

The main problem is that you need to use a custom build of the maven
core because of [1]. The current trunk of 2.0.x branch has already doxia
bumped to beta-1, so you can just install from svn (the current 2.0.10
RCs have the doxia dep reverted so they won't work).

After that you have to make sure that no doxia-alpha's are brought in
transitively from any plugins, I remember specifically the site-plugin
and project-info-report-plugin, with their deps on reporting tools
(maven-reporting-impl/api, doxia-tools), causing trouble. You will have
to install those with updated deps as well.

It's not very convenient so I don't really want to promote it for now,
but we are trying to get beta-1 out soon now, so it can be used in
maven-2.0.11, see [2]. In the meantime, any testing feedback will be
welcome!

HTH,
-Lukas

[1] http://jira.codehaus.org/browse/MNG-3402
[2] http://docs.codehaus.org/display/MAVEN/Doxia+Release+Plan

Dave Syer wrote:

> Lukas,
>
> Since you find the unpublished versions of Doxia more usable, would you be
> able to share with us how to configure and use them? I tried a couple of
> times just setting the <version/> of doxia-maven-plugin to
> 1.0-beta-1-SNAPSHOT (and various other flavours) and all I got was plexus
> class loader issues and a build error with no hints about what I did wrong.
>
> Dave.
>
>
> Lukas Theussl-3 wrote:
>
>>
>>No, no idea when beta-1 will be released. It's been formally ready since
>>a while but there was some resistance because we made some API changes
>>which could cause backward compatibility problems. The current
>>maven-2.0.x core branch is running with doxia-beta-1 but it is not yet
>>used by the site-plugin which means it hasn't got any real-world
>>testing. That said, it's far more usable for me...
>>
>>Cheers,
>>-Lukas
>>
>>
>>sandraB wrote:
>>
>>>Do you have an approximative release date for the next published version
>>>?
>>>Sandra
>>>
>>>
>>>Lukas Theussl-3 wrote:
>>>
>>>
>>>>There were several issues in the book module that are fixed in the
>>>>(unpublished) beta-1 version of doxia, see eg [1,2,3]. I suspect at
>>>>least some of those are responsible for what you see but it's hard to be
>>>>sure with the info that you provide. You can attach a complete test
>>>>project to jira if you want someone to check.
>>>>
>>>>HTH,
>>>>-Lukas
>>>>
>>>>
>>>>[1] http://jira.codehaus.org/browse/DOXIA-157
>>>>[2] http://jira.codehaus.org/browse/DOXIA-160
>>>>[3] http://jira.codehaus.org/browse/DOXIA-166
>>>>
>>>>
>>>>sandraB wrote:
>>>>
>>>>
>>>>>Hi,
>>>>>
>>>>>I'm trying to use doxia plugins to generate a pdf book and a xdoc files
>>>>>to
>>>>>generate the site, but I've got several errors :
>>>>>- The doxia:render-books generate xdoc files with a end-tag </document>
>>>>>at
>>>>>the end of the files but without any start-tag <document> ==> I've got a
>>>>>parser exception in the next step
>>>>>- When I generate the site (site:site and site:run), the
>>>>>http://localhost:8080 show website without any styles and img.
>>>>>- The pdf files is not formated correctly. The sections, subsections,
>>>>><ul>
>>>>>tags, <li> tags, ... have disappeared.
>>>>>
>>>>>Could you please help me to resolve these issues ?
>>>>>
>>>>>Thanks in advance
>>>>>Sandra
>>>>>
>>>>>Here is my pom.xml :
>>>>>
>>>>><plugin>
>>>>> <artifactId>maven-site-plugin</artifactId>
>>>>> <version>2.0-beta-6</version>
>>>>> <dependencies>
>>>>> <dependency>
>>>>> <groupId>org.apache.maven.doxia</groupId>
>>>>> <artifactId>doxia-module-docbook-simple</artifactId>
>>>>> <version>1.0-alpha-11</version>
>>>>> </dependency>
>>>>> </dependencies>
>>>>></plugin>
>>>>><plugin>
>>>>> <groupId>org.apache.maven.plugins</groupId>
>>>>> <artifactId>maven-compiler-plugin</artifactId>
>>>>> <version>2.0</version>
>>>>> <configuration>
>>>>> <source>1.4</source>
>>>>> <target>1.4</target>
>>>>> </configuration>
>>>>></plugin>
>>>>><plugin>
>>>>> <groupId>org.apache.maven.doxia</groupId>
>>>>> <artifactId>doxia-maven-plugin</artifactId>
>>>>> <version>1.0-alpha-11</version>
>>>>> <executions>
>>>>> <execution>
>>>>> <phase>pre-site</phase>
>>>>> <goals>
>>>>> <goal>render-books</goal>
>>>>> </goals>
>>>>> </execution>
>>>>> </executions>
>>>>> <configuration>
>>>>> <books>
>>>>> <book>
>>>>> <directory>src/books</directory>
>>>>> <descriptor>src/books/test.xml</descriptor>
>>>>> <formats>
>>>>> <format>
>>>>> <id>xdoc</id>
>>>>> </format>
>>>>> <format>
>>>>> <id>pdf</id>
>>>>> </format>
>>>>> </formats>
>>>>> </book>
>>>>> </books>
>>>>> </configuration>
>>>>></plugin>
>>>>>
>>>>>
>>
>

Re: doxia book and pdf generation

2008-07-30T01:16:33Z

Lukas,

Since you find the unpublished versions of Doxia more usable, would you be able to share with us how to configure and use them? I tried a couple of times just setting the <version/> of doxia-maven-plugin to 1.0-beta-1-SNAPSHOT (and various other flavours) and all I got was plexus class loader issues and a build error with no hints about what I did wrong.

Dave.

Lukas Theussl-3 wrote:

No, no idea when beta-1 will be released. It's been formally ready since
a while but there was some resistance because we made some API changes
which could cause backward compatibility problems. The current
maven-2.0.x core branch is running with doxia-beta-1 but it is not yet
used by the site-plugin which means it hasn't got any real-world
testing. That said, it's far more usable for me...

Cheers,
-Lukas

sandraB wrote:
> Do you have an approximative release date for the next published version ?
> Sandra
>
>
> Lukas Theussl-3 wrote:
>
>>
>>There were several issues in the book module that are fixed in the
>>(unpublished) beta-1 version of doxia, see eg [1,2,3]. I suspect at
>>least some of those are responsible for what you see but it's hard to be
>>sure with the info that you provide. You can attach a complete test
>>project to jira if you want someone to check.
>>
>>HTH,
>>-Lukas
>>
>>
>>[1] http://jira.codehaus.org/browse/DOXIA-157
>>[2] http://jira.codehaus.org/browse/DOXIA-160
>>[3] http://jira.codehaus.org/browse/DOXIA-166
>>
>>
>>sandraB wrote:
>>
>>>Hi,
>>>
>>>I'm trying to use doxia plugins to generate a pdf book and a xdoc files
>>>to
>>>generate the site, but I've got several errors :
>>>- The doxia:render-books generate xdoc files with a end-tag </document>
>>>at
>>>the end of the files but without any start-tag <document> ==> I've got a
>>>parser exception in the next step
>>>- When I generate the site (site:site and site:run), the
>>>http://localhost:8080 show website without any styles and img.
>>>- The pdf files is not formated correctly. The sections, subsections,
>>><ul>
>>>tags, <li> tags, ... have disappeared.
>>>
>>>Could you please help me to resolve these issues ?
>>>
>>>Thanks in advance
>>>Sandra
>>>
>>>Here is my pom.xml :
>>>
>>><plugin>
>>> <artifactId>maven-site-plugin</artifactId>
>>> <version>2.0-beta-6</version>
>>> <dependencies>
>>> <dependency>
>>> <groupId>org.apache.maven.doxia</groupId>
>>> <artifactId>doxia-module-docbook-simple</artifactId>
>>> <version>1.0-alpha-11</version>
>>> </dependency>
>>> </dependencies>
>>></plugin>
>>><plugin>
>>> <groupId>org.apache.maven.plugins</groupId>
>>> <artifactId>maven-compiler-plugin</artifactId>
>>> <version>2.0</version>
>>> <configuration>
>>> <source>1.4</source>
>>> <target>1.4</target>
>>> </configuration>
>>></plugin>
>>><plugin>
>>> <groupId>org.apache.maven.doxia</groupId>
>>> <artifactId>doxia-maven-plugin</artifactId>
>>> <version>1.0-alpha-11</version>
>>> <executions>
>>> <execution>
>>> <phase>pre-site</phase>
>>> <goals>
>>> <goal>render-books</goal>
>>> </goals>
>>> </execution>
>>> </executions>
>>> <configuration>
>>> <books>
>>> <book>
>>> <directory>src/books</directory>
>>> <descriptor>src/books/test.xml</descriptor>
>>> <formats>
>>> <format>
>>> <id>xdoc</id>
>>> </format>
>>> <format>
>>> <id>pdf</id>
>>> </format>
>>> </formats>
>>> </book>
>>> </books>
>>> </configuration>
>>></plugin>
>>>
>>>
>>
>

Re: doxia book and pdf generation

2008-07-01T03:01:34Z

No, no idea when beta-1 will be released. It's been formally ready since
a while but there was some resistance because we made some API changes
which could cause backward compatibility problems. The current
maven-2.0.x core branch is running with doxia-beta-1 but it is not yet
used by the site-plugin which means it hasn't got any real-world
testing. That said, it's far more usable for me...

Cheers,
-Lukas

sandraB wrote:

> Do you have an approximative release date for the next published version ?
> Sandra
>
>
> Lukas Theussl-3 wrote:
>
>>
>>There were several issues in the book module that are fixed in the
>>(unpublished) beta-1 version of doxia, see eg [1,2,3]. I suspect at
>>least some of those are responsible for what you see but it's hard to be
>>sure with the info that you provide. You can attach a complete test
>>project to jira if you want someone to check.
>>
>>HTH,
>>-Lukas
>>
>>
>>[1] http://jira.codehaus.org/browse/DOXIA-157
>>[2] http://jira.codehaus.org/browse/DOXIA-160
>>[3] http://jira.codehaus.org/browse/DOXIA-166
>>
>>
>>sandraB wrote:
>>
>>>Hi,
>>>
>>>I'm trying to use doxia plugins to generate a pdf book and a xdoc files
>>>to
>>>generate the site, but I've got several errors :
>>>- The doxia:render-books generate xdoc files with a end-tag </document>
>>>at
>>>the end of the files but without any start-tag <document> ==> I've got a
>>>parser exception in the next step
>>>- When I generate the site (site:site and site:run), the
>>>http://localhost:8080 show website without any styles and img.
>>>- The pdf files is not formated correctly. The sections, subsections,
>>><ul>
>>>tags, <li> tags, ... have disappeared.
>>>
>>>Could you please help me to resolve these issues ?
>>>
>>>Thanks in advance
>>>Sandra
>>>
>>>Here is my pom.xml :
>>>
>>><plugin>
>>> <artifactId>maven-site-plugin</artifactId>
>>> <version>2.0-beta-6</version>
>>> <dependencies>
>>> <dependency>
>>> <groupId>org.apache.maven.doxia</groupId>
>>> <artifactId>doxia-module-docbook-simple</artifactId>
>>> <version>1.0-alpha-11</version>
>>> </dependency>
>>> </dependencies>
>>></plugin>
>>><plugin>
>>> <groupId>org.apache.maven.plugins</groupId>
>>> <artifactId>maven-compiler-plugin</artifactId>
>>> <version>2.0</version>
>>> <configuration>
>>> <source>1.4</source>
>>> <target>1.4</target>
>>> </configuration>
>>></plugin>
>>><plugin>
>>> <groupId>org.apache.maven.doxia</groupId>
>>> <artifactId>doxia-maven-plugin</artifactId>
>>> <version>1.0-alpha-11</version>
>>> <executions>
>>> <execution>
>>> <phase>pre-site</phase>
>>> <goals>
>>> <goal>render-books</goal>
>>> </goals>
>>> </execution>
>>> </executions>
>>> <configuration>
>>> <books>
>>> <book>
>>> <directory>src/books</directory>
>>> <descriptor>src/books/test.xml</descriptor>
>>> <formats>
>>> <format>
>>> <id>xdoc</id>
>>> </format>
>>> <format>
>>> <id>pdf</id>
>>> </format>
>>> </formats>
>>> </book>
>>> </books>
>>> </configuration>
>>></plugin>
>>>
>>>
>>
>

Re: Toc macro doesn't work

2008-07-01T02:52:27Z

Two remarks:

- the <h4> tag doesn't have a name attribute, it should be:

<h4>SUB SUB TITLE 1.3.1</h4> bla bla...

- the <subsection> should enclose the whole block it contains, just like
section:

<subsection name="SUB TITLE 2.3"> bla bla...
<h4>SUB SUB TITLE 2.3.1</h4>
<h4>SUB SUB TITLE 2.3.2</h4>
<h4>SUB SUB TITLE 2.3.3</h4>
</subsection>

- the above makes the indentation work for the first section. However,
there is another bug that makes subsequent sub-sections disappear from
the toc, ie in section 2 the sub-sub-sections are missing; if you add an
identical section 3, the sub-sections are missing, etc. I'll have a
look, it's probably a stupid thing to fix...

-Lukas

olivier.beyler@... wrote:

> Hello,
> The indentation of the result of toc macro doesn't work
> I create a simple example and if you look the result you can see that
> has soon the h4 tag is reach the toc doesn't indent correctly.
> Any Idea ?
> Olivier
>
> <?xml version="1.0" encoding="ISO-8859-15"?>
> <document>
> <properties>
> <author>me</author>
> <title>title</title>
> </properties>
> <body>
> <macro name="toc">
> <param name="section" value="0"/>
> </macro>
> <section name="TITLE 1">
> <subsection name="SUB TITLE 1.1">
> bla bla...
> </subsection>
> <subsection name="SUB TITLE 1.2"> bla bla...</subsection>
>
> <subsection name="SUB TITLE 1.3"> bla bla...</subsection>
>
> <h4 name= "SUB SUB TITLE 1.3.1"> bla bla</h4>
> <h4 name= "SUB SUB TITLE 1.3.2"> bla bla</h4>
> <h4 name= "SUB SUB TITLE 1.3.3"> bla bla</h4>
> <subsection name="SUB TITLE 1.4"> bla bla...</subsection>
> </section>
> <section name="TITLE 2">
> <subsection name="SUB TITLE 2.1"> bla bla... </subsection>
> <subsection name="SUB TITLE 2.2"> bla bla...</subsection>
>
> <subsection name="SUB TITLE 2.3"> bla bla...</subsection>
>
> <h4 name= "SUB SUB TITLE 2.3.1"> bla bla</h4>
> <h4 name= "SUB SUB TITLE 2.3.2"> bla bla</h4>
> <h4 name= "SUB SUB TITLE 2.3.3"> bla bla</h4>
> <subsection name="SUB TITLE 2.4"> bla bla...</subsection>
>
> </section>
>
> </body>
> </document>
>

Re: doxia book and pdf generation

2008-07-01T02:45:30Z

Do you have an approximative release date for the next published version ?
Sandra

Lukas Theussl-3 wrote:

There were several issues in the book module that are fixed in the
(unpublished) beta-1 version of doxia, see eg [1,2,3]. I suspect at
least some of those are responsible for what you see but it's hard to be
sure with the info that you provide. You can attach a complete test
project to jira if you want someone to check.

HTH,
-Lukas

[1] http://jira.codehaus.org/browse/DOXIA-157
[2] http://jira.codehaus.org/browse/DOXIA-160
[3] http://jira.codehaus.org/browse/DOXIA-166

sandraB wrote:
> Hi,
>
> I'm trying to use doxia plugins to generate a pdf book and a xdoc files to
> generate the site, but I've got several errors :
> - The doxia:render-books generate xdoc files with a end-tag </document> at
> the end of the files but without any start-tag <document> ==> I've got a
> parser exception in the next step
> - When I generate the site (site:site and site:run), the
> http://localhost:8080 show website without any styles and img.
> - The pdf files is not formated correctly. The sections, subsections, <ul>
> tags, <li> tags, ... have disappeared.
>
> Could you please help me to resolve these issues ?
>
> Thanks in advance
> Sandra
>
> Here is my pom.xml :
>
> <plugin>
> <artifactId>maven-site-plugin</artifactId>
> <version>2.0-beta-6</version>
> <dependencies>
> <dependency>
> <groupId>org.apache.maven.doxia</groupId>
> <artifactId>doxia-module-docbook-simple</artifactId>
> <version>1.0-alpha-11</version>
> </dependency>
> </dependencies>
> </plugin>
> <plugin>
> <groupId>org.apache.maven.plugins</groupId>
> <artifactId>maven-compiler-plugin</artifactId>
> <version>2.0</version>
> <configuration>
> <source>1.4</source>
> <target>1.4</target>
> </configuration>
> </plugin>
> <plugin>
> <groupId>org.apache.maven.doxia</groupId>
> <artifactId>doxia-maven-plugin</artifactId>
> <version>1.0-alpha-11</version>
> <executions>
> <execution>
> <phase>pre-site</phase>
> <goals>
> <goal>render-books</goal>
> </goals>
> </execution>
> </executions>
> <configuration>
> <books>
> <book>
> <directory>src/books</directory>
> <descriptor>src/books/test.xml</descriptor>
> <formats>
> <format>
> <id>xdoc</id>
> </format>
> <format>
> <id>pdf</id>
> </format>
> </formats>
> </book>
> </books>
> </configuration>
> </plugin>
>
>

TR: Toc macro doesn't work

2008-07-01T02:24:37Z

Hello,
The indentation of the result of toc macro doesn't work I create a
simple example and if you look the result you can see that has soon the
h4 tag is reach the toc doesn't indent correctly.
Any Idea ?
Olivier

<?xml version="1.0" encoding="ISO-8859-15"?> <document>
<properties>
<author>me</author>
<title>title</title>
</properties>
<body>
<macro name="toc">
<param name="section" value="0"/>
</macro>
<section name="TITLE 1">
<subsection name="SUB TITLE 1.1">
bla bla...
</subsection>
<subsection name="SUB TITLE 1.2"> bla bla...</subsection>

<subsection name="SUB TITLE 1.3"> bla bla...</subsection>

<h4 name= "SUB SUB TITLE 1.3.1"> bla bla</h4>
<h4 name= "SUB SUB TITLE 1.3.2"> bla bla</h4>
<h4 name= "SUB SUB TITLE 1.3.3"> bla bla</h4>
<subsection name="SUB TITLE 1.4"> bla bla...</subsection>
</section>
<section name="TITLE 2">
<subsection name="SUB TITLE 2.1"> bla bla... </subsection>
<subsection name="SUB TITLE 2.2"> bla bla...</subsection>

<subsection name="SUB TITLE 2.3"> bla bla...</subsection>

<h4 name= "SUB SUB TITLE 2.3.1"> bla bla</h4>
<h4 name= "SUB SUB TITLE 2.3.2"> bla bla</h4>
<h4 name= "SUB SUB TITLE 2.3.3"> bla bla</h4>
<subsection name="SUB TITLE 2.4"> bla bla...</subsection>

</section>

</body>
</document>

Re: doxia book and pdf generation

2008-07-01T02:21:28Z

There were several issues in the book module that are fixed in the
(unpublished) beta-1 version of doxia, see eg [1,2,3]. I suspect at
least some of those are responsible for what you see but it's hard to be
sure with the info that you provide. You can attach a complete test
project to jira if you want someone to check.

HTH,
-Lukas

[1] http://jira.codehaus.org/browse/DOXIA-157
[2] http://jira.codehaus.org/browse/DOXIA-160
[3] http://jira.codehaus.org/browse/DOXIA-166

sandraB wrote:

> Hi,
>
> I'm trying to use doxia plugins to generate a pdf book and a xdoc files to
> generate the site, but I've got several errors :
> - The doxia:render-books generate xdoc files with a end-tag </document> at
> the end of the files but without any start-tag <document> ==> I've got a
> parser exception in the next step
> - When I generate the site (site:site and site:run), the
> http://localhost:8080 show website without any styles and img.
> - The pdf files is not formated correctly. The sections, subsections, <ul>
> tags, <li> tags, ... have disappeared.
>
> Could you please help me to resolve these issues ?
>
> Thanks in advance
> Sandra
>
> Here is my pom.xml :
>
> <plugin>
> <artifactId>maven-site-plugin</artifactId>
> <version>2.0-beta-6</version>
> <dependencies>
> <dependency>
> <groupId>org.apache.maven.doxia</groupId>
> <artifactId>doxia-module-docbook-simple</artifactId>
> <version>1.0-alpha-11</version>
> </dependency>
> </dependencies>
> </plugin>
> <plugin>
> <groupId>org.apache.maven.plugins</groupId>
> <artifactId>maven-compiler-plugin</artifactId>
> <version>2.0</version>
> <configuration>
> <source>1.4</source>
> <target>1.4</target>
> </configuration>
> </plugin>
> <plugin>
> <groupId>org.apache.maven.doxia</groupId>
> <artifactId>doxia-maven-plugin</artifactId>
> <version>1.0-alpha-11</version>
> <executions>
> <execution>
> <phase>pre-site</phase>
> <goals>
> <goal>render-books</goal>
> </goals>
> </execution>
> </executions>
> <configuration>
> <books>
> <book>
> <directory>src/books</directory>
> <descriptor>src/books/test.xml</descriptor>
> <formats>
> <format>
> <id>xdoc</id>
> </format>
> <format>
> <id>pdf</id>
> </format>
> </formats>
> </book>
> </books>
> </configuration>
> </plugin>
>
>

Toc macro doesn't work

2008-07-01T02:13:20Z

Hello,
The indentation of the result of toc macro doesn't work
I create a simple example and if you look the result you can see that
has soon the h4 tag is reach the toc doesn't indent correctly.
Any Idea ?
Olivier

<?xml version="1.0" encoding="ISO-8859-15"?>
<document>
<properties>
<author>me</author>
<title>title</title>
</properties>
<body>
<macro name="toc">
<param name="section" value="0"/>
</macro>
<section name="TITLE 1">
<subsection name="SUB TITLE 1.1">
bla bla...
</subsection>
<subsection name="SUB TITLE 1.2"> bla bla...</subsection>

<subsection name="SUB TITLE 1.3"> bla bla...</subsection>

<h4 name= "SUB SUB TITLE 1.3.1"> bla bla</h4>
<h4 name= "SUB SUB TITLE 1.3.2"> bla bla</h4>
<h4 name= "SUB SUB TITLE 1.3.3"> bla bla</h4>
<subsection name="SUB TITLE 1.4"> bla bla...</subsection>
</section>
<section name="TITLE 2">
<subsection name="SUB TITLE 2.1"> bla bla... </subsection>
<subsection name="SUB TITLE 2.2"> bla bla...</subsection>

<subsection name="SUB TITLE 2.3"> bla bla...</subsection>

<h4 name= "SUB SUB TITLE 2.3.1"> bla bla</h4>
<h4 name= "SUB SUB TITLE 2.3.2"> bla bla</h4>
<h4 name= "SUB SUB TITLE 2.3.3"> bla bla</h4>
<subsection name="SUB TITLE 2.4"> bla bla...</subsection>

</section>

</body>
</document>

doxia book and pdf generation

2008-06-30T08:47:01Z

Hi,

I'm trying to use doxia plugins to generate a pdf book and a xdoc files to generate the site, but I've got several errors :
- The doxia:render-books generate xdoc files with a end-tag </document> at the end of the files but without any start-tag <document> ==> I've got a parser exception in the next step
- When I generate the site (site:site and site:run), the http://localhost:8080 show website without any styles and img.
- The pdf files is not formated correctly. The sections, subsections, <ul> tags, <li> tags, ... have disappeared.

Could you please help me to resolve these issues ?

Thanks in advance
Sandra

Here is my pom.xml :

<plugin>
<artifactId>maven-site-plugin</artifactId>
<version>2.0-beta-6</version>
<dependencies>
<dependency>
<groupId>org.apache.maven.doxia</groupId>
<artifactId>doxia-module-docbook-simple</artifactId>
<version>1.0-alpha-11</version>
</dependency>
</dependencies>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>2.0</version>
<configuration>
<source>1.4</source>
<target>1.4</target>
</configuration>
</plugin>
<plugin>
<groupId>org.apache.maven.doxia</groupId>
<artifactId>doxia-maven-plugin</artifactId>
<version>1.0-alpha-11</version>
<executions>
<execution>
<phase>pre-site</phase>
<goals>
<goal>render-books</goal>
</goals>
</execution>
</executions>
<configuration>
<books>
<book>
<directory>src/books</directory>
<descriptor>src/books/test.xml</descriptor>
<formats>
<format>
<id>xdoc</id>
</format>
<format>
<id>pdf</id>
</format>
</formats>
</book>
</books>
</configuration>
</plugin>

Re: RE : Snippet with file

2008-06-26T04:28:01Z

https://svn.apache.org/repos/asf/maven/doxia/doxia/tags/doxia-1.0-alpha-11/

2008/6/26 <olivier.beyler@...>:

> Do you know where I can find the source code of this macro to help me
> understand what's wrong ?
>
> Olivier Beyler
> FT/RD/MAPS/AMS/SUME
> Ingénieur Architecte
> tél. 04 76 76 45 52
> olivier.beyler@...
>
>
>
> -------- Message d'origine--------
> De: Lammert Westerhoff [mailto:westerhoff@... <westerhoff@...>
> ]
> Date: mer. 6/25/2008 10:50
> À: doxia-users@...
> Objet : Re: Snippet with file
>
> It is indeed normal that you don't see the contents of the file. The macro
> is searching for a line in the file that contains the Strings "START",
> "SNIPPET" and "sommaire" (your specified id). This is where the snippet
> will
> start. It also searching for a similar line but END instead of START. I'm
> not 100% sure about the exact Strings. You can look into the source code of
> the snippet macro in order to see the code that searches for the start of
> the snippet.
>
> 2008/6/25 <olivier.beyler@...>:
>
> > Thanks again to every one
> > I try and on command ligne it's work better
> > With <param name="file" value="src/site/xdoc/MU_32_sommaire.fr.xml"/>
> > There is no exception but I've only a square like if I have a
> > <source></source> and not the content of the file is it normal ?
> >
> >
> > -----Message d'origine-----
> > De : Vincent Siveton [mailto:vincent.siveton@...<vincent.siveton@...>
> ]
> > Envoyé : mercredi 25 juin 2008 19:22
> > À : doxia-users@...
> > Objet : Re: Snippet with file
> >
> > 2008/6/25 <olivier.beyler@...>:
> > > It's absolutly not situated into NetBeans tree.
> > >
> > > I think inside the plugin the project dir is overloaded by the maven
> > > directory. this is for this reason that it doesn't find the file.
> > > Maven is embeded into Netbeans
> >
> > Did you try directly in the command line?
> >
> > Vincent
> >
> > > With <param name="file" value="src/site/xdoc/MU_32_sommaire.fr.xml"/>
> > > I obtain
> > > Caused by: java.io.FileNotFoundException: C:\Program Files\NetBeans
> > > 6.1\src\site\xdoc\MU_32_sommaire.fr.xml (Le chemin d'accès spécifié est
> > introuvable) Unfortunatly the file is located :
> > > C:\projet\OdisSite\src\site\xdoc\MU_32_sommaire.fr.xml
> > >
> > >
> > >
> > > -----Message d'origine-----
> > > De : Lukas Theussl [mailto:ltheussl@... <ltheussl@...>]
> Envoyé : mercredi 25
> > > juin 2008 18:59 À : doxia-users@... Objet : Re: Snippet
> > > with file
> > >
> > > The exception in your first mail said
> > >
> > > java.io.FileNotFoundException: C:\Program Files\NetBeans
> > > 6.1\MU_32_sommaire.fr.xml
> > >
> > > so check where the file is located inside your netbeans dir and adjust
> > the relative path accordingly.
> > >
> > > HTH,
> > > -Lukas
> > >
> > >
> > > olivier.beyler@... wrote:
> > >> Thanks, but I try both without success :-( If I put the full path
> > >> <param name="file"
> > >> value="C:\projet\OdisSite\src\site\xdoc/MU_32_sommaire.fr.xml"/>
> > >> It works
> > >> OdisSite is the name of the project and where is located the pom.xml
> > file.
> > >> As we use several computer the full path can't be use at the end.
> > >> (some are on linux, windows...)
> > >>
> > >> The main idea is to try to separate a big file MU_32.xml into several
> > file witch would be assembly by the macro.
> > >>
> > >>
> > >>
> > >>
> > >> -----Message d'origine-----
> > >> De : Lukas Theussl [mailto:ltheussl@... <ltheussl@...>]
> Envoyé : mercredi 25
> > >> juin 2008 18:32 À : doxia-users@... Objet : Re: Snippet
> > >> with file
> > >>
> > >> try
> > >>
> > >> <param name="file" value="src/site/xdoc/MU_32_sommaire.fr.xml"/>
> > >>
> > >> or
> > >>
> > >> <param name="file"
> > >> value="projet/src/site/xdoc/MU_32_sommaire.fr.xml"/>
> > >>
> > >> (not sure about your project structure, I don't know what the three
> > >> dots
> > >> mean...)
> > >>
> > >> HTH,
> > >> -Lukas
> > >>
> > >>
> > >> olivier.beyler@... wrote:
> > >>
> > >>> <macro name="snippet">
> > >>> <param name="id" value="sommaire"/>
> > >>> <param name="file" value="MU_32_sommaire.fr.xml"/>
> > >>> </macro>
> > >>>
> > >>>
> > >>> the MU_32_sommaire.fr.xml is locate into ...\projet\src\site\xdoc
> > >>>
> > >>>If I do that I obtain :
> > >>>Caused by: java.io.FileNotFoundException: C:\Program Files\NetBeans
> > 6.1\MU_32_sommaire.fr.xml (Le fichier spécifié est introuvable)
> > >>> at java.io.FileInputStream.open(Native Method)
> > >>> at java.io.FileInputStream.<init>(FileInputStream.java:106)
> > >>> at java.io.FileInputStream.<init>(FileInputStream.java:66)
> > >>> at
> >
> sun.net.www.protocol.file.FileURLConnection.connect(FileURLConnection.java:70)
> > >>> at
> >
> sun.net.www.protocol.file.FileURLConnection.getInputStream(FileURLConnection.java:161)
> > >>> at java.net.URL.openStream(URL.java:1007)
> > >>> at
> >
> org.apache.maven.doxia.macro.snippet.SnippetReader.readLines(SnippetReader.java:118)
> > >>> at
> >
> org.apache.maven.doxia.macro.snippet.SnippetReader.readSnippet(SnippetReader.java:59)
> > >>> at
> >
> org.apache.maven.doxia.macro.snippet.SnippetMacro.getSnippet(SnippetMacro.java:150)
> > >>> at
> >
> org.apache.maven.doxia.macro.snippet.SnippetMacro.execute(SnippetMacro.java:110)
> > >>> ... 26 more
> > >>>
> > >>>Have you got any idea ? I don't want to put the absolute path to the
> > >>>file as every one into the team has different path
> > >>>
> > >>>
> > >>
> > >>
> > >>
> > >
> >
>
>
>
> --
> Lammert Westerhoff
> westerhoff@...
>
>
>
>

--
Lammert Westerhoff
westerhoff@...

RE: RE : Snippet with file

2008-06-26T02:56:03Z

Thanks
If I well understand there is will no the good way to do what I want.
I've got a very bug xdoc file with many section and subsection. So in my mind I believed that if I use snippet macro I can put each section into separate file and have a root document witch include the other by using snippet.
But when I do that the XML of each separate file is seen like "source".
So , may i need to find an other way than snippet macro

-----Message d'origine-----
De : Lukas Theussl [mailto:ltheussl@...]
Envoyé : jeudi 26 juin 2008 11:32
À : doxia-users@...
Objet : Re: RE : Snippet with file

The snippet source code is at [1] but I don't think that this will help you more than what is documented on the doxia site [2]. In your case you need the lines


... snippet to include ...


inside MU_32_sommaire.fr.xml.

HTH,
-Lukas

[1]
https://svn.apache.org/repos/asf/maven/doxia/doxia/tags/doxia-1.0-alpha-11/doxia-core/src/main/java/org/apache/maven/doxia/macro/snippet/
[2] http://maven.apache.org/doxia/macros/index.html

olivier.beyler@... wrote:

> Do you know where I can find the source code of this macro to help me understand what's wrong ?
>
> Olivier Beyler
> FT/RD/MAPS/AMS/SUME
> Ingénieur Architecte
> tél. 04 76 76 45 52
> olivier.beyler@...
>
>
>
> -------- Message d'origine--------
> De: Lammert Westerhoff [mailto:westerhoff@...]
> Date: mer. 6/25/2008 10:50
> À: doxia-users@...
> Objet : Re: Snippet with file
>
> It is indeed normal that you don't see the contents of the file. The macro
> is searching for a line in the file that contains the Strings "START",
> "SNIPPET" and "sommaire" (your specified id). This is where the snippet will
> start. It also searching for a similar line but END instead of START. I'm
> not 100% sure about the exact Strings. You can look into the source code of
> the snippet macro in order to see the code that searches for the start of
> the snippet.
>
> 2008/6/25 <olivier.beyler@...>:
>
>
>>Thanks again to every one
>>I try and on command ligne it's work better
>>With <param name="file" value="src/site/xdoc/MU_32_sommaire.fr.xml"/>
>>There is no exception but I've only a square like if I have a
>><source></source> and not the content of the file is it normal ?
>>
>>
>>-----Message d'origine-----
>>De : Vincent Siveton [mailto:vincent.siveton@...]
>>Envoyé : mercredi 25 juin 2008 19:22
>>À : doxia-users@...
>>Objet : Re: Snippet with file
>>
>>2008/6/25 <olivier.beyler@...>:
>>
>>>It's absolutly not situated into NetBeans tree.
>>>
>>>I think inside the plugin the project dir is overloaded by the maven
>>>directory. this is for this reason that it doesn't find the file.
>>>Maven is embeded into Netbeans
>>
>>Did you try directly in the command line?
>>
>>Vincent
>>
>>
>>>With <param name="file" value="src/site/xdoc/MU_32_sommaire.fr.xml"/>
>>>I obtain
>>>Caused by: java.io.FileNotFoundException: C:\Program Files\NetBeans
>>>6.1\src\site\xdoc\MU_32_sommaire.fr.xml (Le chemin d'accès spécifié est
>>
>>introuvable) Unfortunatly the file is located :
>>
>>>C:\projet\OdisSite\src\site\xdoc\MU_32_sommaire.fr.xml
>>>
>>>
>>>
>>>-----Message d'origine-----
>>>De : Lukas Theussl [mailto:ltheussl@...] Envoyé : mercredi 25
>>>juin 2008 18:59 À : doxia-users@... Objet : Re: Snippet
>>>with file
>>>
>>>The exception in your first mail said
>>>
>>>java.io.FileNotFoundException: C:\Program Files\NetBeans
>>>6.1\MU_32_sommaire.fr.xml
>>>
>>>so check where the file is located inside your netbeans dir and adjust
>>
>>the relative path accordingly.
>>
>>>HTH,
>>>-Lukas
>>>
>>>
>>>olivier.beyler@... wrote:
>>>
>>>>Thanks, but I try both without success :-( If I put the full path
>>>><param name="file"
>>>>value="C:\projet\OdisSite\src\site\xdoc/MU_32_sommaire.fr.xml"/>
>>>>It works
>>>>OdisSite is the name of the project and where is located the pom.xml
>>
>>file.
>>
>>>>As we use several computer the full path can't be use at the end.
>>>>(some are on linux, windows...)
>>>>
>>>>The main idea is to try to separate a big file MU_32.xml into several
>>
>>file witch would be assembly by the macro.
>>
>>>>
>>>>
>>>>
>>>>-----Message d'origine-----
>>>>De : Lukas Theussl [mailto:ltheussl@...] Envoyé : mercredi 25
>>>>juin 2008 18:32 À : doxia-users@... Objet : Re: Snippet
>>>>with file
>>>>
>>>>try
>>>>
>>>><param name="file" value="src/site/xdoc/MU_32_sommaire.fr.xml"/>
>>>>
>>>>or
>>>>
>>>><param name="file"
>>>>value="projet/src/site/xdoc/MU_32_sommaire.fr.xml"/>
>>>>
>>>>(not sure about your project structure, I don't know what the three
>>>>dots
>>>>mean...)
>>>>
>>>>HTH,
>>>>-Lukas
>>>>
>>>>
>>>>olivier.beyler@... wrote:
>>>>
>>>>
>>>>> <macro name="snippet">
>>>>> <param name="id" value="sommaire"/>
>>>>> <param name="file" value="MU_32_sommaire.fr.xml"/>
>>>>> </macro>
>>>>>
>>>>>
>>>>>the MU_32_sommaire.fr.xml is locate into ...\projet\src\site\xdoc
>>>>>
>>>>>If I do that I obtain :
>>>>>Caused by: java.io.FileNotFoundException: C:\Program Files\NetBeans
>>
>>6.1\MU_32_sommaire.fr.xml (Le fichier spécifié est introuvable)
>>
>>>>> at java.io.FileInputStream.open(Native Method)
>>>>> at java.io.FileInputStream.<init>(FileInputStream.java:106)
>>>>> at java.io.FileInputStream.<init>(FileInputStream.java:66)
>>>>> at
>>
>>sun.net.www.protocol.file.FileURLConnection.connect(FileURLConnection.java:70)
>>
>>>>> at
>>
>>sun.net.www.protocol.file.FileURLConnection.getInputStream(FileURLConnection.java:161)
>>
>>>>> at java.net.URL.openStream(URL.java:1007)
>>>>> at
>>
>>org.apache.maven.doxia.macro.snippet.SnippetReader.readLines(SnippetReader.java:118)
>>
>>>>> at
>>
>>org.apache.maven.doxia.macro.snippet.SnippetReader.readSnippet(SnippetReader.java:59)
>>
>>>>> at
>>
>>org.apache.maven.doxia.macro.snippet.SnippetMacro.getSnippet(SnippetMacro.java:150)
>>
>>>>> at
>>
>>org.apache.maven.doxia.macro.snippet.SnippetMacro.execute(SnippetMacro.java:110)
>>
>>>>> ... 26 more
>>>>>
>>>>>Have you got any idea ? I don't want to put the absolute path to the
>>>>>file as every one into the team has different path
>>>>>
>>>>>
>>>>
>>>>
>>>>
>
>
>