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

Be (mostly) anal-retentive about line columns. 🌽 😛

This commit is contained in:
Parker Moore 2013-07-11 00:14:38 +02:00
parent 07896a2923
commit d10007182d
1 changed files with 16 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
site/docs/troubleshooting.md
View File

@ -6,7 +6,10 @@ next_section: sites
permalink: /docs/troubleshooting/ permalink: /docs/troubleshooting/
--- ---
If you ever run into problems installing or using Jekyll, here’s a few tips that might be of help. If the problem you’re experiencing isn’t covered below, please [report an issue](https://github.com/mojombo/jekyll/issues/new) so the Jekyll community can make everyone’s experience better. If you ever run into problems installing or using Jekyll, here's a few tips
that might be of help. If the problem you’re experiencing isn’t covered below,
please [report an issue](https://github.com/mojombo/jekyll/issues/new) so the
Jekyll community can make everyone’s experience better.
## Installation Problems ## Installation Problems
@ -24,7 +27,8 @@ On Red Hat, CentOS, and Fedora systems you can do this by running:
sudo yum install ruby-devel sudo yum install ruby-devel
{% endhighlight %} {% endhighlight %}
On [NearlyFreeSpeech](http://nearlyfreespeech.net/) you need to run the command with the following environment variable: On [NearlyFreeSpeech](http://nearlyfreespeech.net/) you need to run the
command with the following environment variable:
{% highlight bash %} {% highlight bash %}
RB_USER_INSTALL=true gem install jekyll RB_USER_INSTALL=true gem install jekyll
@ -36,7 +40,9 @@ On OSX, you may need to update RubyGems:
sudo gem update --system sudo gem update --system
{% endhighlight %} {% endhighlight %}
- If you still have issues, you may need to [use XCode to install Command Line Tools](http://www.zlu.me/blog/2012/02/21/install-native-ruby-gem-in-mountain-lion-preview/) that will allow you to install native gems using If you still have issues, you may need to [use XCode to install Command Line
Tools](http://www.zlu.me/blog/2012/02/21/install-native-ruby-gem-in-mountain-lion-preview/)
that will allow you to install native gems using the following command:
{% highlight bash %} {% highlight bash %}
sudo gem install jekyll sudo gem install jekyll
@ -53,7 +59,8 @@ DevKit](http://wiki.github.com/oneclick/rubyinstaller/development-kit).
## Problems running Jekyll ## Problems running Jekyll
On Debian or Ubuntu, you may need to add /var/lib/gems/1.8/bin/ to your path in order to have the `jekyll` executable be available in your Terminal. On Debian or Ubuntu, you may need to add `/var/lib/gems/1.8/bin/` to your path
in order to have the `jekyll` executable be available in your Terminal.
## Base-URL Problems ## Base-URL Problems
@ -77,14 +84,16 @@ http://localhost:4000/blog
## Configuration problems ## Configuration problems
The order of precedence for conflicting [configuration settings](../configuration)
The order of precedence for conflicting [configuration settings](../configuration) is as follows: is as follows:
1. Command-line flags 1. Command-line flags
2. Configuration file settings 2. Configuration file settings
3. Defaults 3. Defaults
That is: defaults are overridden by options specified in `_config.yml`, and flags specified at the command-line will override all other settings specified elsewhere. That is: defaults are overridden by options specified in `_config.yml`,
and flags specified at the command-line will override all other settings
specified elsewhere.
## Markup Problems ## Markup Problems