Skip to content
This repository
  • Watch
  • Unstar Star
  • Fork

public / jekyll Octocat-spinner-32

HTTPS clone URL

SSH clone URL

Subversion checkout URL

You can clone with HTTPS, SSH, or Subversion.

Clone in Desktop Download ZIP
New issue

links on index page in gh-pages branch go to 404 pages #2182

Open
tararoys opened this Issue · 1 comment

Labels

Milestone

No milestone

Assignee

No one assigned

Notifications

You are receiving notifications because you authored the thread.

2 participants

tararoys Blake Erickson
tararoys
tararoys commented

The content you are editing has changed. Reload the page and try again.

I just tried to create my first github pages blog. I followed the instructions, created a new branch called github-pages, and pushed to this repository.

I followed the basic install instructions on http://jekyllrb.com/, and everything looked fine on my local server. I created a new branch called 

gh-pages

https://github.com/tararoys/simple-documentation-process/tree/gh-pages

According to my settings page, I have a website at

http://tararoys.github.io/simple-documentation-process

If I go to that page, a site showing links to two blogs posts appears. If I click on the first blog post, I am taken to the address 

http://tararoys.github.io/jekyll/update/2014/03/30/welcome-to-jekyll.html

According to Github, this page does not exist.

So it seems like something is going wrong. As a total jekyll newbie, I have no idea what. If it would be useful, I do have a transcript of every shell command I used, if that would be helpful.

Sending Request…

Attach images by dragging & dropping, selecting them, or pasting from the clipboard. Octocat-spinner-32 Uploading your images… Unfortunately, we don't support that file type. Try again with a PNG, GIF, or JPG. Yowza, that's a big file. Try again with an image file smaller than 10MB. This browser doesn't support image attachments. We recommend updating to the latest Internet Explorer, Google Chrome, or Firefox. Something went really wrong, and we can't process that image. Try again.

Blake Erickson
oblakeerickson commented

You will need to setup your baseurl so that it knows everything lives in the "simple-documentation-process" url. You can do this by adding baseurl: /simple-documentation-process to your 'config.yml' file. And then in your templates you will need to include {{ site.baseurl }} before the links to your posts.

This article should also help explain more about how to setup the baseurl.

tararoys tararoys referenced this issue from a commit in tararoys/simple-documentation-process
tararoys Bugfix attempt for github pages 404 error … 
When I pushed this jekyll blog to github, the links on the index
page went to 404 messages.

jekyll/jekyll#2182

The fix: adding baseurls to my _config.yaml and all of my links.

A baseurl is like the tent you store all of your personal effects in.
By not having a baseurl, I was telling github that my stuff was scattered
all over my campground.  Because of the way github sets things up,
a tent is more or less connected to a repository.  So when I clicked on the
link
http://tararoys.github.io/jekyll/update/2014/03/30/welcome-to-jekyll.html,
it went looking for a github pages project on my account calle 'jekyll'
a different 'tent.' than the tent called simple-documentation-process.
So my index page was in simple-documentation-process, but the links
told github to look for a different project (a different 'tent') on my account called jekyll,
and since I don't have such a project, it was giving me 404 error pages.

The fix is sort of mentioned in this section of the github documentaion,
http://jekyllrb.com/docs/github-pages/#project_page_url_structure, but I would
not have known to follow that set of instructions debugged it without
the help of a comment from somebody experienced in the issue tracker.

I feel that setting up a jekyll blog on github is a 'common' task. On the
other hand, having spend seven years without github training, it's probably
a lot less commen than I would like to think, and my instict says that
people like me who try to set up a jekyll blog and run into this issue and
don't persist long enough to solve it are a lot more common than people who
throw the issue into the issue tracker.

I wonder how many new users run into this issue and don't ever solve it?
Also, I haven't actually tested this on github paged yet, nad I can't until
I finish this commit message.
 2693c8a
tararoys tararoys referenced this issue in tararoys/simple-documentation-process
Merged

Pull Request #1: Bugfix attempt for github pages 404 error

tararoys
Comments are parsed with GitHub Flavored Markdown

Attach images by dragging & dropping, selecting them, or pasting from the clipboard. Octocat-spinner-32 Uploading your images… Unfortunately, we don't support that file type. Try again with a PNG, GIF, or JPG. Yowza, that's a big file. Try again with an image file smaller than 10MB. This browser doesn't support image attachments. We recommend updating to the latest Internet Explorer, Google Chrome, or Firefox. Something went really wrong, and we can't process that image. Try again.

Nothing to preview

Something went wrong with that request. Please try again.