Asciidoc(tor) support #45

Closed
opened 10 years ago by gour · 1 comments
gour commented 10 years ago (Migrated from github.com)

Hello,

I'm reading 3rd part of tutorial, but wonder if you have any experience with Asciidoc(tor) markup which has ability to convert to (industry-standard) DocBook with all XML-related benefits.

In my case of intended usage of AsciiDoc(tor) I'm not thinking about DocBook toolchain, but wonder if you explored such possibility?

Personally, I'm more interested to use Polen/Scribble markup, but considering there is support in Polen for Markdown, Asciidoc(tor) seems interesting option...

Hello, I'm reading 3rd part of tutorial, but wonder if you have any experience with [Asciidoc(tor)](http://asciidoctor.org/) markup which has ability to convert to (industry-standard) DocBook with all XML-related benefits. In my case of intended usage of AsciiDoc(tor) I'm not thinking about DocBook toolchain, but wonder if you explored such possibility? Personally, I'm more interested to use Polen/Scribble markup, but considering there is support in Polen for Markdown, Asciidoc(tor) seems interesting option...
mbutterick commented 10 years ago (Migrated from github.com)

Pollen has Markdown support only because Greg wrote a Markdown parser, and thus it was easy for me to implement. In general, I’m opposed to simplified-markup tools like Markdown because they’re too limiting. This is why I made Pollen: to have a better alternative. If someone wants to use Markdown or Asciidoc, there are plenty of good tools that already exist.

As for DocBook, same issue — it’s just a question of shaping your output to meet the DocBook schema. It would be no big deal to use Pollen to make DocBook XML (or any XML file).

Pollen has Markdown support only because Greg wrote a [Markdown parser](http://github.com/greghendershott/markdown), and thus it was easy for me to implement. In general, I’m [opposed to](http://pkg-build.racket-lang.org/doc/pollen/second-tutorial.html#%28part._.Prelude__my_principled_objection_to_.Markdown%29) simplified-markup tools like Markdown because they’re too limiting. This is why I made Pollen: to have a better alternative. If someone wants to use Markdown or Asciidoc, there are plenty of good tools that already exist. As for DocBook, same issue — it’s just a question of shaping your output to meet the DocBook schema. It would be no big deal to use Pollen to make DocBook XML (or any XML file).
Sign in to join this conversation.
No Label
No Milestone
No project
No Assignees
1 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: mbutterick/pollen#45
Loading…
There is no content yet.