ok for the rationale
Markdown seems to have been chosen in Apache CMS too [1]
DOXIA-472 is a show stopper IMHO for the moment: I hope someone will fix it

Stephen wrote about asciidoc, but it is not supported by Doxia at the moment 
[2], so not an option until someone adds this format to Doxia

For conversion, if someone write a Markdown Sink, doxia-converter [3] is 
already available to convert any Doxia-parser-supported format to Doxia-sink-
supported format.


then can we share on the tools for editing?
>From the dicsussion, I understand that Mac users have Mou http://mouapp.com/, 
with side-by-side edit/render: really nice
But I don't have a Mac.
There are many online Markdown editors, but we need something local.
Any good tool for Linux, ie my OS? Any experience with major IDEs: Eclipse, 
Netbeans, Idea?

Notice I couldn't edit our Maven website Markdown content with CMS and any 
editor enhancement: does anybody know what is wrong with our content?

Regards,

Hervé


[1] http://www.apache.org/dev/cms.html#markdown

[2] http://maven.apache.org/doxia/references/index.html

[3] http://maven.apache.org/doxia/doxia-tools/doxia-converter/

Le samedi 5 octobre 2013 11:19:01 Jason van Zyl a écrit :
> We current have multiple formats for our site documentation and two of them
> no one else in the world uses except us. We created xdoc here a long time
> ago in the Jakarta project, and APT has lost in the world of markup. I
> ported it from another project many years ago but there are many better
> options like asciidoc, restructured text, and markdown. My preference is
> for markdown but I would like to get rid of xdoc, fml, and xdoc and convert
> that documentation over to markdown. The tool support is great for editing,
> book support is great (the Pro Git book is created from markdown). We can
> still use all the Doxia tools for all the post processing. But I see no
> need to 4 different types of markup for the site, and honestly I find
> working with APT now incredibly annoying.
> 
> I'm happy to do the conversion and testing.
> 
> Thanks,
> 
> Jason
> 
> ----------------------------------------------------------
> Jason van Zyl
> Founder,  Apache Maven
> http://twitter.com/jvanzyl
> ---------------------------------------------------------

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org
For additional commands, e-mail: dev-h...@maven.apache.org

Reply via email to