Hello. Interesting question. I use asciidoc to author documents, reports, including professional, quotes, invoices etc. Your use case may be different.
At some point I, too, was wondering if I should switch to asciidoctor which seemed more powerful. Now I have chosen to stay with asciidoc but the reason is not obvious. Asciidoc has drawbacks but asciidoctor feels to walk a wrong way. After experimenting and discussing on this list I consider direct asciidoc to HTML a simple but weak path, useful to get started, and now use asciidoc as **a convenient syntax to author docbook** which I can render as many formats including HTML. HTML produced this way benefits from all the power of a real toolchain with good handling of cross references, actual table of content, and all the work people have done to allow custom rendering and style from a docbook source. When this is clear in one's mind, one no longer asks in asciidoc group help about downstream topics or reinvent what people have already worked on for years in the docbook realm. Let's have each tool do one thing and do it right. Let's have standard interfaces to ensure interoperability. Docbook is such an interface. When asciidoc syntax fades away, a better one will replace and you'll still be able to leverage work done on style and archival in docbook format. Hope this helps and thanks for asciidoc authors and contributors. Le 14 août 2014 10:12, "Gour" <[email protected]> a écrit : > Hello, > > I see that Asciidoc is becoming more popular > (http://asciidoctor.org/news/2013/01/30/asciidoc-returns-to-github/), but > see > that Asciidoctor is, afaict, bringing some icompatible changes in 1.5, but > also > stuff like Asciidoctor.js to render docs in browser as well as direct > rendering > to PDF without the need for DocBook toolchain, so I wonder what experienced > Asciidoc users recommend to someone just seriously starting with Asciidoc > after > realizing that markdown's simplicity is not productive any longer? > > > Sincerely, > Gour > > -- > The humble sages, by virtue of true knowledge, see with equal > vision a learned and gentle brāhmana, a cow, an elephant, a dog > and a dog-eater. > > http://www.atmarama.net | Hlapicina (Croatia) | GPG: 52B5C810 > > > -- > You received this message because you are subscribed to the Google Groups > "asciidoc" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To post to this group, send email to [email protected]. > Visit this group at http://groups.google.com/group/asciidoc. > For more options, visit https://groups.google.com/d/optout. > -- You received this message because you are subscribed to the Google Groups "asciidoc" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/asciidoc. For more options, visit https://groups.google.com/d/optout.
