I’ve been using asciidoc (format and application) for years. In recent years, asciidoc has become officially a markup language and there are a number of asciidoc tools that convert asciidoc to html, epub, pdf, etc. The original asciidoc application was written in python. The current conversion tools are written in everything but it seems.
I’m still researching options, but I’m not keen on using anything outside of pacman (i.e., pip, gem, cpan)…
I’m looking at asciidoctor, which is written in ruby. I know very little about ruby’s packaging system, gem.
asciidoctor is in the manjaro repository (one done )
the pkgbuild at archlinux, shows it obtaining the gem
- Is this a system-wide install or $HOME? I suppose the line below is key. Does the user have to set a ruby environmental variable to control default_dir?
local _gemdir="$(ruby -e 'puts Gem.default_dir')"
The gem shows a number of gem dependencies (cucumber, haml, etc)
- Is the gem system smart enough to pull these in, or does the user have to install them separately?
I noticed a number of asciidoctor packages in the AUR, that appear to be addon’s for various document conversions. I don’t know if these are necessary or is everything to produce epub, pdf, html installed in #2. If it isn’t, that would mean I have to chose between the AUR or the gem repository. I’m think’n if I need to go to the AUR to support epub, pdf, html, I might be better off installing everything using gem.
- Does ruby have a virtual environment like python?
Anyone else using asciidoctor? If so, how did you install it (pacman or gem), $HOME or system?
Or are you using something else to convert asciidoc to epub, pdf, html?