[ http://jira.codehaus.org/browse/MPXDOC-158?page=all ]
Lukas Theussl updated MPXDOC-158:
---------------------------------
Attachment: MPXDOC-158.patch
A slight change to maintain backwards compatibility: the id tag will only be
used if it is present, if omitted, we fall back to the name tag as before.
This patch also makes the link handling of the pdf and xdoc plugins identical.
> Do not generate name tags from section names
> --------------------------------------------
>
> Key: MPXDOC-158
> URL: http://jira.codehaus.org/browse/MPXDOC-158
> Project: maven-xdoc-plugin
> Type: Improvement
> Versions: 1.9.1
> Environment: ?
> Reporter: Lukas Theussl
> Assignee: Arnaud Heritier
> Attachments: MPXDOC-158.patch, site.jsl.patch
>
> Original Estimate: 5 minutes
> Remaining: 5 minutes
>
> In the current version of the xdoc plugin, a <a name="sectionName"> element
> is generated for every sub/section from its corresponding
> name tag. This may lead to an invalid HTML document if some sub/sections have
> the same name, because according to the HTML 4.01 specs (
> http://www.w3.org/TR/html4/struct/links.html#h-12.2.1 ), anchor names must be
> unique within one document. For the xdoc plugin this is not a big problem
> because browsers usually ignore identical ids, but we are having troubles for
> the pdf plugin (see MPPDF-40) where identical ids lead to a
> build failure.
> I suggest to generate an id from an optional id tag as in the following
> example:
> <section name="Section 1">
> <subsection name="SubSection" id="SubSection1">
> </subsection>
> </section>
> <section name="Section2">
> <subsection name="SubSection" id="SubSection2">
> </subsection>
> </section>
> so the section title is constructed from the name tag while the id tag (which
> has to be unique) may be used to reference the section.
> I attach a patch to achieve this, if this gets accepted I can easily adjust
> the pdf plugin accordingly.
> The only worry is backwards compatibility: xdocs that use the old feature of
> referencing sections by names, will produce invalid links.
> However, I haven't seen this feature documented anywhere, I don't think it is
> widely used and therefore, it should not be a big problem.
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://jira.codehaus.org/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
