Add note about running Jekyll with bundle exec

This commit is contained in:
unknown 2014-11-11 11:31:40 -05:00
parent 5b4f70bdc6
commit 7b496f8b16

View file

@ -39,6 +39,22 @@ If you want to use So Simple with an existing Jekyll site follow these steps:
--- ---
## Running Jekyll
If `jekyll build` and `jekyll serve` throw errors you may have to run Jekyll with `bundled exec` instead.
> In some cases, running executables without bundle exec may work, if the executable happens to be installed in your system and does not pull in any gems that conflict with your bundle.
>
>However, this is unreliable and is the source of considerable pain. Even if it looks like it works, it may not work in the future or on another machine.
{% highlight text %}
bundle exec jekyll build
bundle exec jekyll serve
{% endhighlight %}
---
## Scaffolding ## Scaffolding
How So Simple is organized and what the various files are. All posts, layouts, includes, stylesheets, assets, and whatever else is grouped nicely under the root folder. The compiled Jekyll site outputs to `_site/`. How So Simple is organized and what the various files are. All posts, layouts, includes, stylesheets, assets, and whatever else is grouped nicely under the root folder. The compiled Jekyll site outputs to `_site/`.