Text based document generation using Python 3.x

»Home  »User Guide  »Download  »Install  »Quickstart  »PyPI  »Windows  »Release Notes  »Blog  »Donate  »Contact  »Legal Stuff

AsciiDoc3 was developed, implemented, and tested on GNU/Linux. That’s a matter of fact. But you can use AsciiDoc3 on Windows OS (7, 8, 10), too.
This page gives you some hints and the limitations of this combination (yes, there are in deed some limitations… but less than you probably suspect!).
Please note, the writer of these very lines isn’t a Windows expert at all, but has tested all the following stuff as good as possible. If you find a mistake or some facts missing, please mail.

Warning This page is a kind of a placeholder. The info given here is o.k. but only a first draft. It will be extended/completed asap.

There are different ways to use AsciiDoc3 on Windows:
- you want to compute html-pages out of your input.txt. Nothing else, no txt2pdf, no txt2docbook, no filters like pygments, lilypond, latex … This very basic usage is very easy to implement.
- you want to use most of the features that AsciiDoc3 has in store: think about to use Cygwin (Recommended!)

First you have to install Python 3.x - at the time of writing 3.7, but everything 3.4+ is ok (Python3.x with x<4 has reached end of life, please update instantly). I found it handy to install the downloaded file (say python-3.7.1.exe) with the options customize: optional features: check pip idle py launcher / for all users yes.
After running with admin rights you find Python3.7 here:
C:\Program Files (x86)\Python37-32
This is the 32bit version, you may have another version number and/or the 64bit version, that doesn’t matter here. If everything goes as expected, try (WondowsPowerShell or Command Prompt) - no admin rights here:

C:\Users\<username>: python
Python 3.7.1 (v3.7.1:260ec2c36a, Oct 20 2018, 14:05:16) [MSC v.1915 32 bit (Intel)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> exit()

It works. Try, too:

C:\Users\<username>: py


C:\Users\<username>: py -3

If Python 3.7.1 is the only installed version of Python, you’ll see the same output as above.
If you have other/older versions like 2.7 on your machine, only py -3 works for us and starts Python3.

Because AsciiDoc3 needs (almost ever) python3 to start our Python3, we have to add this command to our system.