Update installing

To reflect dep and mage.

Fixes https://github.com/gohugoio/hugo/issues/4390
This commit is contained in:
Bjørn Erik Pedersen 2018-02-08 13:47:36 +01:00
parent 4fa0b0d73c
commit c5963edaa0
No known key found for this signature in database
GPG Key ID: 330E6E2BD4859D8F

View File

@ -67,22 +67,23 @@ choco install hugo -confirm
* [Git][installgit] * [Git][installgit]
* [Go (latest or previous version)][installgo] * [Go (latest or previous version)][installgo]
* [govendor][]
#### Vendored Dependencies #### Vendored Dependencies
Hugo uses [govendor][] to vendor dependencies, but we don't commit the vendored packages themselves to the Hugo git repository. Therefore, a simple `go get` is *not* supported because the command is not vendor aware. *You must use `govendor` to fetch Hugo's dependencies.* Hugo uses [dep][] to vendor dependencies, but we don't commit the vendored packages themselves to the Hugo git repository. Therefore, a simple `go get` is *not* supported because the command is not vendor aware.
The simplest way is to use [mage][] (a Make alternative for Go projects.)
#### Fetch from GitHub #### Fetch from GitHub
{{< code file="from-gh.sh" >}} {{< code file="from-gh.sh" >}}
go get github.com/kardianos/govendor go get github.com/magefile/mage
govendor get github.com/gohugoio/hugo go get -d github.com/gohugoio/hugo
go install github.com/gohugoio/hugo cd $HOME/go/src/github.com/gohugoio/hugo
mage vendor
mage install
{{< /code >}} {{< /code >}}
`govendor get` will fetch Hugo and all its dependent libraries to `$GOPATH/src/github.com/gohugoio/hugo`, and `go install` compiles everything into a final `hugo` (or `hugo.exe`) executable inside `$GOPATH/bin/`.
{{% note %}} {{% note %}}
If you are a Windows user, substitute the `$HOME` environment variable above with `%USERPROFILE%`. If you are a Windows user, substitute the `$HOME` environment variable above with `%USERPROFILE%`.
{{% /note %}} {{% /note %}}
@ -486,7 +487,8 @@ Now that you've installed Hugo, read the [Quick Start guide][quickstart] and exp
[content]: /content-management/ [content]: /content-management/
[@dhersam]: https://github.com/dhersam [@dhersam]: https://github.com/dhersam
[forum]: https://discourse.gohugo.io [forum]: https://discourse.gohugo.io
[govendor]: https://github.com/kardianos/govendor [mage]: https://github.com/magefile/mage
[dep]: https://github.com/golang/dep
[highlight shortcode]: /content-management/shortcodes/#highlight [highlight shortcode]: /content-management/shortcodes/#highlight
[installgit]: http://git-scm.com/ [installgit]: http://git-scm.com/
[installgo]: https://golang.org/dl/ [installgo]: https://golang.org/dl/