From 95a2c74f1224547837ee301a57f1f9b2c71f6e47 Mon Sep 17 00:00:00 2001 From: Jashank Jeremy Date: Wed, 5 Feb 2014 10:30:49 +1100 Subject: [PATCH 1/2] Document site cleanup behaviour. As per #2014, document the fact that the destination directory is 'cleaned up', such that "obsolete" files (files which do not have a known input Page, Post or StaticFile) are deleted, when a site is rebuilt. Resolves #2014. [ci skip] --- site/docs/usage.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/site/docs/usage.md b/site/docs/usage.md index 6db3a112..2891dc07 100644 --- a/site/docs/usage.md +++ b/site/docs/usage.md @@ -24,6 +24,18 @@ $ jekyll build --watch # watched for changes, and regenerated automatically. {% endhighlight %} +
+
Destination folders are cleaned on site builds
+

+ Be aware that the contents of the <destination> + folder are automatically cleaned when the site is built. Files or + folders that are not created by your site will be removed. Do not + use an important location for <destination>; + instead, use it as a staging area and copy files from there to + your web server. +

+
+ Jekyll also comes with a built-in development server that will allow you to preview what the generated site will look like in your browser locally. From 67a54547ed64682b9b3b0ae533e2d39f26c01e39 Mon Sep 17 00:00:00 2001 From: Jashank Jeremy Date: Wed, 5 Feb 2014 10:38:16 +1100 Subject: [PATCH 2/2] Clarifying wording of the destination directory warning. At some point, it should also be clarified whether "folder" or "directory" is the correct way to refer to that concept. --- site/docs/usage.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/site/docs/usage.md b/site/docs/usage.md index 2891dc07..6f5c9a3b 100644 --- a/site/docs/usage.md +++ b/site/docs/usage.md @@ -27,12 +27,11 @@ $ jekyll build --watch
Destination folders are cleaned on site builds

- Be aware that the contents of the <destination> - folder are automatically cleaned when the site is built. Files or - folders that are not created by your site will be removed. Do not - use an important location for <destination>; - instead, use it as a staging area and copy files from there to - your web server. + The contents of <destination> are automatically + cleaned when the site is built. Files or folders that are not + created by your site will be removed. Do not use an important + location for <destination>; instead, use it as + a staging area and copy files from there to your web server.