# New Docs Site Released!

**URL:** <https://discourse.gohugo.io/t/new-docs-site-released/7470>\
**Category:** Announcements\
**Created:** [July 17, 2017, 8:21am UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470 "2017-07-17T08:21:40Z")\
**Posts on this page:** 18\
**Page:** 1

<div class="post-metadata">

**Author:** ![bep](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/bep/32/3332_2.png) [@bep](https://discourse.gohugo.io/u/bep)\
**Post date:** [July 17, 2017, 8:21am UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/1 "2017-07-17T08:21:40Z")

</div>

It looks great – and you gotta try the search!

> <https://twitter.com/GoHugoIO/status/886863000291999745>

Spread the word!

---

<div class="post-metadata">

**Author:** ![Leo\_Merkel](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/leo_merkel/32/3321_2.png) [@Leo\_Merkel](https://discourse.gohugo.io/u/Leo_Merkel)\
**Post date:** [July 17, 2017, 9:48am UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/2 "2017-07-17T09:48:25Z")

</div>

Saw it this morning. Amazing. Getting better every day.

---

<div class="post-metadata">

**Author:** ![Jura](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/jura/32/13581_2.png) [@Jura](https://discourse.gohugo.io/u/Jura)\
**Post date:** [July 17, 2017, 12:10pm UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/3 "2017-07-17T12:10:36Z")

</div>

Loving it! 🙂

One small thing that can make it better: when I click on the links in the TOC of an article, it doesn’t update the browser URL. That means I can’t quickly jump back and forth in the document with the browser’s previous and next feature.

---

<div class="post-metadata">

**Author:** ![budparr](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/budparr/32/749_2.png) [@budparr](https://discourse.gohugo.io/u/budparr)\
**Post date:** [July 17, 2017, 2:33pm UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/4 "2017-07-17T14:33:12Z")

</div>

@Jura - that’s a good point. The JS that implements smooth scrolling does removes it. I’ll have a look at it when I get a chance. Could you drop an issue here, please? [https://github.com/gohugoio/gohugoioTheme](https://github.com/gohugoio/gohugoioTheme)

---

<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:** [July 17, 2017, 3:27pm UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/5 "2017-07-17T15:27:57Z")

</div>

Maybe it is an easter egg, but what is the “Hugo Gopher”?

---

<div class="post-metadata">

**Author:** ![digitalcraftsman](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/digitalcraftsman/32/4142_2.png) [@digitalcraftsman](https://discourse.gohugo.io/u/digitalcraftsman)\
**Post date:** [July 17, 2017, 6:05pm UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/6 "2017-07-17T18:05:04Z")

</div>

> [@maiki](#):
>
> Maybe it is an easter egg, but what is the “Hugo Gopher”?

It’s the lesser known cousin of the Golang mascot. The “Hugo Gopher” actually powers our favorite SSG by spinning it’s hamster wheel 😉

Some people rumor that he’s living with a software developer in Oslo, Norway right now.

---

<div class="post-metadata">

**Author:** ![kaushalmodi](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/kaushalmodi/32/2567_2.png) [@kaushalmodi](https://discourse.gohugo.io/u/kaushalmodi)\
**Post date:** [July 17, 2017, 6:09pm UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/7 "2017-07-17T18:09:29Z")

</div>

The News page looks like this:

 ![](https://canada1.discourse-cdn.com/flex036/uploads/gohugo/original/2X/7/7df26957155fcac31ac4e4a73c2f129f6688be5c.png)

Should the “July Release”, “June Release”, etc titles be made more descriptive and non-repetitive? May be, something like _Release v0.25.1 - Bugfix_ instead of _July Release_ (July 10), and _Release v0.25 - Kinder Surprise_ instead of the less exciting _July Release_ (July 7) 🙂

---

<div class="post-metadata">

**Author:** ![digitalcraftsman](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/digitalcraftsman/32/4142_2.png) [@digitalcraftsman](https://discourse.gohugo.io/u/digitalcraftsman)\
**Post date:** [July 17, 2017, 6:18pm UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/8 "2017-07-17T18:18:29Z")

</div>

Have a look at

[https://github.com/gohugoio/hugoDocs/issues/49](https://github.com/gohugoio/hugoDocs/issues/49)

---

<div class="post-metadata">

**Author:** ![andi-blafasl](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/andi-blafasl/32/3643_2.png) [@andi-blafasl](https://discourse.gohugo.io/u/andi-blafasl)\
**Post date:** [July 17, 2017, 7:32pm UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/9 "2017-07-17T19:32:23Z")

</div>

The new Docs Site looks really nice! Is it still possible to clone the the Docs repo from github and build the site localy for offline usage?  
I just tried to, but when I render the site with hugo it throws a lot error messages. It also does not generate a index.html only a index.xml

The errors are referencing the partial svg/exclamation.svg like:

```
ERROR 2017/07/17 21:25:11 error processing shortcode "shortcodes/warning.html" for page "themes\\installing-and-using-themes.md": template: shortcodes/warning.html:3:4: executing "shortcodes/warning.html" at <partial "svg/exclama...>: error calling partial: Partial "svg/exclamation.svg" not found

```

Am I doing something wrong? I’m using hugo v0.25.1 to render the page without any command line arguments.

```
$ hugo version
Hugo Static Site Generator v0.25.1 windows/amd64 BuildDate: 2017-07-12T21:59:22+02:00
```

---

<div class="post-metadata">

**Author:** ![bep](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/bep/32/3332_2.png) [@bep](https://discourse.gohugo.io/u/bep)\
**Post date:** [July 17, 2017, 7:41pm UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/10 "2017-07-17T19:41:39Z")

</div>

You need to clone it to include the theme submodule. Try:

```auto
 git submodule update --init

```

---

<div class="post-metadata">

**Author:** ![andi-blafasl](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/andi-blafasl/32/3643_2.png) [@andi-blafasl](https://discourse.gohugo.io/u/andi-blafasl)\
**Post date:** [July 17, 2017, 7:45pm UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/11 "2017-07-17T19:45:06Z")

</div>

That fixed it. I’m always failing if there are submodules in a git repository 😢

Thank you so much for the fast reply!

---

<div class="post-metadata">

**Author:** ![bep](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/bep/32/3332_2.png) [@bep](https://discourse.gohugo.io/u/bep)\
**Post date:** [July 17, 2017, 7:46pm UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/12 "2017-07-17T19:46:26Z")

</div>

Yea, we need to document this better as well. Also note that I have not yet gotten to merging the new docs into the main Hugo code repos – so from [https://github.com/gohugoio/hugo](https://github.com/gohugoio/hugo) you will still get the old docs.

---

<div class="post-metadata">

**Author:** ![alexandros](https://avatars.discourse-cdn.com/v4/letter/a/ecc23a/32.png) [@alexandros](https://discourse.gohugo.io/u/alexandros)\
**Post date:** [July 17, 2017, 8:43pm UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/13 "2017-07-17T20:43:35Z")

</div>

Here: [https://gohugo.io/#gopher](https://gohugo.io/#gopher)

---

<div class="post-metadata">

**Author:** ![bep](https://yyz2.discourse-cdn.com/flex036/user_avatar/discourse.gohugo.io/bep/32/3332_2.png) [@bep](https://discourse.gohugo.io/u/bep)\
**Post date:** [July 17, 2017, 8:55pm UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/14 "2017-07-17T20:55:44Z")

</div>

Or [https://gohugo.io/hffhfhggfhfhgfgh](https://gohugo.io/hffhfhggfhfhgfgh)

---

<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:** [July 17, 2017, 10:21pm UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/15 "2017-07-17T22:21:47Z")

</div>

> [@bep](#):
>
> Or [https://gohugo.io/hffhfhggfhfhgfgh](https://gohugo.io/hffhfhggfhfhgfgh)

Wow, gopher in Norwegian is spelled really weird. For the protocol I hope they were able to shorten it to just `hffhfh://`. 🙂

Folks can also check out [https://gohugo.io/jordekorn](https://gohugo.io/jordekorn)!

---

<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:** [July 18, 2017, 2:50am UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/16 "2017-07-18T02:50:29Z")

</div>

wow this is great - great work!

---

<div class="post-metadata">

**Author:** ![giorgio](https://avatars.discourse-cdn.com/v4/letter/g/cab0a1/32.png) [@giorgio](https://discourse.gohugo.io/u/giorgio)\
**Post date:** [July 21, 2017, 11:30am UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/18 "2017-07-21T11:30:55Z")

</div>

Thanks for all the work on the new documentation.

Is there a way to get a printable version of the entire documentation (ie a single HTML page of all of the content)? I’ve seen it was mentioned in the past [here](https://discourse.gohugo.io/t/printed-documentation/3147) but nothing else.

Also, is anyone working or planning to work on writing a book describing how to use Hugo in great details? I would happily buy one if one were available.

---

<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:** [July 22, 2017, 4:17am UTC](https://discourse.gohugo.io/t/new-docs-site-released/7470/19 "2017-07-22T04:17:21Z")

</div>

> [@giorgio](#):
>
> Also, is anyone working or planning to work on writing a book describing how to use Hugo in great details? I would happily buy one if one were available.

I don’t think such a book is gonna stay relevant anytime soon. We get new releases fairly frequently, so I imagine it is down the road(map) before someone gets that published.

Online guides ought to abound, though.