xdoc snippet macro
Hi,
I've got some documentation in the xdoc format. I have had the apt version of
the snippet macro working fine. However, I can't make it work from in xdoc. I
get the same error each time, regardless of how I format the macro tag.
Here are some example tags I've tried:
<macro name="snippet" id="client-code"
file="src/site/resources/gettingStartedCommandLineClient/src/main/java/Client.java"/>
<macro name="snippet" snippetId="client-code"
file="src/site/resources/gettingStartedCommandLineClient/src/main/java/Client.java"/>
<macro name="snippet" macroId="client-code"
file="src/site/resources/gettingStartedCommandLineClient/src/main/java/Client.java"/>
All three of these give the identical error when running site:site in maven.
Any ideas?
Matthew
[ERROR] FATAL ERROR
[INFO] ------------------------------------------------------------------------
[INFO] id is a required parameter
[INFO] ------------------------------------------------------------------------
[INFO] Trace
java.lang.IllegalArgumentException: id is a required parameter
at
org.apache.maven.doxia.macro.snippet.SnippetMacro.required(SnippetMacro.java:256)
at
org.apache.maven.doxia.macro.snippet.SnippetMacro.execute(SnippetMacro.java:64)
at
org.apache.maven.doxia.parser.AbstractParser.executeMacro(AbstractParser.java:71)
at
org.apache.maven.doxia.module.xdoc.XdocParser.handleEndTag(XdocParser.java:477)
at
org.apache.maven.doxia.parser.AbstractXmlParser.parseXml(AbstractXmlParser.java:92)
at
org.apache.maven.doxia.parser.AbstractXmlParser.parse(AbstractXmlParser.java:53)
at
org.apache.maven.doxia.module.xdoc.XdocParser.parse(XdocParser.java:99)
at org.apache.maven.doxia.DefaultDoxia.parse(DefaultDoxia.java:59)
at
org.apache.maven.doxia.siterenderer.DefaultSiteRenderer.renderDocument(DefaultSiteRenderer.java:342)
at
org.apache.maven.doxia.siterenderer.DoxiaDocumentRenderer.renderDocument(DoxiaDocumentRenderer.java:46)
at
org.apache.maven.doxia.siterenderer.DefaultSiteRenderer.renderModule(DefaultSiteRenderer.java:269)
at
org.apache.maven.doxia.siterenderer.DefaultSiteRenderer.render(DefaultSiteRenderer.java:101)
at
org.apache.maven.plugins.site.SiteMojo.renderLocale(SiteMojo.java:129)
at org.apache.maven.plugins.site.SiteMojo.execute(SiteMojo.java:96)
at
org.apache.maven.plugin.DefaultPluginManager.executeMojo(DefaultPluginManager.java:451)
at
org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoals(DefaultLifecycleExecutor.java:558)
at
org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeStandaloneGoal(DefaultLifecycleExecutor.java:512)
at
org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoal(DefaultLifecycleExecutor.java:482)
at
org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeGoalAndHandleFailures(DefaultLifecycleExecutor.java:330)
at
org.apache.maven.lifecycle.DefaultLifecycleExecutor.executeTaskSegments(DefaultLifecycleExecutor.java:291)
at
org.apache.maven.lifecycle.DefaultLifecycleExecutor.execute(DefaultLifecycleExecutor.java:142)
at org.apache.maven.DefaultMaven.doExecute(DefaultMaven.java:336)
at org.apache.maven.DefaultMaven.execute(DefaultMaven.java:129)
at org.apache.maven.cli.MavenCli.main(MavenCli.java:287)
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:597)
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)