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)

Reply via email to