dan
/
jekyll
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add a note about troubleshooting on installation page

This commit is contained in:
Frank Taillandier 2017-01-24 20:21:34 +01:00
parent 84e9ea82d1
commit b1edaea7e8
1 changed files with 5 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
docs/_docs/installation.md
View File

@ -25,16 +25,11 @@ Before you start, make sure your system has the following:
- [Python 2.7](https://www.python.org/downloads/) - [Python 2.7](https://www.python.org/downloads/)
<div class="note info"> <div class="note info">
<h5>Running Jekyll on Ubuntu</h5> <h5>Problems installing Jekyll?</h5>
<p> <p>
Users of Jekyll on Ubuntu have reported encountering Check out the <a href="../troubleshooting/">troubleshooting</a> page or
<i>Could not locate Gemfile or .bundle/ directory</i> error messages at the <a href="{{ site.repository }}/issues/new">report an issue</a> so the
<code>bundle exec jekyll serve</code> step in the <a href="../quickstart/">Quick-start guide</a>. Jekyll community can improve the experience for everyone.
The likely cause is that all installation requirements have not been fully met.
Recent stock Ubuntu distributions require the installation of both the <code>ruby</code> and <code>ruby-all-dev</code>
packages, e.g. via <code>sudo apt-get install ruby ruby-all-dev</code> (RubyGems should be included in <code>ruby</code>).
The <code>ruby-all-dev</code> .deb package in particular contains development header files whose absence causes
the above error message.
</p> </p>
</div> </div>
@ -58,10 +53,7 @@ $ gem install jekyll
``` ```
All of Jekyll’s gem dependencies are automatically installed by the above All of Jekyll’s gem dependencies are automatically installed by the above
command, so you won’t have to worry about them at all. If you have problems command, so you won’t have to worry about them at all.
installing Jekyll, check out the [troubleshooting](../troubleshooting/) page or
[report an issue]({{ site.repository }}/issues/new) so the Jekyll
community can improve the experience for everyone.
<div class="note info"> <div class="note info">
<h5>Installing Xcode Command-Line Tools</h5> <h5>Installing Xcode Command-Line Tools</h5>