The Sink interface is a generic markup language interface provided as a Java API. It contains several methods that encapsulate common text syntax. A start tag is denoted by xxxx() method and a end of tag by xxxx_() method.
For instance, you could do things like:
sink.paragraph(); sink.text( "my text" ); sink.paragraph_();
similar to this HTML markup:
To find out more about the Sink API, you can read the Javadoc.
With every Doxia release, a new doxia-sink-api artifact has been released even if the API itself didn't change.
Here is a summary of API changes:
|doxia-sink-api version||change description|
|1.0-alpha-6||added org.apache.maven.doxia.sink.Sink interface which supercedes org.codehaus.doxia.sink.Sink|
|1.0-alpha-9||added org.apache.maven.doxia.sink.SinkFactory interface|
|1.1||added org.apache.maven.doxia.sink.SinkEventAttributes interface and a dependency on doxia-logging-api|
Note that doxia-sink-api 1.0 is equivalent to doxia-sink-api 1.0-alpha-9.
doxia-sink-api is included in every Maven 2 distribution. Decoupling has been done in Maven 3.
|Maven version||doxia-sink-api version|
|3.0+||no more dependency|
Maven 2.0.8 is the first Maven 2.0.x version including doxia-sink-api 1.0(-alpha-9).
To hide the difference between doxia-sink-api 1.0-alpha-6 and 1.0 included in previous Maven 2.0.x versions, org.apache.maven.doxia.sink.SinkFactory interface was copied into maven-site-plugin 2.0-beta-6.