Issue #7132 new

Render AsciiDoc files (BB-1913)

Dobrosław Żybort
created an issue

Hello,

would be nice if you could render AsciiDoc files (after all it's written in Python).

File extensions to catch:

.ad, .adoc and .asciidoc

(and probably .ad.txt, .adoc.txt and .asciidoc.txt: https://code.google.com/p/asciidoc/issues/detail?id=13 )

Repo with samples: https://bitbucket.org/matrixik/asciidoc-samples

Comments (37)

  1. laher

    +1, this feature gets my vote. Asciidoc is more appropriate (than e.g. Markdown) for authoring books and longer texts. Thanks

  2. jochenhinrichsen

    +1 While i like Markdown, Asciidoc outputs Docbook out of the box which opens up the whole nine yard of the publishing pipeline.

    As an implementation, i'd rather choose the newer Ruby based Asciidoctor instead of the older Python based Asciidoc.

  3. Dan Allen

    +1

    There's a Java API for Asciidoctor called AsciidoctorJ that encapsulates the use of JRuby. Bintray uses AsciidoctorJ to render AsciiDoc files. Asciidoctor runs fastest on JRuby anyway.

    Asciidoctor is also very secure for serve-rside usage. By default it runs in secure mode, which disables all file system access. You are free to enable the functionality from there that works best for you.

    AsciiDoc is gaining a lot of traction with big name authors lately, largely do to the innovation & advocacy coming out of the Asciidoctor project & community.

    GitHub uses Asciidoctor to render AsciiDoc, but it hasn't been upgraded past version 0.1.0 released in January. BitBucket could grab the reigns here by deploying 0.1.4 or 1.5.0.preview.1.

  4. TheSteve0

    +1 - we are storing the initial drafts of our book for O'Reilly here and it would be really nice as a paying customer if we could render the files

  5. zgamero

    I've tried reST, Markdown and AsciiDoc, finding the last one the more confortable and it's growing in popularity, IMHO.

    +1 for adding AsciiDoc

  6. Daniel Grigg

    +1 so colleagues will stop complaining about me writing bitbucket-un-renderable readme's

    Honestly asciidoc is just more feature-complete with less hacks required for writing technical docs.

  7. Log in to comment