How do I use Jekyll in a subdirectory?

Question

Jekyll assumes that the generated site will be served from the root directory, and subsequently all of the links are absolute beginning with "/". I'd like to serve out a blog from a subdirectory, ie, http://www.example.com/~user/blog .

Setting permalink variable ( http://jekyllrb.com/docs/permalinks/ ) would be a partial fix, but doesn't address other things such as css files.

I'll be glad for any pointers.

Answer 1

You want to use the baseurl config option in your _config.yml file. Permalinks will then be relative to that. See the Jekyll docs for the baseurl option: http://jekyllrb.com/docs/configuration/

Assuming you are using at least Jekyll 1.0.0.