From b9791014ded7f8d5eccbb5589e5130f8772bf5f2 Mon Sep 17 00:00:00 2001 From: Arno Gourdol Date: Wed, 30 Jan 2019 10:03:32 -0800 Subject: [PATCH 1/2] Incompatibility with ImageMagick 7 Added note and workaround about incompatibility with ImageMagick 7 --- README.md | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 08932db..73bb37f 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,19 @@ Either add `jekyll-responsive-image` to your Gemfile, or run the following comma $ gem install jekyll-responsive-image ``` +> **Note:** `jekyll-responsive-image` uses `rmagick` which is currently incompatible with `imagemagick 7`. If you get an error like: +> +> ``` +> Can't install RMagick 2.16.0. Can't find MagickWand.h +> ``` +> make sure you have `imagemagick 6` installed: +> +> ``` +> $ brew uninstall imagemagick +> $ brew install imagemagick@6 && brew link imagemagick@6 --force +> ``` + + Then you can either add `jekyll-responsive-image` to the `plugins` section of your `_config.yml`: ```yaml @@ -231,4 +244,4 @@ If you'd like your Jekyll project to use your local fork directly, you can add t gem 'jekyll-responsive-image', :path => "/your/local/path/to/jekyll-responsive-image" ``` -If you'd like your changes to be considered for the original repository, simply submit a pull request after you've made your changes. Please make sure all tests pass. \ No newline at end of file +If you'd like your changes to be considered for the original repository, simply submit a pull request after you've made your changes. Please make sure all tests pass. From 6444d327de2b9ac719ee223a5f3a4a5be68a201a Mon Sep 17 00:00:00 2001 From: Joseph Wynn Date: Mon, 4 Feb 2019 14:36:44 +1300 Subject: [PATCH 2/2] Create a "Troubleshooting" section --- README.md | 30 +++++++++++++++++------------- 1 file changed, 17 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index 73bb37f..f762cb7 100644 --- a/README.md +++ b/README.md @@ -17,19 +17,6 @@ Either add `jekyll-responsive-image` to your Gemfile, or run the following comma $ gem install jekyll-responsive-image ``` -> **Note:** `jekyll-responsive-image` uses `rmagick` which is currently incompatible with `imagemagick 7`. If you get an error like: -> -> ``` -> Can't install RMagick 2.16.0. Can't find MagickWand.h -> ``` -> make sure you have `imagemagick 6` installed: -> -> ``` -> $ brew uninstall imagemagick -> $ brew install imagemagick@6 && brew link imagemagick@6 --force -> ``` - - Then you can either add `jekyll-responsive-image` to the `plugins` section of your `_config.yml`: ```yaml @@ -203,6 +190,23 @@ responsive_image: - assets/avatars/*.{jpeg,jpg} ``` +## Troubleshooting + +### Error: Can't install RMagick + +`jekyll-responsive-image` uses `rmagick` which is currently incompatible with ImageMagick 7. If you get an error like: + +``` +Can't install RMagick 2.16.0. Can't find MagickWand.h +``` + +Then you will need to install ImageMagick 6. If you are using Homebrew on Mac OS, this can be done with the following commands: + +``` +$ brew uninstall imagemagick +$ brew install imagemagick@6 && brew link imagemagick@6 --force +``` + ## Caching You may be able to speed up the build of large sites by enabling render caching. This is usually only effective when the same image is used many times, for example a header image that is rendered in every post.