From 269018b0110133e5fdb9f508e300eed19fdc6b4d Mon Sep 17 00:00:00 2001 From: chrisfinazzo Date: Sun, 27 Sep 2015 15:49:24 -0400 Subject: [PATCH 1/3] Instructions for El Capitan --- site/_docs/troubleshooting.md | 33 ++++++++++++++++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/site/_docs/troubleshooting.md b/site/_docs/troubleshooting.md index 602d62a3..4a1a2b91 100644 --- a/site/_docs/troubleshooting.md +++ b/site/_docs/troubleshooting.md @@ -60,12 +60,43 @@ which may allow you to install native gems using this command (again using sudo gem install jekyll {% endhighlight %} -Note that upgrading MacOS X does not automatically upgrade Xcode itself +Note that upgrading Mac OS X does not automatically upgrade Xcode itself (that can be done separately via the App Store), and having an out-of-date Xcode.app can interfere with the command line tools downloaded above. If you run into this issue, upgrade Xcode and install the upgraded Command Line Tools. +### Jekyll & Mac OS X 10.11 + +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 +which to install Jekyll. + +[RVM]: https://rvm.io +[rbenv]: http://rbenv.org +[chruby]: https://github.com/postmodern/chruby + +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: + +{% highlight bash %} +export PATH=/usr/local/bin:$PATH +{% endhighlight %} + +GUI apps can modify the `$PATH` as follows: + +{% highlight bash %} +launchctl setenv PATH "/usr/local/bin:$PATH" +{% endhighlight %} + +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. + To install RubyGems on Gentoo: {% highlight bash %} From ca29e4f585632d38866f75fbe6cd395d364518fc Mon Sep 17 00:00:00 2001 From: chrisfinazzo Date: Mon, 28 Sep 2015 21:31:27 -0400 Subject: [PATCH 2/3] 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: From 9c9481a8a99bd3bbee10bb9f9feca23f97b9a30d Mon Sep 17 00:00:00 2001 From: chrisfinazzo Date: Wed, 30 Sep 2015 12:57:09 -0400 Subject: [PATCH 3/3] Notes for Homebrew, advanced installs, and cleanup --- site/_docs/troubleshooting.md | 52 +++++++++++++++++++++-------------- 1 file changed, 31 insertions(+), 21 deletions(-) diff --git a/site/_docs/troubleshooting.md b/site/_docs/troubleshooting.md index daf0764d..cf0c3d8e 100644 --- a/site/_docs/troubleshooting.md +++ b/site/_docs/troubleshooting.md @@ -40,6 +40,15 @@ export PATH=$PATH:/home/private/gems/bin export RB_USER_INSTALL='true' {% endhighlight %} +To install RubyGems on Gentoo: + +{% highlight bash %} +sudo emerge -av dev-ruby/rubygems +{% endhighlight %} + +On Windows, you may need to install [RubyInstaller +DevKit](https://wiki.github.com/oneclick/rubyinstaller/development-kit). + On Mac OS X, you may need to update RubyGems (using `sudo` only if necessary): {% highlight bash %} @@ -70,7 +79,21 @@ 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 +longer available. Given these changes, the simplest way to get up and running +is to install Homebrew and then use it to set up Ruby. This can be done as +follows: + +{% highlight bash %} +ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" +{% endhighlight %} + +Once Homebrew is installed, the second step is easy: + +{% highlight bash %} +brew install ruby +{% endhighlight %} + +Advanced users (with more complex needs) may find it helpful to choose one of a number of Ruby version managers ([RVM][], [rbenv][], [chruby][], [etc][].) in which to install Jekyll. @@ -79,9 +102,8 @@ which to install Jekyll. [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 those listed above to install -Ruby (such as Homebrew), it may be necessary to modify your `$PATH` -variable using the following command: +If you elect to use one of the above methods to install Ruby, it might be +necessary to modify your `$PATH` variable using the following command: {% highlight bash %} export PATH=/usr/local/bin:$PATH @@ -93,23 +115,11 @@ 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. - -To install RubyGems on Gentoo: - -{% highlight bash %} -sudo emerge -av dev-ruby/rubygems -{% endhighlight %} - -On Windows, you may need to install [RubyInstaller -DevKit](https://wiki.github.com/oneclick/rubyinstaller/development-kit). +Either of these approaches are useful because `/usr/local` is considered a +"safe" location on systems which have SIP enabled, they avoid potential +conflicts with the version of Ruby included by Apple, and it keeps Jekyll and +its dependencies in a sandboxed environment. This also has the added +benefit of not requiring `sudo` when you want to add or remove a gem. ### Could not find a JavaScript runtime. (ExecJS::RuntimeUnavailable)