ref: feba35cd1f62dd330ac4b1da19d758d2b6c36a87
parent: a52e508d4628da4c976f4fe3f55eab2293686ee6
author: Bill Traynor <[email protected]>
date: Mon Apr 13 19:04:03 EDT 2015
Added in set PATH and new site output. I added in the instructions for how to add the hugo.exe to the PATH variable. And I added in example output post new site command. [close #1058]
--- a/docs/content/tutorials/installing-on-windows.md
+++ b/docs/content/tutorials/installing-on-windows.md
@@ -43,6 +43,7 @@
5. You should see a `hugo_0.13_windows_amd64.exe` file.
6. Rename that file to `hugo.exe`.
7. Verify that the `hugo.exe` file is in the `D:\Hugo\bin` folder. (It's possible that the extract put it in a sub-directory. If it did, use Windows Explorer to move it to `D:\Hugo\bin`.)
+8. Add the hugo.exe executable to your PATH with: `D:\Hugo\bin>set PATH=%PATH%;D:\Hugo\bin`
## Verify the executable
@@ -49,11 +50,11 @@
Run a few commands to verify that the executable is ready to run and then build a sample site to get started.
1. Open a command prompt window.
-2. At the prompt, type `D:\Hugo\bin\hugo help` and press the Enter key. You should see output that starts with:
+2. At the prompt, type `hugo help` and press the Enter key. You should see output that starts with:
```
A Fast and Flexible Static Site Generator built with love by spf13 and friends in Go. Complete documentation is available at http://gohugo.io
```
-If you do, then the installation is complete. If you don't, double-check the path that you placed the `hugo.exe` file in and that you typed that path correctly. If you're still not getting the output, post a note on the Hugo discussion list (in the `Support` topic) with your command and the output.
+If you do, then the installation is complete. If you don't, double-check the path that you placed the `hugo.exe` file in and that you typed that path correctly when you added it to your PATH variable. If you're still not getting the output, post a note on the Hugo discussion list (in the `Support` topic) with your command and the output.
3. At the prompt, change your directory to the `Sites` directory.
```
C:\Program Files> cd D:\Hugo\Sites
@@ -62,15 +63,30 @@
```
4. Run the command to generate a new site. I'm using `example.com` as the name of the site.
```
-D:\Hugo\Sites> D:\Hugo\bin\hugo new site example.com
+D:\Hugo\Sites> hugo new site example.com
```
-Note that you must type the full path to `hugo` unless you've updated your system PATH variable!
-5. You should get output similar to the following: `TODO: grab output and put here` You now have Hugo installed and a site to work with. You need to add a layout (or theme), then create some content. Go to http://gohugo.io/overview/quickstart/ for steps on doing that.
-## Troubleshooting
+5. You should now have a directory at D:\Hugo\Sites\example.com. Change into that directory and list the contents. You should get output similar to the following:
+```
+D:\Hugo\Sites>cd example.com
+D:\Hugo\Sites\example.com>dir
+ Directory of D:\hugo\sites\example.com
-@dhersam has a nice video on common issues at https://www.youtube.com/watch?v=c8fJIRNChmU
+04/13/2015 10:44 PM <DIR> .
+04/13/2015 10:44 PM <DIR> ..
+04/13/2015 10:44 PM <DIR> archetypes
+04/13/2015 10:44 PM 83 config.toml
+04/13/2015 10:44 PM <DIR> content
+04/13/2015 10:44 PM <DIR> data
+04/13/2015 10:44 PM <DIR> layouts
+04/13/2015 10:44 PM <DIR> static
+ 1 File(s) 83 bytes
+ 7 Dir(s) 6,273,331,200 bytes free
-## Future Steps
+```
-Consider adding `D:\Hugo\bin` to your system PATH.
+You now have Hugo installed and a site to work with. You need to add a layout (or theme), then create some content. Go to http://gohugo.io/overview/quickstart/ for steps on doing that.
+
+## Troubleshooting
+
+@dhersam has a nice video on common issues at https://www.youtube.com/watch?v=c8fJIRNChmU