(your home dir) >
(your home dir) > python3 -m venv /path/to/venv
[Windows] > py -m venv \path\to\venv
(your home dir) > cd /path/to/venv
path-to-venv > source bin/activate
[Windows] > Scripts\activate
(venv) path-to-venv > python3 pip install asciidoc3
(venv) path-to-venv > asciidoc3  
--> To install AsciiDoc3, run
'asciidoc3_postinstall [-v]' with [verbose option] from commandline
or plain 'asciidoc3_postinstall' <--
(venv) path-to-venv > asciidoc3_postinstall -v
(venv) path-to-venv > Start install AsciiDoc3 with pip and asciidoc3_postinstall ...
... in directory /path/to/venv
Run /path/to/venvlib/python3.14/site-packages/asciidoc3/asciidoc3_postinstall.py
Found platform: Linux
Pythonversion (empty on Windows): 3.14
Looking for: ./lib/python3.14/site-packages/src/asciidoc3.py
Not found, nothing to do: ./lib/python3.14/site-packages/src
Looking for: ./lib/python3.14/site-packages/tests/readme-tests.txt
Not found, nothing to do: ./lib/python3.14/site-packages/tests
Looking for: ./lib/python3.14/site-packages/images/smallnew.png
Not found, nothing to do: ./lib/python3.14/site-packages/images
Looking for: ./lib/python3.14/site-packages/filters/latex
Not found, nothing to do: ./lib/python3.14/site-packages/filters
Looking for: ./lib/python3.14/site-packages/doc/book.txt
Not found, nothing to do: ./lib/python3.14/site-packages/doc
Looking for: ./lib/python3.14/site-packages/conf/help.conf
Not found, nothing to do: ./lib/python3.14/site-packages/conf
We don't need this file at this place anymore,
so try to remove 'asciidoc3(.exe)' in bin/Scripts.
'bin/asciidoc3' was deleted
Extract tarball asciidoc3-latest.tar.gz in dir asciidoc3 ...
... done
AsciiDoc3 was installed in your 'venv' directory: /path/to/venv/
(venv) path-to-venv > cd asciidoc3
(venv) path-to-venv > python3 asciidoc3.py -a icons -n -a icons doc/test.txt
(venv) path-to-venv > python3 doc/asciidoc3_quicktest.py

[find the files in dir ./doc!]