You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@maven.apache.org by Mykel Alvis <my...@weirdness.com> on 2008/02/21 17:16:50 UTC

Doxia XDOC issue?

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>
						<li>Need to eliminate bundled Hibernate:<br/>
							<ol>
								<li><tt>hibernate3.jar</tt></li>
								<li><tt>hibernate-annotations.jar</tt></li>
								<li><tt>hibernate-entitymanager.jar</tt></li>
								<li><tt>hibernate3.jar</tt></li>
								<li><tt>ejb3-persistence.jar</tt></li>
							</ol>
						</li>
					</ol>
				</p>
			</subsection>


When I have this subsection in install.xml, I get the following error
on transformation:

[ERROR] Error parsing
/home/mykel/work/jj/JJ/src/site/xdoc/install.xml: line [-1] Error
parsing the model.
org.apache.maven.doxia.parser.ParseException: Error parsing the model.
        at org.apache.maven.doxia.module.xdoc.XdocParser.parse(XdocParser.java:55)
        at org.apache.maven.doxia.DefaultDoxia.parse(DefaultDoxia.java:52)
        at org.apache.maven.doxia.siterenderer.DefaultSiteRenderer.renderDocument(DefaultSiteRenderer.java:264)
        at org.apache.maven.doxia.siterenderer.DoxiaDocumentRenderer.renderDocument(DoxiaDocumentRenderer.java:43)
        at org.apache.maven.doxia.siterenderer.DefaultSiteRenderer.renderModule(DefaultSiteRenderer.java:239)
        at org.apache.maven.doxia.siterenderer.DefaultSiteRenderer.render(DefaultSiteRenderer.java:115)
        at org.apache.maven.plugins.site.SiteMojo.renderLocale(SiteMojo.java:124)
        at org.apache.maven.plugins.site.SiteMojo.execute(SiteMojo.java:92)
        at org.apache.maven.plugin.DefaultPluginManager.executeMojo(DefaultPluginManager.java:443)
        at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoals(DefaultLifecycleExecutor.java:539)
        at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeStandaloneGoal(DefaultLifecycleExecutor.java:493)
        at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoal(DefaultLifecycleExecutor.java:463)
        at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoalAndHandleFailures(DefaultLifecycleExecutor.java:311)
        at org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeTaskSegments(DefaultLifecycleExecutor.java:278)
        at org.apache.maven.lifecycle.DefaultLifecycleExecutor.execute(DefaultLifecycleExecutor.java:143)
        at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:334)
        at org.apache.maven.DefaultMaven.execute(DefaultMaven.java:125)
        at org.apache.maven.cli.MavenCli.main(MavenCli.java:280)
        at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
        at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:39)
        at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:25)
        at java.lang.reflect.Method.invoke(Method.java:585)
        at org.codehaus.classworlds.Launcher.launchEnhanced(Launcher.java:315)
        at org.codehaus.classworlds.Launcher.launch(Launcher.java:255)
        at org.codehaus.classworlds.Launcher.mainWithExitCode(Launcher.java:430)
        at org.codehaus.classworlds.Launcher.main(Launcher.java:375)
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)
        at org.codehaus.plexus.util.xml.pull.MXParser.parseStartTag(MXParser.java:1796)
        at org.codehaus.plexus.util.xml.pull.MXParser.nextImpl(MXParser.java:1124)
        at org.codehaus.plexus.util.xml.pull.MXParser.next(MXParser.java:1090)
        at org.apache.maven.doxia.module.xdoc.XdocParser.parseXdoc(XdocParser.java:312)
        at org.apache.maven.doxia.module.xdoc.XdocParser.parse(XdocParser.java:51)
        ... 25 more
[


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.

Thanks,
Mykel

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


Re: Doxia XDOC issue?

Posted by Mykel Alvis <my...@weirdness.com>.
Switching out with &amp; took care of it.  I knew I just needed
someone else's perspective.  Darn trees get in the way of my view of
the forest. :)

Thanks Simon!

On Thu, Feb 21, 2008 at 10:30 AM, simon.kitching@chello.at
<si...@chello.at> wrote:
> 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..

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


Re: Doxia XDOC issue?

Posted by "simon.kitching@chello.at" <si...@chello.at>.
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: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org