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. # watched for changes, and regenerated automatically.
{% endhighlight %} {% 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 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. preview what the generated site will look like in your browser locally.