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

Add Ubuntu section on troubleshooting

This commit is contained in:
Frank Taillandier 2017-01-24 20:23:01 +01:00
parent b1edaea7e8
commit 7397f305c2
1 changed files with 13 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
docs/_docs/troubleshooting.md
View File

@ -36,6 +36,15 @@ If you installed the above - specifically on Fedora 23 - but the extensions woul
sudo dnf install redhat-rpm-config sudo dnf install redhat-rpm-config
``` ```
On Ubuntu if you get stuck after `bundle exec jekyll serve` and see error
messages like `Could not locate Gemfile` or `.bundle/ directory`, it's likely
because all requirements have not been fully met. Recent stock Ubuntu
distributions require the installation of both the `ruby` and `ruby-all-dev`
packages:
```sh
sudo apt-get install ruby ruby-all-dev
```
On [NearlyFreeSpeech](https://www.nearlyfreespeech.net/) you need to run the On [NearlyFreeSpeech](https://www.nearlyfreespeech.net/) you need to run the
following commands before installing Jekyll: following commands before installing Jekyll:
@ -180,10 +189,10 @@ That is: defaults are overridden by options specified in `_config.yml`,
and flags specified at the command-line will override all other settings and flags specified at the command-line will override all other settings
specified elsewhere. specified elsewhere.
If you encounter an error in building the site, with the error message If you encounter an error in building the site, with the error message
"'0000-00-00-welcome-to-jekyll.markdown.erb' does not have a valid date in the "'0000-00-00-welcome-to-jekyll.markdown.erb' does not have a valid date in the
YAML front matter." try including the line `exclude: [vendor]` YAML front matter." try including the line `exclude: [vendor]`
in `_config.yml`. in `_config.yml`.
## Markup Problems ## Markup Problems