Docs: improve quickstart guide
authordigitalcraftsman <digitalcraftsman@users.noreply.github.com>
Fri, 27 Nov 2015 14:21:22 +0000 (15:21 +0100)
committerAnthony Fok <foka@debian.org>
Fri, 27 Nov 2015 22:40:16 +0000 (15:40 -0700)
Fixes #1553

docs/content/overview/quickstart.md

index 202ddbaf20a7a931a90f93fafbe50a3c66e7e9ce..a4d23abd36d310e3e11d4ef8c0cd8e732d7bafba 100644 (file)
@@ -37,6 +37,7 @@ The new site will have the following structure
 
       ▸ archetypes/
       ▸ content/
+      ▸ data/
       ▸ layouts/
       ▸ static/
         config.toml
@@ -86,10 +87,10 @@ We still lack any templates to tell us how to display the content.
 ## Step 4. Install some themes
 
 Hugo has rich theme support and a growing set of themes to choose from.
-To install all of the available Hugo themes, simply clone the entire **hugoThemes** repository from within your working directory:
+To install the latest version of all of the available Hugo themes, simply clone the entire **hugoThemes** repository from within your working directory:
 
 ```bash
-$ git clone --recursive https://github.com/spf13/hugoThemes themes
+$ git clone --depth 1 --recursive https://github.com/spf13/hugoThemes.git themes
 ```
 
 ## Step 5. Run Hugo
@@ -98,13 +99,16 @@ Hugo contains its own high-performance web server. Simply run `hugo
 server` and Hugo will find an available port and run a server with
 your content:
 
-    $ hugo server --theme=hyde --buildDrafts
+    $ 2 of 2 drafts rendered
+    0 future content
     2 pages created
+    0 paginator pages created
     0 tags created
     0 categories created
-    in 5 ms
-    Serving pages from exampleHugoSite/public
-    Web Server is available at http://localhost:1313
+    in 15 ms
+    Watching for changes in /home/user/exampleHugoSite/{data,content,layouts,static,themes}
+    Serving pages from memory
+    Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
     Press Ctrl+C to stop
 
 We specified two options here:
@@ -129,7 +133,7 @@ This even works in mobile browsers.
 
 Stop the Hugo process by hitting <kbd>Ctrl</kbd>+<kbd>C</kbd>. Then run the following:
 
-    $ hugo server --theme=hyde --buildDrafts --watch
+    $ hugo server --theme=hyde --buildDrafts
     2 pages created
     0 tags created
     0 categories created
@@ -148,12 +152,15 @@ you can look at the browser in most cases.
 
 Change and save this file. Notice what happened in your terminal:
 
-    Change detected, rebuilding site
-
+    $ Change detected, rebuilding site
+    2015-11-27 15:13 +0100
+    2 of 2 drafts rendered
+    0 future content
     2 pages created
+    0 paginator pages created
     0 tags created
     0 categories created
-    in 5 ms
+    in 11 ms
 
 ## Step 7. Have fun