[DOXIATOOLS-84] Emit Velocity statements in special Sink events which prevent wrong escaping

• Type: Improvement
• Status: In Progress
• Priority: Major
• Resolution: Unresolved
• Component/s: Doxia Converter
• Assignee: Konrad Windszus
• Reporter: Konrad Windszus
• Created: 19/Jan/24 19:08
• Updated: 05/Oct/24 18:28

Description

Velocity is often used together with markup (https://maven.apache.org/plugins/maven-site-plugin/examples/creating-content.html#Filtering). When parsing markup including Velocity statements (directives, references and comments) those are included in the regular Sink.text(...) event. Therefore it is often incorrectly escaped when being emitted by a Sink.

Although usually Velocity is supposed to be executed before markup is passed to a parser, there are cases where one wants to retain the Velocity statements and references in the markup (e.g. for converting from one format to another with https://maven.apache.org/doxia/doxia-tools/doxia-converter/).

Issue Links

• blocks: MNGSITE-507 Convert APT to markdown sources