[jira] [Created] (DOXIA-729) Parser: Emit velocity directives and variables in special Sink events

["Konrad Windszus (Jira)" <ji...@apache.org>]

Konrad Windszus created DOXIA-729:
-------------------------------------

             Summary: Parser: Emit velocity directives and variables in special Sink events
                 Key: DOXIA-729
                 URL: https://issues.apache.org/jira/browse/DOXIA-729
             Project: Maven Doxia
          Issue Type: Improvement
          Components: Module - Apt, Module - Xdoc
            Reporter: Konrad Windszus


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 and references 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/). Therefore parsers should treat Velocity specially (to prevent incorrect escaping).



--
This message was sent by Atlassian Jira
(v8.20.10#820010)