Re: Doxia XDOC issue?

[[EMAIL PROTECTED]]

Mykel Alvis schrieb:
> I seem to have a problem with generating site information with xdoc.
> I haven't done an enormous amount of this lately, so can someone tell
> me what's wrong with this <subsection>
>
>                       <subsection name="JBoss 4.2.1">
>                               <p>
>                                       <ol>
>                                               <li>Need to replace 
> <tt>jboss-remoting.jar</tt>.  See <a
> href="http://www.jboss.com/index.html?module=bb&op=viewtopic&p=4063410#4063410";>here</a>
> for details</li>
>   

> Caused by: org.codehaus.plexus.util.xml.pull.XmlPullParserException:
> entity reference name can not contain character =' (position: TEXT
> seen ...<a href="http://www.jboss.com/index.html?module=bb&op=...
> @11:115)
>         at 
> org.codehaus.plexus.util.xml.pull.MXParser.parseEntityRef(MXParser.java:2219)
>         at 
> org.codehaus.plexus.util.xml.pull.MXParser.parseAttribute(MXParser.java:2044)
>   

> It appears that it's illegal to have a query inside an anchor in an
> Xdoc.  Is that true?  Is there some other way to do this?  Switching
> to apt isn't an option.
>   

This is xml. And ampersand characters are not allowed in xml; they are
interpreted as an "entity reference", eg &apos;. This is exactly what
the xml parser is complaining about here. It's an xml issue, not an xdoc
one.

Replace the & characters with &amp; and everything should be ok, eg
instead of
  "&op="
write
  "&amp;op="

It might also be possible to surround the problem block with CDATA, like:
  <![CDATA[   some text & other stuff ]]>

Not sure whether that will be accepted here though..

Regards,
Simon


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]