mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-21 20:46:30 -05:00
Updates documentation with instructions for a Windows computer
Adds step-by-step instructions for installing from the official tarball. Fixes #1007
This commit is contained in:
parent
3b2e1006fc
commit
06d704f243
3 changed files with 79 additions and 3 deletions
|
@ -1,11 +1,11 @@
|
|||
---
|
||||
author: "Michael Henderson"
|
||||
date: 2015-02-22
|
||||
linktitle: Installing on a Mac
|
||||
linktitle: Installing on Mac
|
||||
menu:
|
||||
main:
|
||||
parent: tutorials
|
||||
next: /tutorials/mathjax
|
||||
next: /tutorials/installing-on-windows
|
||||
prev: /tutorials/github-pages-blog
|
||||
title: Installing on a Mac
|
||||
weight: 10
|
||||
|
|
76
docs/content/tutorials/installing-on-windows.md
Normal file
76
docs/content/tutorials/installing-on-windows.md
Normal file
|
@ -0,0 +1,76 @@
|
|||
---
|
||||
author: "Michael Henderson"
|
||||
date: 2015-03-30
|
||||
linktitle: Installing on Windows
|
||||
menu:
|
||||
main:
|
||||
parent: tutorials
|
||||
next: /tutorials/mathjax
|
||||
prev: /tutorials/installing-on-mac
|
||||
title: Installing on Windows
|
||||
weight: 10
|
||||
---
|
||||
|
||||
# Installing Hugo on Windows
|
||||
|
||||
This tutorial aims to be a complete guide to installing Hugo on your Windows computer.
|
||||
|
||||
## Assumptions
|
||||
|
||||
1. You know how to open a command prompt window.
|
||||
2. You're running a 64-bit version of Windows.
|
||||
3. Your website is `example.com`.
|
||||
4. You will use `D:\Hugo\Sites` as the starting point for your site.
|
||||
5. You will use `D:\Hugo\bin` to store executable files.
|
||||
|
||||
## Setup Your Directories
|
||||
|
||||
You will need a place to store the Hugo executable, your content (the files that you build), and the generated files (the HTML that Hugo builds for you).
|
||||
|
||||
1. Open up Windows Explorer.
|
||||
2. Create a new folder, `D:\Hugo`.
|
||||
3. Create a new folder, `D:\Hugo\bin`.
|
||||
4. Create a new folder, `D:\Hugo\Sites`.
|
||||
|
||||
## Download the pre-built Hugo executable for Windows
|
||||
|
||||
One advantage of building Hugo in go is that there is just a single binary file to use. You don't need to run an installer to use it. Instead, you need to copy the binary to your hard drive. I'm assuming that you'll put it in `D:\Hugo\bin`. If you chose to place it somewhere else, you'll need to substitute that path in the commands.
|
||||
|
||||
1. Open https://github.com/spf13/hugo/releases in your browser.
|
||||
2. The current version is hugo_0.13_windows_amd64.zip.
|
||||
3. Download that ZIP file and save it in your `D:\Hugo\bin` folder.
|
||||
4. Find that ZIP file in Windows Explorer and extract all the files from it.
|
||||
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`.)
|
||||
|
||||
## Verify the executable
|
||||
|
||||
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:
|
||||
```
|
||||
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.
|
||||
3. At the prompt, change your directory to the `Sites` directory.
|
||||
```
|
||||
C:\Program Files> cd D:\Hugo\Sites
|
||||
C:\Program Files> D:
|
||||
D:\Hugo\Sites>
|
||||
```
|
||||
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
|
||||
```
|
||||
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
|
||||
|
||||
@dhersam has a nice video on common issues at https://www.youtube.com/watch?v=c8fJIRNChmU
|
||||
|
||||
## Future Steps
|
||||
|
||||
Consider adding `D:\Hugo\bin` to your system PATH.
|
|
@ -5,7 +5,7 @@ menu:
|
|||
main:
|
||||
parent: tutorials
|
||||
next: /tutorials/migrate-from-jekyll
|
||||
prev: /tutorials/installing-on-mac
|
||||
prev: /tutorials/installing-on-windows
|
||||
title: MathJax Support
|
||||
weight: 10
|
||||
---
|
||||
|
|
Loading…
Reference in a new issue