# Hugo Quick Start for Windows

**URL:** <https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364>\
**Category:** support\
**Created:** [April 26, 2019, 9:37pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364 "2019-04-26T21:37:35Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![Prophoss](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/prophoss/32/7334_2.png) [@Prophoss](https://discourse.gohugo.io/u/Prophoss)\
**Post date:** [April 26, 2019, 9:37pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/1 "2019-04-26T21:37:35Z")

</div>

Hey y’all I am going through the quick start guide and doing it step by step to see how it works, and maybe help out if and when I find a problem.  
I got through step 5 when you are supposed to build the site and that is the first problem I have found. It didn’t build properly using the anake theme. when I opened the folder in vscode it showed an error in the theme.toml file.

min\_version = 0.30.2 apparently the 2 at the end is what is throwing the error.

in the terminal it showed this  
WARN 2019/04/26 16:22:46 Found no layout for “home”, language “en”, output format “HTML”: create a template below /layouts with one of these filenames: index.en.html.html, home.en.html.html, list.en.html.html, index.html.html, home.html.html, list.html.html, index.en.html, home.en.html, list.en.html, index.html, home.html, list.html, \_default/index.en.html.html, \_default/home.en.html.html, \_default/list.en.html.html, \_default/index.html.html, \_default/home.html.html, \_default/list.html.html, \_default/index.en.html, \_default/home.en.html, \_default/list.en.html, \_default/index.html, \_default/home.html, \_default/list.html

when I tried to open it in the terminal it didn’t work, but it did open when I opened it in vscode. even with the error in the theme.toml

This is just a starting place and it might not be the correct place to tell y’all about this, but if you will point me in the right direction I will gladly get it going.

---

<div class="post-metadata">

**Author:** ![madispe](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/madispe/32/7325_2.png) [@madispe](https://discourse.gohugo.io/u/madispe)\
**Post date:** [April 27, 2019, 8:30am UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/2 "2019-04-27T08:30:00Z")

</div>

While the `min_version = 0.30.2` shows a warning in VS Code, it doesn’t actually break the build.

It seems you have installed the Ananke theme to a wrong directory. It should be in `themes/ananke` and its config file should be in `themes/ananke/theme.toml`. The `themes` folder should be alongside content, data, layouts folders.

After that make sure you run `hugo serve -D` from the parent folder (quickstart)

---

<div class="post-metadata">

**Author:** ![Prophoss](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/prophoss/32/7334_2.png) [@Prophoss](https://discourse.gohugo.io/u/Prophoss)\
**Post date:** [April 27, 2019, 12:34pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/3 "2019-04-27T12:34:48Z")

</div>

What I was doing is simply following the instructions in the quick start. As you say it did not break the build but for a person who is following the instructions exactly this creates a problem. I did not do anything other than what was in the instructions. So if the theme was in the wrong file then it was built that way. It looks like the only thing that was missing was placing the theme in the config.toml file.

---

<div class="post-metadata">

**Author:** ![maiki](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/maiki/32/16384_2.png) [@maiki](https://discourse.gohugo.io/u/maiki)\
**Post date:** [April 27, 2019, 4:09pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/4 "2019-04-27T16:09:07Z")

</div>

> [@Prophoss](#):
>
> It looks like the only thing that was missing was placing the theme in the config.toml file.

Do you mean setting `theme = "ananke"` in your site’s `config.toml`?

---

<div class="post-metadata">

**Author:** ![Prophoss](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/prophoss/32/7334_2.png) [@Prophoss](https://discourse.gohugo.io/u/Prophoss)\
**Post date:** [April 27, 2019, 8:08pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/5 "2019-04-27T20:08:29Z")

</div>

That is what it looks like yes.

---

<div class="post-metadata">

**Author:** ![maiki](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/maiki/32/16384_2.png) [@maiki](https://discourse.gohugo.io/u/maiki)\
**Post date:** [April 27, 2019, 9:46pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/6 "2019-04-27T21:46:36Z")

</div>

It’s in there, but it is at the bottom of the text in [step 3](https://gohugo.io/getting-started/quick-start/#step-3-add-a-theme). Maybe we ought to point that out, or separate the code block to make it more prominent.

---

<div class="post-metadata">

**Author:** ![Prophoss](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/prophoss/32/7334_2.png) [@Prophoss](https://discourse.gohugo.io/u/Prophoss)\
**Post date:** [April 28, 2019, 1:53am UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/7 "2019-04-28T01:53:45Z")

</div>

I see it now. You are correct, and I think it needs some explanation or something. Thinking from a new persons point of view, even if they knew what all that meant would they know to add that to the config file at the end. Would they know why it is needed. The video clip shows how to call up the ananke theme from git hub but that is all. It does not show how to edit the config file and not knowing what the echo ‘theme = “ananke”’ \>\> config.toml means I would be lost.

I actually added the echo… to the command line and this is what I got in the config.toml file:  
t�h�e�m�e� �=� �"�a�n�a�n�k�e�"�

�

�

---

<div class="post-metadata">

**Author:** ![maiki](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/maiki/32/16384_2.png) [@maiki](https://discourse.gohugo.io/u/maiki)\
**Post date:** [April 28, 2019, 5:48pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/8 "2019-04-28T17:48:14Z")

</div>

First, check out:

> [@Hugo 101: Slowstart for beginners](https://discourse.gohugo.io/t/hugo-101-slowstart-for-beginners/18383):
>
> Hugo makes creating a new site easy, but the site is blank. This blank slate is helpful if you’re experienced and don’t want to delete a bit of configuration before building your site, but it can be really rough on beginners just trying to understand how to get going. The purpose of this post is to give newbies a leg-up by showing what needs to be done to get to a “working” site. It’s not intended to explain “why” things need to be done (the documentation does a good job of that). TL;DR: Cre…

I’m sure they’d appreciate feedback from a Windows user.

As for the current Quick Start, it’s uses macOS for examples.

I’m pointing it out for folks reading this thread, looking to improve it. The current quick start likely hits a huge swath of users of Hugo, but leaves a bunch of folks out. The good news folks are always improving it. 🙂

---

<div class="post-metadata">

**Author:** ![Prophoss](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/prophoss/32/7334_2.png) [@Prophoss](https://discourse.gohugo.io/u/Prophoss)\
**Post date:** [April 28, 2019, 6:20pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/9 "2019-04-28T18:20:26Z")

</div>

That’s the idea. Seems like most of these sites use Mac rather than windows.

---

<div class="post-metadata">

**Author:** ![ju52](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/ju52/32/6749_2.png) [@ju52](https://discourse.gohugo.io/u/ju52)\
**Post date:** [April 29, 2019, 2:55pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/10 "2019-04-29T14:55:27Z")

</div>

> [@Prophoss](#):
>
> min\_version = 0.30.2

change it to

`min_version = "0.30.2"`

---

<div class="post-metadata">

**Author:** ![Prophoss](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/prophoss/32/7334_2.png) [@Prophoss](https://discourse.gohugo.io/u/Prophoss)\
**Post date:** [April 29, 2019, 5:08pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/11 "2019-04-29T17:08:44Z")

</div>

OK but can that get fixed in the github repo so that others will not have the same issue later? That is why I did this. Like I said this might not be the right place for this,but it was a place to start.

---

<div class="post-metadata">

**Author:** ![Prophoss](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/prophoss/32/7334_2.png) [@Prophoss](https://discourse.gohugo.io/u/Prophoss)\
**Post date:** [April 29, 2019, 6:58pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/12 "2019-04-29T18:58:46Z")

</div>

I just learned something new! Ok so the  
echo ‘Theme = “ananke”’ \>\> config.toml is meant to put theme= “ananke” in the config.toml file, which it does, but it does not send it correctly. it looks like this instead  
t�h�e�m�e� �=� �"�a�n�a�n�k�e�"�

�

�  
I’m not sure why that is but there is the problem so far as windows is concerned.

---

<div class="post-metadata">

**Author:** ![zwbetz](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/zwbetz/32/16088_2.png) [@zwbetz](https://discourse.gohugo.io/u/zwbetz)\
**Post date:** [April 29, 2019, 7:29pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/13 "2019-04-29T19:29:32Z")

</div>

What command line are you running that from? Command Prompt? PowerShell? Something else?

---

<div class="post-metadata">

**Author:** ![Prophoss](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/prophoss/32/7334_2.png) [@Prophoss](https://discourse.gohugo.io/u/Prophoss)\
**Post date:** [April 29, 2019, 9:50pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/14 "2019-04-29T21:50:59Z")

</div>

I am using powershell inside vscode. I also tried using powershell separate from vscode. It did the same thing. I also used the command line or c prompt and put in the echo command and it didn’t do anything at all even though I was in the correct directory.

---

<div class="post-metadata">

**Author:** ![Prophoss](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/prophoss/32/7334_2.png) [@Prophoss](https://discourse.gohugo.io/u/Prophoss)\
**Post date:** [April 29, 2019, 9:55pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/15 "2019-04-29T21:55:16Z")

</div>

I also added a comment to a pull request on github for a suggestion that was made to separate the second half of part 3 in the quick start guide to make it more prominent.

---

<div class="post-metadata">

**Author:** ![RickCogley](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/rickcogley/32/10269_2.png) [@RickCogley](https://discourse.gohugo.io/u/RickCogley)\
**Post date:** [April 29, 2019, 10:06pm UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/16 "2019-04-29T22:06:33Z")

</div>

I used to write a lot of batches for Windows and never saw a problem with the `echo` command. But I can imagine it is simply a setting that needs tweaked to get it to work as expected.

What does `chcp` return for you?

---

<div class="post-metadata">

**Author:** ![Prophoss](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/prophoss/32/7334_2.png) [@Prophoss](https://discourse.gohugo.io/u/Prophoss)\
**Post date:** [April 30, 2019, 12:05am UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/17 "2019-04-30T00:05:14Z")

</div>

not sure how to use chcp in this case. so not sure.

---

<div class="post-metadata">

**Author:** ![RickCogley](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/rickcogley/32/10269_2.png) [@RickCogley](https://discourse.gohugo.io/u/RickCogley)\
**Post date:** [April 30, 2019, 12:14am UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/18 "2019-04-30T00:14:01Z")

</div>

Where you typed the echo command just type `chcp` then enter. What does it show you? That “change codepage” command is used to check and change your codepage, and at least in my experience, having it set to something other than English can cause challenges.

Also do you use any software to enter languages other than English by any chance? I live in Japan, and have had trouble with the “IME” software for entering Japanese. If that is toggled on, it sometimes pushes characters where you don’t want them.

---

<div class="post-metadata">

**Author:** ![Prophoss](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/prophoss/32/7334_2.png) [@Prophoss](https://discourse.gohugo.io/u/Prophoss)\
**Post date:** [April 30, 2019, 12:35am UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/19 "2019-04-30T00:35:19Z")

</div>

when I used the echo then pressed enter it did the same thing of course. then I entered chcp and it showed this Active code page: 437  
not sure if that is how you do that, but there you go.  
I do not use any ime’s on this computer

---

<div class="post-metadata">

**Author:** ![RickCogley](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/rickcogley/32/10269_2.png) [@RickCogley](https://discourse.gohugo.io/u/RickCogley)\
**Post date:** [April 30, 2019, 12:44am UTC](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364/20 "2019-04-30T00:44:15Z")

</div>

Hmm, 437 is standard, so, that isn’t the issue I think.

Can you try doing the echo straight from `cmd.exe` and not from inside vscode? It is possible that vscode is doing something funky.

[Next page](https://discourse.gohugo.io/t/hugo-quick-start-for-windows/18364.md?page=2)