[
Date Prev][
Date Next][
Thread Prev][
Thread Next][
Date Index][
Thread Index]
[
List Home]
|
Re: [incubation] (HTML) Documentation editor
|
Hi Keith,
we´re currently migrating from DocBook to AsciiDoc and can really recommend it.
It provides a great tool chain, which let´s us write documentation really fast.
We also created a tutorial about AsciiDoc
(http://www.vogella.com/tutorials/AsciiDoc/article.html) and the
official documentation of AsciiDoc is great.
It also has a strong and vibrant community and lots of companies are using it.
We´re also using https://wiki.eclipse.org/Mylyn/WikiText/AsciiDoc and
recently also provided some nice enhancements to it. The project lead,
David Green, of WikiText is really responsive. (Thanks for that ;-))
In order to build the documentation we use the asciidoctor Gradle
plugin(https://github.com/asciidoctor/asciidoctor-gradle-plugin), but
there´s also a plugin for Apache Maven.
Best regards,
Simon
On Tue, Jul 12, 2016 at 10:14 PM, Jens v.P. <developer@xxxxxxxxx> wrote:
> Dear Keith,
>
> We are currently switching to Asciidoc (http://www.methods.co.nz/asciidoc/),
> using Asciidoctor (http://asciidoctor.org/) for tooling. It is supported by
> Mylyn’s WikiText (https://wiki.eclipse.org/Mylyn/WikiText/AsciiDoc), and we
> already create Eclipse Help, HTML pages, and PDF from a single source.
>
> We are at the very beginning, and we have only migrated some user
> documentation, see
> https://github.com/NumberFour/n4js/tree/master/docs/eu.numberfour.n4js.doc.
> In the long run, we want to port our Latex based specification to Asciidoc
> and use that as the only format. For that, we are currently investigating
> custom macros (both for AsciiDoc and Mylyn Wikitext).
>
> Regards,
> Jens
>
> _______________________________________________
> incubation mailing list
> incubation@xxxxxxxxxxx
> To change your delivery options, retrieve your password, or unsubscribe from
> this list, visit
> https://dev.eclipse.org/mailman/listinfo/incubation
>
