Jekyll site won't display on GitHub Pages

3
votes

I am trying to use GitHub Pages with Jekyll. I have created a repo named:myusername.github.io where myusername is exactly the same as my github username. I am using Jekyll to create the site. I have it setup locally on my machine and have tested the page using:

jekyll serve

There are no issues running the site locally. I have pushed the Jekyll site to my repo. However, when I go to myusername.github.io I just see a blank white page. What am I doing wrong here? I have tested to see if GitHub Pages is working by adding an index.html file to the repo and this will display correctly. However for some reason the Jekyll site is not displaying at all. What am I doing wrong here?

EDIT:

My process to create the page was like so:

jekyll new mysite
cd mysite
git init
git add .
git remote add origin https://github.com/myusername/myusername.github.io.git
git push -u origin master

repo looks like this:

enter image description here

1
githubjekyllgithub-pages
Have you checked to see if there were any build errors? - Aurora0001
how do I do this? - KexAri
You should be able to follow the link in my comment which shows you how to do that. - Aurora0001
Just checked. No build errors displayed there at all. It also runs fine locally. - KexAri
@Aurora0001 edited my question with more details. - KexAri

1 Answers

1
votes

While your site is properly setup to use jekyll, it's probably using ruby gems that are not available to github-pages.

The only lines that you're supposed to have in your Gemfile are:

source 'https://rubygems.org'
gem 'github-pages', group: :jekyll_plugins

Any other gems or includes may not be available to Github Pages, causing the jeykll biuld to fail