Jekyll - Troubleshooting

  1. http://downtothewire.io/2015/08/15/configuring-jekyll-for-user-and-project-github-pages/

all styles are gone

in Chrome Console:

GET http://tap349.github.io/postgresql/rails/2017/07/20/postgresql-tips/public/css/hyde.css

_includes/head.html:

<link rel="stylesheet" href="{{ site.baseurl }}public/css/hyde.css">

it looks like site.baseurl is always set to current url - that’s why assets are searched for in wrong location.

solution

prefix all occurrences of site.baseurl with site.url (effectively, use absolute urls instead of relative ones).

_includes/head.html:

<link rel="stylesheet" href="{{ site.url }}/{{ site.baseurl }}public/css/hyde.css">

Page build failed

in email from GitHub:

The page build failed for the `master` branch with the following error:
Page build failed. For more information, see ...

solution

build Jekyll site manually to find out the reason:

$ blog
$ bundle exec jekyll build