commit 9f75a51854d51834ea9462f5b02d6cdea5b11467
parent fd7b315572bbb4fddc7d6c3c9e3fe92c3ac15439
Author: jlengstorf <jason.lengstorf@copterlabs.com>
Date: Sat, 5 Sep 2015 15:38:55 +0200
Added details about generated files and development flows
Diffstat:
1 file changed, 16 insertions(+), 0 deletions(-)
diff --git a/docs/content/overview/usage.md b/docs/content/overview/usage.md
@@ -145,6 +145,22 @@ static web hosting services.
[CloudFront]: http://aws.amazon.com/cloudfront/ "Amazon CloudFront"
+### A note about deployment
+
+Running `hugo` *does not* remove generated files before building. This means that you should delete your `public/` directory (or the directory you specified with `-d`/`--destination`) before running the `hugo` command, or you run the risk of the wrong files (e.g. drafts and/or future posts) being left in the generated site.
+
+An easy way to work around this is to use different directories for development and production.
+
+To start a server that builds draft content (helpful for editing), you can specify a different destination: the `dev/` dir.
+
+ hugo server -wDs ~/Code/hugo/docs -d dev
+
+When the content is ready for publishing, use the default `public/` dir:
+
+ hugo -s ~/Code/hugo/docs
+
+This prevents content you're not ready to share yet from accidentally becoming available.
+
### Alternatively, serve your web site with Hugo!
Yes, that's right! Because Hugo is so blazingly fast both in web site creation