From ca29e4f585632d38866f75fbe6cd395d364518fc Mon Sep 17 00:00:00 2001 From: chrisfinazzo Date: Mon, 28 Sep 2015 21:31:27 -0400 Subject: [PATCH] Feedback from @parkr, rephrasing, and link to Ruby managers --- site/_docs/troubleshooting.md | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/site/_docs/troubleshooting.md b/site/_docs/troubleshooting.md index 4a1a2b91..daf0764d 100644 --- a/site/_docs/troubleshooting.md +++ b/site/_docs/troubleshooting.md @@ -71,15 +71,17 @@ Line Tools. With the introduction of System Integrity Protection, several directories that were previously writable are now considered system locations and are no longer available. As a result, it is recommended that you choose one of a -number of available Ruby environments ([RVM][], [rbenv][], [chruby][], etc.) in +number of Ruby version managers ([RVM][], [rbenv][], [chruby][], [etc][].) in which to install Jekyll. [RVM]: https://rvm.io [rbenv]: http://rbenv.org [chruby]: https://github.com/postmodern/chruby +[etc]: https://github.com/rvm/rvm/blob/master/docs/alt.md -If you elect to use a method other than Homebrew to install Ruby, it may be -necessary to modify your `$PATH` variable using the following command: +If you elect to use a method other than those listed above to install +Ruby (such as Homebrew), it may be necessary to modify your `$PATH` +variable using the following command: {% highlight bash %} export PATH=/usr/local/bin:$PATH @@ -91,11 +93,14 @@ GUI apps can modify the `$PATH` as follows: launchctl setenv PATH "/usr/local/bin:$PATH" {% endhighlight %} +Once you've done that, `brew install ruby` and `gem install jekyll` should work +as expected. + This approach is useful because `/usr/local` is considered a "safe" location on systems which have SIP enabled, it avoids potential conflicts with the version of Ruby included by Apple, and it keeps Jekyll and its -dependencies in a sandboxed environment. Therefore, individual gems -can be added or removed according to your specific needs. +dependencies in a sandboxed environment. Therefore, individual gems can be +added or removed according to your specific needs. To install RubyGems on Gentoo: