How to deal with differing site roots between environments?

[ariofrio]

When I run jekyll --server my site is available at http://localhost:4000/, but when I deploy to GitHub Project Pages, it's available at http://username.github.com/projectname/.

This means that I cannot use absolute URLs when referring to stylesheets and other resources. Relative URLs break when the same layout is used by e.g. index.html and 2012/01/01/happy-new-year.html. What is the-accepted/a-good way of adding stylesheets and other resources to a GitHub Project Pages repository?

Cross-posted from Stack Overflow.

[why-el]

I used something like {{site.url}}/some_relative_path to solve these issues. Site.url will evaluate to whatever current root is.

[parkr]

@why-el nailed it. Use site.url. You can set it with baseurl in your _config.yml.

[ljvasey]

This article in the official Jekyll docs deals with how to set up your _config.yml and your local server to work perfectly with Github pages.

It has very clear and simple instructions about how to avoid this exact issue :)