Brian (bex) Exelbierd wrote:
On Mon, Oct 1, 2018 at 11:03 PM Björn Persson
<Bjorn(a)xn--rombobjrn-67a.se> wrote:
> Jason L Tibbitts III <tibbs(a)math.uh.edu> wrote:
>> Indeed, asciidoctor works a bit better than asciidoc does but still
>> converts quickly. It's actually in the "rubygem-asciidoctor"
package.
>
> Maybe I'll try that next time I have some free time. This is giving me
> a "best viewed with Netscape Navigator" feeling though. Not only are
> there several different badly designed document authoring languages,
> but they're apparently even splitting into tool-specific dialects.
AIUI asciidoc is no longer maintained at all. AsciiDoc the syntax has
evolved is not even fully supported in the outdated asciidoc tool. AIUI
you should only ever run asciidoctor, the successor tooling, or use it's
libraries in your project).
FWIW, git still defaults to asciidoc over asciidoctor. Some
work has been done to accommodate asciidoctor, but there are
a few minor formatting issues when building the docs with
asciidoctor that have kept me from using it in the git
packages.
I agree that newer projects should target asciidoctor's
implementation. I just wouldn't want to see asciidoc
dropped too soon because we think it's completely unused.
--
Todd
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
I never forget a face, but in your case I'll be glad to make an
exception.
-- Groucho Marx