On 09/12/2011 10:25 PM, Mark H. Wood wrote:
Is there any way to embed hyperlinks in the POM description element? If I
put them in plain, the result is an invalid document; if I wrap them in
CDATA then the markup comes through. Adding and using the XHTML
namespace made no difference with the plain markup.
The description seems like the right place to link to e.g. protocol
specifications and other standards. Like: BaloneySoft FooPlex
implementsaour profile/a ofaRFC 1149/a.
The description in the pom xsd [1] states:
A detailed description of the project, used by Maven whenever it needs
to describe the project, such as on the web site. While this element can
be specified as CDATA to enable the use of HTML tags within the
description, it is discouraged to allow plain text representation. If
you need to modify the index page of the generated web site, you are
able to specify your own instead of adjusting this text.
This text is ambiguous IMO, since the description element is specified
to be of type string, ie no markup allowed, and markup inside CDATA is
(correctly) not interpreted by the site plugin. So if you want
hyperlinks in your index page, you should specify your own. Also bear in
mind that the description might be used in contexts other than html.
HTH,
-Lukas
[1] http://maven.apache.org/maven-v4_0_0.xsd
-
To unsubscribe, e-mail: users-unsubscr...@maven.apache.org
For additional commands, e-mail: users-h...@maven.apache.org
