diff options
| author | janicemhdc <54671493+janicemhdc@users.noreply.github.com> | 2019-08-29 11:33:22 -0400 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2019-08-29 11:33:22 -0400 |
| commit | 8fabc4015c6b67e558b62e1ad0d17fa7b02aec7a (patch) | |
| tree | 9fa16848b06533d2a839f7979945a6a24a9f9403 | |
| parent | f654f3be31acbca9433205574ace1138997840b3 (diff) | |
Update README.adoc
Add information about common Mac issue with Ruby and how to fix it
| -rw-r--r-- | README.adoc | 11 |
1 files changed, 11 insertions, 0 deletions
diff --git a/README.adoc b/README.adoc index 2cdd1c1f..6a3d55d7 100644 --- a/README.adoc +++ b/README.adoc @@ -150,6 +150,17 @@ Then, install the gem from RubyGems.org using the following command: $ gem install asciidoctor-pdf --pre +If you're on a Mac and get the following error: + +``` +ERROR: While executing gem ... (Gem::FilePermissionError) + You don't have write permissions for the /Library/Ruby/Gems/2.x.x directory. +``` + +Then your currently installed version of Ruby is owned by Apple and part of the system code. While you could override this ownership, a better practice is to install your own local copy using `brew install ruby` or the installation mechanism of your choice. + +Your non-system version of Ruby will likely live at `/usr/local/opt/ruby/bin` - you may need to explictly add that to your path. + If you want to syntax highlight source listings, you'll also want to install Rouge, Pygments, or CodeRay. Choose one (or more) of the following: |