diff --git a/site/_docs/github-pages.md b/site/_docs/github-pages.md index f126db0d..630bab5a 100644 --- a/site/_docs/github-pages.md +++ b/site/_docs/github-pages.md @@ -54,6 +54,14 @@ actual software project for Jekyll, however the Jekyll website (that you’re looking at right now) is contained in the [gh-pages branch]({{ site.repository }}/tree/gh-pages) of the same repository. +
+
Source Files Must be in the Root Directory
+

Github Pages [overrides](https://help.github.com/articles/troubleshooting-github-pages-build-failures#source-setting) the ["Site Source"](http://jekyllrb.com/docs/configuration/#global-configuration) configuration value, so if you locate your files anywhere other than the root directory, your site may not build correctly. + +

+
+ + ### Project Page URL Structure Sometimes it's nice to preview your Jekyll site before you push your `gh-pages`