Re: asciidoctor-j based documentation generator
Posted by
PzdcDoc on
May 05, 2019; 10:48am
URL: https://discuss.asciidoctor.org/asciidoctor-j-based-documentation-generator-tp6888p6896.html
abelsromero wrote
Antora runs on JS, so there's no Java alternative. However, don't be afraid, I come from the same place and I can assure there's nothing to worry. All the team at the office is happy with it and we are all Java devs.
To simplify installation, just use docker if you don't want to "pollute" your machine with npm home directory
https://docs.antora.org/antora/2.0/antora-container/. If you're prefer to install antora on bare metal, just use "nvm", it's available for Windows and Linux.
https://docs.antora.org/antora/2.0/install/linux-requirements/If it helps, on Windows I use the Linux tools in a WSL machine.
It is not about being afraid. I know NodeJS and am able to use it..
Unfortunately there is no way in modern world to avoid JS

But about maximum simplification of environment configuration for each of developers.
Right now for building of our project is enough to have installed JDK8 and we try to stick on it.
Installing two or more additional stuff on any of developers systems is too time consuming.
Even Docker may do not exist there.
Of course, it is matter of taste. And it is the good thing in Open Source, that anyone can choice.
For us right now three small additional Java classes on top of asciidoctor-j is the best option.
Will see, when nobody else need that - they will just live further in out Utils.
Or maybe we will switch to Antora, I haven't analyzed it yet deep enough.