You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@maven.apache.org by Paul Spencer <pa...@apache.org> on 2008/11/21 23:28:34 UTC
[doxia-maven-plugin] How to get images from book's apt directory
into site?
I am working with doxia-maven-plugin 1.0-alpha-11. One of my apt files
contains a figure, as defined by [myImage.png]. Per the
documentation[1], the image file for the figure is in the same directory
as the apt file, src/books/user-guide/apt. "mvn site" generated the
pages for the book, including the <img src="myImage.png" /> tag to
include the image. Although I have followed the "Configuring Maven
Doxia Plug-in" example [2] with the exception if setting the plugin
version to 1.0-alpha-11 and using only the xdoc format, the image file
is not in the same directory as the generated html. Suggestions?
Paul Spencer
[1] http://maven.apache.org/doxia/references/apt-format.html
[2] http://maven.apache.org/doxia/book/index.html
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org
Re: [doxia-maven-plugin] How to get images from book's apt directory into site?
Posted by "Walid \"jo\" Gedeon" <wg...@gmail.com>.
Hello Paul,
I had the same situation a while ago, I found that including the full name
(with extension) works better.
HTH,
w
On Fri, Nov 21, 2008 at 11:28 PM, Paul Spencer <pa...@apache.org> wrote:
> I am working with doxia-maven-plugin 1.0-alpha-11. One of my apt files
> contains a figure, as defined by [myImage.png]. Per the documentation[1],
> the image file for the figure is in the same directory as the apt file,
> src/books/user-guide/apt. "mvn site" generated the pages for the book,
> including the <img src="myImage.png" /> tag to include the image. Although
> I have followed the "Configuring Maven Doxia Plug-in" example [2] with the
> exception if setting the plugin version to 1.0-alpha-11 and using only the
> xdoc format, the image file is not in the same directory as the generated
> html. Suggestions?
>
> Paul Spencer
>
> [1] http://maven.apache.org/doxia/references/apt-format.html
> [2] http://maven.apache.org/doxia/book/index.html
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
>
>
Re: [doxia-maven-plugin] How to get images from book's apt directory
into site?
Posted by Paul Spencer <pa...@apache.org>.
I have it working for xdoc generation. Below is a fragment from pom.xml.
<plugins>
<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/user-guide</directory>
<descriptor>src/books/user-guide/book.xml</descriptor>
<formats>
<format>
<id>xdoc</id>
</format>
</formats>
</book>
</books>
</configuration>
</plugin>
<plugin>
<artifactId>maven-antrun-plugin</artifactId>
<executions>
<execution>
<phase>pre-site</phase>
<goals>
<goal>run</goal>
</goals>
<configuration>
<tasks>
<copy todir="target/site/user-guide/images">
<fileset dir="src/books/user-guide/apt/images"/>
</copy>
</tasks>
</configuration>
</execution>
</executions>
</plugin>
Sean Hennessy wrote:
> Hi Paul,
>
> # try placing images relative to {basedir}/src/site/resources
> # maven-antrun-plugin <phase>pre-site</phase>
> # is good time to render other formats like docbook
> # and copy images from your source tree to appropriate resources folder.
> # for example;
> # in {basedir}/src/site/apt/index.apt using the following image reference.
> [ 1.doc/images/labbenchmap.jpg ] Lab Office 65 layout
> # and the corresponding image located here.
> {basedir}/src/site/resources/1.doc/images/labbenchmap.jpg
> # after call to mvn -X -e site -o >mvn_site.log
> # results are found {basedir}/target/site/1.doc/images/
>
> given your {basedir}/src/books/user-guide/apt
> I would think {basedir}/src/resources/books/user-guide/myImage.png likely place.
>
> Regards,
> Sean
>
>
> -----Original Message-----
> From: Paul Spencer [mailto:paulsp@apache.org]
> Sent: Friday, November 21, 2008 2:29 PM
> To: Maven Users List
> Subject: [doxia-maven-plugin] How to get images from book's apt directory into site?
>
>
> I am working with doxia-maven-plugin 1.0-alpha-11. One of my apt files
> contains a figure, as defined by [myImage.png]. Per the
> documentation[1], the image file for the figure is in the same directory
> as the apt file, src/books/user-guide/apt. "mvn site" generated the
> pages for the book, including the <img src="myImage.png" /> tag to
> include the image. Although I have followed the "Configuring Maven
> Doxia Plug-in" example [2] with the exception if setting the plugin
> version to 1.0-alpha-11 and using only the xdoc format, the image file
> is not in the same directory as the generated html. Suggestions?
>
> Paul Spencer
>
> [1] http://maven.apache.org/doxia/references/apt-format.html
> [2] http://maven.apache.org/doxia/book/index.html
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
>
>
Paul Spencer
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org
RE: [doxia-maven-plugin] How to get images from book's apt
directory into site?
Posted by Sean Hennessy <sh...@astutenetworks.com>.
Hi Paul,
# try placing images relative to {basedir}/src/site/resources
# maven-antrun-plugin <phase>pre-site</phase>
# is good time to render other formats like docbook
# and copy images from your source tree to appropriate resources folder.
# for example;
# in {basedir}/src/site/apt/index.apt using the following image reference.
[ 1.doc/images/labbenchmap.jpg ] Lab Office 65 layout
# and the corresponding image located here.
{basedir}/src/site/resources/1.doc/images/labbenchmap.jpg
# after call to mvn -X -e site -o >mvn_site.log
# results are found {basedir}/target/site/1.doc/images/
given your {basedir}/src/books/user-guide/apt
I would think {basedir}/src/resources/books/user-guide/myImage.png likely place.
Regards,
Sean
-----Original Message-----
From: Paul Spencer [mailto:paulsp@apache.org]
Sent: Friday, November 21, 2008 2:29 PM
To: Maven Users List
Subject: [doxia-maven-plugin] How to get images from book's apt directory into site?
I am working with doxia-maven-plugin 1.0-alpha-11. One of my apt files
contains a figure, as defined by [myImage.png]. Per the
documentation[1], the image file for the figure is in the same directory
as the apt file, src/books/user-guide/apt. "mvn site" generated the
pages for the book, including the <img src="myImage.png" /> tag to
include the image. Although I have followed the "Configuring Maven
Doxia Plug-in" example [2] with the exception if setting the plugin
version to 1.0-alpha-11 and using only the xdoc format, the image file
is not in the same directory as the generated html. Suggestions?
Paul Spencer
[1] http://maven.apache.org/doxia/references/apt-format.html
[2] http://maven.apache.org/doxia/book/index.html
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org