Installing AsciiDoc on windows

[Matt Wilkie]

The new Leo @adoc directive and the adoc command need either Asciidoc3 or Asciidoctor tool installed and in PATH. Asciidoctor is probably the best of the two to use, but installing on Windows is not straightforward as one needs to install Ruby first. Asciidoc3 isn't the straightest either, but enough that it can be shortened to couple of instructions, namely:

pip install asciidoc3
   # stuff happens

asciidoc3_postinstall
   # more stuff happens

#now asciidoc3 is ready and Leo can use it:
asciidoc3 --help

If you run into difficulties see https://asciidoc3.org/pypi.html#_asciidoc3_pip_install_windows

-matt

[Matt Wilkie]

I added a version of this to LeoDoc.leo at 10171e16afa22f2e07b9651f9c2819a0e964dfd7. Feel free to rework or even remove.

-matt

[Edward K. Ream]

Thanks for this.  Still, I think the slight extra difficulty in installing asciidoctor is well worthwhile.

Edward

[Matt Wilkie]

Thanks for this.  Still, I think the slight extra difficulty in installing asciidoctor is well worthwhile.

:-)  Asciidoctor install recipe:

choco install ruby
refreshenv
gem install asciidoctor
asciidoctor --version

chocolatey: it's apt-get/yum/pip for Windows. It's now the first thing I install on any Windows machine I'm going to do real work with. It is however not to everyone's liking. (I don't trust it to install python when there are other pythons for example; been burnt. However it knows `choco install miniconda3` so we're still friends.)

-matt