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]
This commit is contained in:
Jashank Jeremy 2014-02-05 10:30:49 +11:00
parent 272ba86ae4
commit 95a2c74f12
1 changed files with 12 additions and 0 deletions

View File

@ -24,6 +24,18 @@ $ jekyll build --watch
# watched for changes, and regenerated automatically.
{% endhighlight %}
<div class="note warning">
<h5>Destination folders are cleaned on site builds</h5>
<p>
Be aware that the contents of the <code>&lt;destination&gt;</code>
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 <code>&lt;destination&gt;</code>;
instead, use it as a staging area and copy files from there to
your web server.
</p>
</div>
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.