Re: Plugins to extend the APT format? (For use with the Maven Site plugin)
Le mercredi 13 août 2014 23:22:52 Nick Burch a écrit : Hi All For Apache Tika, we currently use the Maven Site plugin, along with the APT format for our site content. We are looking to automatically pull in snippets of code from svn into the published site, much as the ASF CMS supports https://blogs.apache.org/infra/entry/scaling_down_the_cms_to I'm fairly happy about how to do the snippet-fetching part, what's stumping me is finding an example plugin to allow the Maven Site plugin to process additional kinds of markup in the APT format. extending the markup, ie the syntax? Not possible: each supported markup language supported by Doxia is a done through a parser, and i don't know any parser that has such extension points (and I don't kow how this would be feasible) (Or failing that, any other simple-ish Maven Site plugin supported formats like Markdown) there is a external Doxia extension which support including a snippet in another markup language: see Doxia :: Include Macro, http://doxia-include.sourceforge.net/ Could anyone point me to an example for extending one of the formats like this? the only generic extension solution for Doxia is macros (and IIRC, not available in each markup language): see http://maven.apache.org/doxia/macros/index.html Regards, Hervé Thanks Nick - To unsubscribe, e-mail: users-unsubscr...@maven.apache.org For additional commands, e-mail: users-h...@maven.apache.org - To unsubscribe, e-mail: users-unsubscr...@maven.apache.org For additional commands, e-mail: users-h...@maven.apache.org
Re: Plugins to extend the APT format? (For use with the Maven Site plugin)
*Not answering your question* I think we have grown to favour moving away from APT and towards Markdown or Asciidoc as a format at least on the Maven team (note that we do not have good tooling for Asciidoc yet) most of our new documentation is driven through Markdown. I think there are really two plain text mark up formats left standing: Markdown and Asciidoc. Of those I think Asciidoc is the better format as it actually has a proper spec... but it could end up being the Betamax of formats (i.e. technically the best but looses out due to amount of Markdown usage out there) On 13 August 2014 18:22, Nick Burch n...@apache.org wrote: Hi All For Apache Tika, we currently use the Maven Site plugin, along with the APT format for our site content. We are looking to automatically pull in snippets of code from svn into the published site, much as the ASF CMS supports https://blogs.apache.org/infra/entry/scaling_down_the_cms_to I'm fairly happy about how to do the snippet-fetching part, what's stumping me is finding an example plugin to allow the Maven Site plugin to process additional kinds of markup in the APT format. (Or failing that, any other simple-ish Maven Site plugin supported formats like Markdown) Could anyone point me to an example for extending one of the formats like this? Thanks Nick - To unsubscribe, e-mail: users-unsubscr...@maven.apache.org For additional commands, e-mail: users-h...@maven.apache.org
