Migrating the guide to AsciiDoc

[Andrew Moore]

Just to be clear, asciidoc is the format, but asciidoctor is the text processor (a superset of python asciidoc).  Is that correct?
-AM

> On Apr 22, 2018, at 3:29 AM, Mojca Miklavec <mojca at macports.org> wrote:
> 
> Hi,
> 
> As requested during yesterday's meeting, here's the result of
> automatic conversion of our guide from xml (docbook) to asciidoc:
> 
>    https://github.com/macports/macports-guide/tree/master/guide/adoc
> 
> This was initially explored by Aljaž and gives quite nice results
> out-of-the-box, but there are still some issues with conversion that
> will have to be addressed either by fixing docbookrx itself or
> manually.
> 
> If anyone is willing to help in the process, your help will be appreciated.
> 
> Thank you,
>    Mojca