Re: asciidoctor-j based documentation generator
Posted by
mojavelinux on
May 05, 2019; 10:51am
URL: https://discuss.asciidoctor.org/asciidoctor-j-based-documentation-generator-tp6888p6897.html
> 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.
100% While we provide suggestions here, they are just that, suggestions. The Asciidoctor ecosystem is vast and those options are a great thing. Find what works best for you.
Best,
-Dan
On Sun, May 5, 2019 at 4:48 AM PzdcDoc [via Asciidoctor :: Discussion] <
[hidden email]> wrote:
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.
--