[
https://issues.apache.org/jira/browse/MPLUGIN-513?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Alexander Kriegisch updated MPLUGIN-513:
----------------------------------------
Attachment: screenshot-1.png
> Closing curly brace in code block rendered incorrectly
> ------------------------------------------------------
>
> Key: MPLUGIN-513
> URL: https://issues.apache.org/jira/browse/MPLUGIN-513
> Project: Maven Plugin Tools
> Issue Type: Bug
> Affects Versions: 3.11.0
> Reporter: Alexander Kriegisch
> Priority: Major
> Attachments: image-2024-03-18-17-00-11-575.png, screenshot-1.png
>
>
> In my plugin parameter javadoc, I use something like this:
> {code:java}
> * <pre>{@code
> * <javaAgents>
> * <agent>
> * <groupId>dummy</groupId>
> * <artifactId>dummy</artifactId>
> * <agentPath>${project.basedir}/lib/agent.jar</agentClass>
> * </agent>
> * </javaAgents>
> * }</pre>
> {code}
> This "<pre>" and "\{@code ...}" combination is used, if we want to avoid
> having to escape XML tags and preserve line breaks at the same time. This
> works fine when generating javadocs, but in a Maven plugin goal description,
> the result looks like this:
> !image-2024-03-18-17-00-11-575.png!
> It looks correct on the Maven site, if instead of "${project.basedir}" I
> write "${project.basedir&#125;", but then javadoc generation fails with
> an error, because HTML entities are not permitted in that block.
> This ought to be fixed in Maven Site Plugin. It might be subtle and somewhat
> of an advanced edge case, but the rendered HTML for the plugin description
> should look correctly, just as it does for javadocs. The nested closing curly
> brace ought to be parsed correctly.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)