asciidoctor-pdf: Installation appears to succeed but asciidoctor-pdf is not available

After installing a local version of Ruby on my Mac (I originally got an error because of the system version of Ruby), I installed asciidoctor-pdf following the instructions in the README:

$ gem install asciidoctor-pdf --pre
Successfully installed asciidoctor-pdf-1.5.0.beta.2
Parsing documentation for asciidoctor-pdf-1.5.0.beta.2
Done installing documentation for asciidoctor-pdf after 1 seconds
1 gem installed

However, when I try to use it or check that it’s working, it doesn’t actually appear to be installed:

$ asciidoctor-pdf --version
-bash: asciidoctor-pdf: command not found

About this issue

  • Original URL
  • State: closed
  • Created 5 years ago
  • Comments: 17 (17 by maintainers)

Most upvoted comments

I didn’t handle this well and I am sorry for that. My frustration is with the docs. I wish they were better. I very much appreciate that you are trying to e help make them better. So let’s reset from there.

I want to take some time with your contribution and see how best to incorporate it so we can make the installation experience smoother. I’ll post a draft here for you to review and we’ll take it from there. Thanks again!

I feel like we’re playing musical chairs with comments. that said…

Your mac instructions on the main asciidoctor.org page tell folks to install asciidoctor using Homebrew so that’s exactly what I did. If I’d been told to use RVM and sent to those instructions I would have followed them.