doxia - xdoc - copyright and other tags

[Bernhard Grünewaldt]

Hello,

I am using doxia together with the xdoc format.
The page generated with it, can be viewed here:
http://nanji.sourceforge.net/

The src/site and pom.xml can be found here:
http://nanji.svn.sourceforge.net/viewvc/nanji/nanji-documentation/trunk/

I want to achieve some things I can just not find in the documentation.
 - How can I add content to the "footer"->"xright" div-container?
 - How can I add content to the "breadcrumbs"->"xright" div-container?

I have seen that the commons math team did it here:
http://commons.apache.org/math/developers.html

I checked out the code, but just can't find where they added the content
for these containers.

I would be very thankful if somebody could help me with that :)

regards,

Bernhard

[Lukas Theussl-4]

This is done by the site plugin and can be configured in your site.xml [1][2].

HTH,
-Lukas


[1] http://maven.apache.org/guides/mini/guide-site.html
[2]
http://maven.apache.org/doxia/doxia-sitetools-1.0.x/doxia-decoration-model/decoration.html



Bernhard Grünewaldt wrote:

> Hello,
>
> I am using doxia together with the xdoc format.
> The page generated with it, can be viewed here:
> http://nanji.sourceforge.net/
>
> The src/site and pom.xml can be found here:
> http://nanji.svn.sourceforge.net/viewvc/nanji/nanji-documentation/trunk/
>
> I want to achieve some things I can just not find in the documentation.
>  - How can I add content to the "footer"->"xright" div-container?
>  - How can I add content to the "breadcrumbs"->"xright" div-container?
>
> I have seen that the commons math team did it here:
> http://commons.apache.org/math/developers.html
>
> I checked out the code, but just can't find where they added the content
> for these containers.
>
> I would be very thankful if somebody could help me with that :)
>
> regards,
>
> Bernhard
>

[Bernhard Grünewaldt]

thank you very much :)


Lukas Theussl schrieb:

>
> This is done by the site plugin and can be configured in your site.xml
> [1][2].
>
> HTH,
> -Lukas
>
>
> [1] http://maven.apache.org/guides/mini/guide-site.html
> [2]
> http://maven.apache.org/doxia/doxia-sitetools-1.0.x/doxia-decoration-model/decoration.html
>
>
>
>
> Bernhard Grünewaldt wrote:
>> Hello,
>>
>> I am using doxia together with the xdoc format.
>> The page generated with it, can be viewed here:
>> http://nanji.sourceforge.net/
>>
>> The src/site and pom.xml can be found here:
>> http://nanji.svn.sourceforge.net/viewvc/nanji/nanji-documentation/trunk/
>>
>> I want to achieve some things I can just not find in the documentation.
>>  - How can I add content to the "footer"->"xright" div-container?
>>  - How can I add content to the "breadcrumbs"->"xright" div-container?
>>
>> I have seen that the commons math team did it here:
>> http://commons.apache.org/math/developers.html
>>
>> I checked out the code, but just can't find where they added the content
>> for these containers.
>>
>> I would be very thankful if somebody could help me with that :)
>>
>> regards,
>>
>> Bernhard
>>
>

[Bernhard Grünewaldt]

Hello,

I have one other big question.

How can I generate a multi project setup, so that
every project uses the same css and images and builds as one website.

My Projects for example are:

+nanji-documentation
+--nanji-core
+--nanji-javafx

Where nanji-documentation should be the parent
and all other projects should be children.

Then the sites generated by mvn site should
look like this:

/ --> contents of nanji-documenation
/images/
/css/
/nanji-core/ --> contents of nanji-core
/nanji-javafx/ --> contents of nanji-javafx

Is that somehow possible?
Can you give examples of an opensource project that uses that kind of
structure?

regards,

Bernhard

[Lukas Theussl-4]

just run 'mvn site' in your parent project.

Your questions are really about using the site plugin, you will probably get more
extensive help (if needed) on the maven user list (users@...).

-Lukas


Bernhard Grünewaldt wrote:

> Hello,
>
> I have one other big question.
>
> How can I generate a multi project setup, so that
> every project uses the same css and images and builds as one website.
>
> My Projects for example are:
>
> +nanji-documentation
> +--nanji-core
> +--nanji-javafx
>
> Where nanji-documentation should be the parent
> and all other projects should be children.
>
> Then the sites generated by mvn site should
> look like this:
>
> / --> contents of nanji-documenation
> /images/
> /css/
> /nanji-core/ --> contents of nanji-core
> /nanji-javafx/ --> contents of nanji-javafx
>
> Is that somehow possible?
> Can you give examples of an opensource project that uses that kind of
> structure?
>
> regards,
>
> Bernhard
>

[Bernhard Grünewaldt]

Hello,

I am using Doxia and the Xdoc format together with maven-site-plugin
2.0-beta-7.

When I add "style" or "class" attributes to an <img> or <p> tag it gets
removed on the rendered site.

Here is mentioned that it is a valid attribute:
http://maven.apache.org/doxia/doxia/doxia-modules/doxia-module-xdoc/xsddoc/http___maven.apache.org_XDOC_2.0/element/img.html#attr_style

So why does it get removed?

And the <table> <td> tags still don't know the cellpadding attribute.
Is there a way to use another version of maven-site-plugin where that
works, too?

If maven-site-plugin doesn't work, can I use a standalone version of
doxia, that does the same as maven-site-plugin? And if yes, can you tell
me how?

thx

Bernhard

[Lukas Theussl-4]

site-plugin-2.0 uses doxia 1.0, your link points to the docs for doxia-1.1. You
can try site-plugin-2.1-SNAPSHOT, see if that helps, otherwise please file an
issue [1] with a reproducible test case.

Thanks,
-Lukas

[1] http://jira.codehaus.org/browse/DOXIA


Bernhard Grünewaldt wrote:

> Hello,
>
> I am using Doxia and the Xdoc format together with maven-site-plugin
> 2.0-beta-7.
>
> When I add "style" or "class" attributes to an <img> or <p> tag it gets
> removed on the rendered site.
>
> Here is mentioned that it is a valid attribute:
> http://maven.apache.org/doxia/doxia/doxia-modules/doxia-module-xdoc/xsddoc/http___maven.apache.org_XDOC_2.0/element/img.html#attr_style
>
> So why does it get removed?
>
> And the <table> <td> tags still don't know the cellpadding attribute.
> Is there a way to use another version of maven-site-plugin where that
> works, too?
>
> If maven-site-plugin doesn't work, can I use a standalone version of
> doxia, that does the same as maven-site-plugin? And if yes, can you tell
> me how?
>
> thx
>
> Bernhard
>

[Bernhard Grünewaldt]

Hello Lukas,

Thanks for the hint.

Now it works. For everyone else who has the same problem, here is the
solution for your pom.xml (You will need maven 2.1 installed!)

....
<pluginRepositories>
  <pluginRepository>
    <id>apache.snapshots</id>
    <url>http://repository.apache.org/snapshots</url>
    <releases>
      <enabled>false</enabled>
     </releases>
  </pluginRepository>
</pluginRepositories>
<build>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-site-plugin</artifactId>
      <!--  With 2.1 cellpadding for tables, and setting of -->
      <!-- class and style attributes work. -->
      <version>2.1-SNAPSHOT</version>
      <configuration>
      <!--  WITHOUT THAT, UTF-8 chars are not displayed! -->
        <outputEncoding>UTF-8</outputEncoding>
      </configuration>
    </plugin>
  </plugins>
</build>
....

thanks,

Bernhard Grünewaldt

Lukas Theussl schrieb:

>
> site-plugin-2.0 uses doxia 1.0, your link points to the docs for
> doxia-1.1. You can try site-plugin-2.1-SNAPSHOT, see if that helps,
> otherwise please file an issue [1] with a reproducible test case.
>
> Thanks,
> -Lukas
>
> [1] http://jira.codehaus.org/browse/DOXIA
>
>
> Bernhard Grünewaldt wrote:
>> Hello,
>>
>> I am using Doxia and the Xdoc format together with maven-site-plugin
>> 2.0-beta-7.
>>
>> When I add "style" or "class" attributes to an <img> or <p> tag it gets
>> removed on the rendered site.
>>
>> Here is mentioned that it is a valid attribute:
>> http://maven.apache.org/doxia/doxia/doxia-modules/doxia-module-xdoc/xsddoc/http___maven.apache.org_XDOC_2.0/element/img.html#attr_style
>>
>>
>> So why does it get removed?
>>
>> And the <table> <td> tags still don't know the cellpadding attribute.
>> Is there a way to use another version of maven-site-plugin where that
>> works, too?
>>
>> If maven-site-plugin doesn't work, can I use a standalone version of
>> doxia, that does the same as maven-site-plugin? And if yes, can you tell
>> me how?
>>
>> thx
>>
>> Bernhard
>>
>

[Lukas Theussl-4]

Excellent, thanks for the confirmation! Some people still seem to be sceptical
about site-plugin-2.1 and doxia-1.1, so I welcome every positive feedback. :)

cheers,
-Lukas


Bernhard Grünewaldt wrote:

> Hello Lukas,
>
> Thanks for the hint.
>
> Now it works. For everyone else who has the same problem, here is the
> solution for your pom.xml (You will need maven 2.1 installed!)
>
> ....
> <pluginRepositories>
>   <pluginRepository>
>     <id>apache.snapshots</id>
>     <url>http://repository.apache.org/snapshots</url>
>     <releases>
>       <enabled>false</enabled>
>      </releases>
>   </pluginRepository>
> </pluginRepositories>
> <build>
>   <plugins>
>     <plugin>
>       <groupId>org.apache.maven.plugins</groupId>
>       <artifactId>maven-site-plugin</artifactId>
>       <!--  With 2.1 cellpadding for tables, and setting of -->
>       <!-- class and style attributes work. -->
>       <version>2.1-SNAPSHOT</version>
>       <configuration>
>       <!--  WITHOUT THAT, UTF-8 chars are not displayed! -->
>         <outputEncoding>UTF-8</outputEncoding>
>       </configuration>
>     </plugin>
>   </plugins>
> </build>
> ....
>
> thanks,
>
> Bernhard Grünewaldt
>
> Lukas Theussl schrieb:
>> site-plugin-2.0 uses doxia 1.0, your link points to the docs for
>> doxia-1.1. You can try site-plugin-2.1-SNAPSHOT, see if that helps,
>> otherwise please file an issue [1] with a reproducible test case.
>>
>> Thanks,
>> -Lukas
>>
>> [1] http://jira.codehaus.org/browse/DOXIA
>>
>>
>> Bernhard Grünewaldt wrote:
>>> Hello,
>>>
>>> I am using Doxia and the Xdoc format together with maven-site-plugin
>>> 2.0-beta-7.
>>>
>>> When I add "style" or "class" attributes to an <img> or <p> tag it gets
>>> removed on the rendered site.
>>>
>>> Here is mentioned that it is a valid attribute:
>>> http://maven.apache.org/doxia/doxia/doxia-modules/doxia-module-xdoc/xsddoc/http___maven.apache.org_XDOC_2.0/element/img.html#attr_style
>>>
>>>
>>> So why does it get removed?
>>>
>>> And the <table> <td> tags still don't know the cellpadding attribute.
>>> Is there a way to use another version of maven-site-plugin where that
>>> works, too?
>>>
>>> If maven-site-plugin doesn't work, can I use a standalone version of
>>> doxia, that does the same as maven-site-plugin? And if yes, can you tell
>>> me how?
>>>
>>> thx
>>>
>>> Bernhard
>>>
>

[Bernhard Grünewaldt]

Hi,

It is working very well.
Since I am going to use xhtml to its extend I will send you feedback if
I run into problems. But for now everything I complained about works.

thank you very much for your help :)

Bernhard

Lukas Theussl schrieb:

>
> Excellent, thanks for the confirmation! Some people still seem to be
> sceptical about site-plugin-2.1 and doxia-1.1, so I welcome every
> positive feedback. :)
>
> cheers,
> -Lukas
>
>
> Bernhard Grünewaldt wrote:
>> Hello Lukas,
>>
>> Thanks for the hint.
>>
>> Now it works. For everyone else who has the same problem, here is the
>> solution for your pom.xml (You will need maven 2.1 installed!)
>>
>> ....
>> <pluginRepositories>
>>   <pluginRepository>
>>     <id>apache.snapshots</id>
>>     <url>http://repository.apache.org/snapshots</url>
>>     <releases>
>>       <enabled>false</enabled>
>>      </releases>
>>   </pluginRepository>
>> </pluginRepositories>
>> <build>
>>   <plugins>
>>     <plugin>
>>       <groupId>org.apache.maven.plugins</groupId>
>>       <artifactId>maven-site-plugin</artifactId>
>>       <!--  With 2.1 cellpadding for tables, and setting of -->
>>       <!-- class and style attributes work. -->
>>       <version>2.1-SNAPSHOT</version>
>>       <configuration>
>>       <!--  WITHOUT THAT, UTF-8 chars are not displayed! -->
>>         <outputEncoding>UTF-8</outputEncoding>
>>       </configuration>
>>     </plugin>
>>   </plugins>
>> </build>
>> ....
>>
>> thanks,
>>
>> Bernhard Grünewaldt
>>
>> Lukas Theussl schrieb:
>>> site-plugin-2.0 uses doxia 1.0, your link points to the docs for
>>> doxia-1.1. You can try site-plugin-2.1-SNAPSHOT, see if that helps,
>>> otherwise please file an issue [1] with a reproducible test case.
>>>
>>> Thanks,
>>> -Lukas
>>>
>>> [1] http://jira.codehaus.org/browse/DOXIA
>>>
>>>
>>> Bernhard Grünewaldt wrote:
>>>> Hello,
>>>>
>>>> I am using Doxia and the Xdoc format together with maven-site-plugin
>>>> 2.0-beta-7.
>>>>
>>>> When I add "style" or "class" attributes to an <img> or <p> tag it gets
>>>> removed on the rendered site.
>>>>
>>>> Here is mentioned that it is a valid attribute:
>>>> http://maven.apache.org/doxia/doxia/doxia-modules/doxia-module-xdoc/xsddoc/http___maven.apache.org_XDOC_2.0/element/img.html#attr_style
>>>>
>>>>
>>>>
>>>> So why does it get removed?
>>>>
>>>> And the <table> <td> tags still don't know the cellpadding attribute.
>>>> Is there a way to use another version of maven-site-plugin where that
>>>> works, too?
>>>>
>>>> If maven-site-plugin doesn't work, can I use a standalone version of
>>>> doxia, that does the same as maven-site-plugin? And if yes, can you
>>>> tell
>>>> me how?
>>>>
>>>> thx
>>>>
>>>> Bernhard
>>>>
>>
>