Merge commit '7c62d6ef1654c0383eae474d3bd9ddf7754c1f30'

This commit is contained in:
Bjørn Erik Pedersen
2023-08-07 10:38:12 +02:00
43 changed files with 253 additions and 319 deletions

View File

@@ -1,20 +1,23 @@
## Build from source
To build Hugo from source you must:
To build the extended edition of Hugo from source you must:
1. Install [Git]
1. Install [Go] version 1.19 or later
1. Update your PATH environment variable as described in the [Go documentation]
1. Install a C compiler, either [GCC] or [Clang]
1. Update your `PATH` environment variable as described in the [Go documentation]
> The install directory is controlled by the GOPATH and GOBIN environment variables. If GOBIN is set, binaries are installed to that directory. If GOPATH is set, binaries are installed to the bin subdirectory of the first directory in the GOPATH list. Otherwise, binaries are installed to the bin subdirectory of the default GOPATH ($HOME/go or %USERPROFILE%\go).
> The install directory is controlled by the `GOPATH` and `GOBIN` environment variables. If `GOBIN` is set, binaries are installed to that directory. If `GOPATH` is set, binaries are installed to the bin subdirectory of the first directory in the `GOPATH` list. Otherwise, binaries are installed to the bin subdirectory of the default `GOPATH` (`$HOME/go` or `%USERPROFILE%\go`).
Then build and test:
```sh
go install -tags extended github.com/gohugoio/hugo@latest
CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@latest
hugo version
```
[Clang]: https://clang.llvm.org/
[GCC]: https://gcc.gnu.org/
[Git]: https://git-scm.com/book/en/v2/Getting-Started-Installing-Git
[Go]: https://go.dev/doc/install
[Go documentation]: https://go.dev/doc/code#Command
[Go]: https://go.dev/doc/install

View File

@@ -29,16 +29,18 @@ This will install the extended edition of Hugo:
sudo snap install hugo
```
To enable access to removable media:
To enable or revoke access to removable media:
```sh
sudo snap connect hugo:removable-media
sudo snap disconnect hugo:removable-media
```
To revoke access to removable media:
To enable or revoke access to SSH keys:
```sh
sudo snap disconnect hugo:removable-media
sudo snap connect hugo:ssh-keys
sudo snap disconnect hugo:ssh-keys
```
[most distributions]: https://snapcraft.io/docs/installing-snapd

View File

@@ -52,10 +52,7 @@ winget install Hugo.Hugo.Extended
{{% readfile file="/installation/common/05-build-from-source.md" %}}
{{% note %}}
When building the extended edition of Hugo from source on Windows, you will also need to install the [GCC compiler]. See these [detailed instructions].
[detailed instructions]: https://discourse.gohugo.io/t/41370
[GCC compiler]: https://gcc.gnu.org/
See these [detailed instructions](https://discourse.gohugo.io/t/41370) to install GCC on Windows.
{{% /note %}}
## Comparison