significant rewrite of baseurl section for clarity, props mattr-

This commit is contained in:
Benjamin J. Balter 2013-04-15 16:25:40 -04:00
parent db31c1a453
commit 3bf38ad0d3
1 changed files with 7 additions and 5 deletions

View File

@ -82,8 +82,10 @@ and add a new markdown file to it. To preview your new post, simply run the
Often, you'll want the ability to run a Jekyll site in multiple places, such as Often, you'll want the ability to run a Jekyll site in multiple places, such as
previewing locally before pushing to GitHub Pages. Jekyll 1.0 makes that previewing locally before pushing to GitHub Pages. Jekyll 1.0 makes that
easier with the new `--baseurl` flag. Throughout your Jekyll site, simply easier with the new `--baseurl` flag. To take advantage of this feature, first
prefix relative urls with `{{ site.baseurl }}` and add the production `baseurl` add the production `baseurl` to your site's `_config.yml` file. Then,
to your `_config.yml` file. When previewing locally, Jekyll will swap in throughout the site, simply prefix relative URLs with `{{ site.baseurl }}`.
whatever you pass along via the `--baseurl` flag (most likely `/`), ensuring When you're ready to preview your site locally, pass along the `--baseurl` flag
your links remain true in both environments. with your local baseurl (most likely `/`) to `jekyll serve` and Jekyll will
swap in whatever you've passed along, ensuring all your links work as you'd
expect in both environments.