The blog posts are not built in GitHub Pages Server


For now, I have an issue about the blog posts are not built in GitHub Pages Server.

I see the empty content as I push my blog posts to GitHub Pages Server.

I have checked via bundle exec jekyll serve --safe in localhost and it works very well.

System information as following

$ uname -a
Linux Y410P 4.14.39-1-MANJARO 
$ ruby -v      
ruby 2.5.1p57 (2018-03-29 revision 63029) [x86_64-linux]

The plugin information as following

Using public_suffix 3.0.2
Using addressable 2.5.2
Using bundler 1.16.1
Using colorator 1.1.0
Using ffi 1.9.23
Using forwardable-extended 2.6.0
Using rb-fsevent 0.10.3
Using rb-inotify 0.9.10
Using sass-listen 4.0.0
Using sass 3.5.6
Using jekyll-sass-converter 1.5.2
Using ruby_dep 1.5.0
Using listen 3.1.5
Using jekyll-watch 1.5.1
Using kramdown 1.16.2
Using liquid 4.0.0
Using mercenary 0.3.6
Using pathutil 0.16.1
Using rouge 2.2.1
Using safe_yaml 1.0.4
Using jekyll 3.6.2
Using jekyll-multiple-languages-plugin 1.5.1
Using jekyll-paginate 1.1.0
Using multi_json 1.13.1
Using pygments.rb 1.2.1

My Blog Source code

I have checked the following setting. For now, I think they are correct.

I try JEKYLL_ENV=production bundle exec jekyll build and push to GitHub Pages Server. But it doesn’t success.

_site folder is already in Github repo. But I can’t see my markdown blog posts in Github Page Server. It only works in localhost.

Any Suggestion? Thank you

My guess is Github Pages doesn’t like one of your plugins. Here’s the list of approved plugins for Github Pages:

If the issue is indeed an offending plugin, you have a few options:

  1. Try to find alternatives to the un-supported plugins. I recommend using the github-pages gem in place of your plugins to ensure your local build matches that of Github Pages. [A]
  2. Build the site locally (or use a CI service) and just publish the _site folder to your repo.
  3. Host elsewhere (I’m a fan of Netlify, but there are many others)

[A] If memory serves me right, the --safe flag only ignores custom plugins (i.e. gem-based plugins still get run). That’s why you were still able to generate the site locally without issue.

1 Like

Dear @ckruse

Thank you for your hints.

I chose your options of publish content of _site to repo, to add CI service later.

Also, thank you for recommend Netlify, I do not know it before.

Best regards, Gapry.

1 Like