[Hawkular-dev] Documentation writing

Peter Palaga ppalaga at redhat.com
Wed Feb 18 16:59:55 EST 2015


+1 for writing in asciidoc. Looks like Github is still on AsciidDoctor 
0.1.4 :(

Fabric8 uses GitBook to make a book out of md 
https://github.com/fabric8io/fabric8/blob/master/building.md#gitbook The 
result looks pretty nice http://fabric8.io/v2/getStartedOpenShift.html 
and GitBook page says it works also with adoc.

-- P

On 02/17/2015 04:51 PM, Heiko W.Rupp wrote:
> As promised to some here is a list of AsciiDoc(tor) resources
>
> * Website that has a edit half and a live-preview
> https://asciidoclive.com (found by Lucas P)
> * IntelliJ has an AsciiDoctor plugin that allows to basically do the
> same (see below)
> * AD syntax
> http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/#source-code
> * AsciiDoctor home page http://asciidoctor.org
> * AsciiDoc writers guide http://asciidoctor.org/docs/asciidoc-writers-guide/
> * Editing AsciiDoc with Live Preview
> http://asciidoctor.org/docs/editing-asciidoc-with-live-preview/
> * (Start of a) Eclipse Asciidoctor plugin
> http://marketplace.eclipse.org/node/2162366
> * Netbeans plugin
> https://blogs.oracle.com/geertjan/entry/asciidoctor_netbeans
>
>
> As Mike mentioned, you can go to GitHub, click on a .adoc page and then
> use the pencil icon
>
>
> Directly edit + preview
>
>
> And then commit / open a PR ( I think commit is only enabled for repo
> collaborators, everyone else gets PRs)
>
>
>
> IJ AsciiDoctor plugin:
>
>
>
> _______________________________________________
> hawkular-dev mailing list
> hawkular-dev at lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/hawkular-dev
>



More information about the hawkular-dev mailing list