Get Started With GitHub Pages (Plus Bonus Jekyll)

17 Comments

Comments are ordered by helpfulness, as indicated by you. Help us pick out the gems and discourage asshattery by voting on notable comments.

Got something to add? You can leave a comment below.

  1. Patrick Grey

    Good article, thanks.

    It is always good to understand the basics before using framework tools but once you are up and running, it may be worth looking into Yeoman.io and the Jekyll generator

    It will scaffold out your Jekyll site and also livereload your page when you save files (saving that trip to F5) and optimise your build when you are ready to push to github. It has improved my workflow greatly. It can take some effort to set up but even I got it running on Windows, and I’m an idiot! :-)

    Cheers,
    Patrick

  2. Agustin

    Great article!
    On a side note, there is an amazing Yeoman generator for Jekyll pages by Rob Wierzbowski https://github.com/robwierzbowski/generator-jekyllrb, makes building Jekyll sites a breeze.

  3. Pengfei.X

    I think the documents on Github and JekyII sucks, I can’t setup my blog from those docs, I need to try a lot to see if it works in this way or the other .

    This is a good one, :)

  4. Rudie

    @sudo@ should never be necessary. Once you go @sudo@, you can’t go back. Better to @chown@ everything to yourself, so you never need @sudo@.

  5. @cwebba1

    I am excited to try Jekyll. Working on this tutorial now. I have successfully installed Jekyll and installed the documents into an orphan git branch. I have “Jekyll serve —watch” running. I can see Jekyll updating in the terminal whenever I make a change in the folder.

    Where I am stuck is that http://localhost:4000/ is not found in my browser. I get `/’ not found. I’m searching for a way to get it working and navigate to my project folder via localhost:4000/

    Any pointers at this juncture would be appreciated.

  6. Rob

    Great post and very timely for me. I’ve moved away from WordPress for my personal site and thought I’d give Jekyll/GitHub pages a go.

    Getting Jekyll set up and working locally felt like torture. I have an irrational fear of the command line and this seemed like the only way to install it.

    After many tears, installations of the latest version of Ruby, Sudo, command line tools in Xcode, JSON and rdiscount I started to wonder why the hell I bothered!

    I stuck with it and got through the other side will all my limbs and my sanity intact. I’d say the hassle of initial setup is well worth it.

    I’ve got loads more to learn and explore but it feels so nice not having to tip-toe around PHP snippets to build webpages.

    Do it today Dessy!

  7. Ed Henderson

    Nice writeup. I wish it existed when I first worked this all out. Maybe beyond the scope of this article but if you are throwing recipes onto the Internet you can mark them up super nicely with Microdata / Rich Snippets. Check out:

    * https://support.google.com/webmasters/answer/173379?hl=en
    * http://schema.org/Recipe

    I implemented them recently at work and it proved to be quite easy but allows you to be a bit more prominent in the Search Engines.

    E.

  8. Harry Moreno

    Cool I wish I read this when I made mine. morenoh149.github.io I used bootstrap as well the source is here https://github.com/morenoh149/morenoh149.github.io I just push to master and it works for me. Don’t know why you had to change the default.

  9. Paul Mist

    Great article, Anna – thank you.

    I like Jekyll, but one thing I’d love to find a solution to is stopping Jekyll from rebuild the entire site every time there’s a change.

    I understand why it does this, but wish there was a way to override it.

    Happy Christmas!

  10. Tony

    I make a service that is similar to GitHub pages, but without the git portion. It relies on Dropbox, so you just save files (or generate from Jekyll) in Dropbox, and it goes live. It’s called paperplane.io. We use a similar approach described here to manage our own blog: http://blog.paperplane.io, and it works well for us.

  11. Andreas

    Nice post! I’ll give it a try!

    At least I need a little php for a comment system and a contact form. Perhaps services like Disqus can provide a comment system in a github-page. But how to handle a contact form? Any ideas?

Impress us

Be friendly / use Textile