Skip to content

Commit dbb42ae

Browse files
authored
content: Document the deploy edition
1 parent 549f30f commit dbb42ae

4 files changed

Lines changed: 35 additions & 42 deletions

File tree

content/en/_common/installation/01-editions.md

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,14 +4,19 @@ _comment: Do not remove front matter.
44

55
## Editions
66

7-
Hugo offers a standard edition with core features, plus extended and extended/deploy editions with more. Use the standard edition unless you need the features below.
7+
Hugo is available in several editions. Use the standard edition unless you need additional features.
88

9-
<!-- TODO Remove the transpiler row somewhere around v0.166.0 -->
9+
Feature|standard|deploy (1)|extended|extended/deploy
10+
:--|:-:|:-:|:-:|:-:
11+
Core features|:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:|:heavy_check_mark:
12+
Direct cloud deployment (2)|:x:|:heavy_check_mark:|:x:|:heavy_check_mark:
13+
LibSass support (3)|:x:|:x:|:heavy_check_mark:|:heavy_check_mark:
1014

11-
Feature|extended edition|extended/deploy edition
12-
:--|:-:|:-:
13-
[Transpile Sass to CSS] via embedded LibSass. Note that embedded LibSass was deprecated in v0.153.0 and will be removed in a future release. Use the [Dart Sass] transpiler instead, which is compatible with any edition.|:heavy_check_mark:|:heavy_check_mark:
14-
Deploy your site directly to a Google Cloud Storage bucket, an AWS S3 bucket, or an Azure Storage container. See&nbsp;[details].|:x:|:heavy_check_mark:
15+
(1) {{< new-in v0.159.2 />}}
16+
17+
(2) Deploy your site directly to a Google Cloud Storage bucket, an AWS S3 bucket, or an Azure Storage container. See&nbsp;[details].
18+
19+
(3) [Transpile Sass to CSS] via embedded LibSass. Note that embedded LibSass was deprecated in v0.153.0 and will be removed in a future release. Use the [Dart Sass] transpiler instead, which is compatible with any edition.
1520

1621
[dart sass]: /functions/css/sass/#dart-sass
1722
[transpile sass to css]: /functions/css/sass/

content/en/_common/installation/04-build-from-source.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,12 +11,22 @@ To build Hugo from source you must install:
1111

1212
### Standard edition
1313

14-
To build and install the standard edition, run the following command.
14+
To build and install the standard edition:
1515

1616
```sh
1717
CGO_ENABLED=0 go install github.com/gohugoio/hugo@latest
1818
```
1919

20+
### Deploy edition
21+
22+
{{< new-in v0.159.2 />}}
23+
24+
To build and install the deploy edition:
25+
26+
```sh
27+
CGO_ENABLED=0 go install -tags withdeploy github.com/gohugoio/hugo@latest
28+
```
29+
2030
### Extended edition
2131

2232
To build and install the extended edition, first install a C compiler such as [GCC] or [Clang] and then run the following command.

content/en/contribute/development.md

Lines changed: 12 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -68,22 +68,28 @@ Step 4
6868
Step 5
6969
: Build and install.
7070

71-
To build and install the standard edition, run the following command.
71+
To build and install the deploy edition:
7272

7373
```sh
74-
CGO_ENABLED=0 go install github.com/gohugoio/hugo@latest
74+
CGO_ENABLED=0 go install
7575
```
7676

77-
To build and install the extended edition, first install a C compiler such as [GCC] or [Clang] and then run the following command.
77+
{{< new-in v0.159.2 />}} To build and install the deploy edition:
7878

7979
```sh
80-
CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@latest
80+
CGO_ENABLED=0 go install -tags withdeploy
8181
```
8282

83-
To build and install the extended/deploy edition, first install a C compiler such as [GCC] or [Clang] and then run the following command.
83+
To build and install the extended edition, first install a C compiler such as [GCC] or [Clang] and then run the following command:
8484

8585
```sh
86-
CGO_ENABLED=1 go install -tags extended,withdeploy github.com/gohugoio/hugo@latest
86+
CGO_ENABLED=1 go install -tags extended
87+
```
88+
89+
To build and install the extended/deploy edition, first install a C compiler such as [GCC] or [Clang] and then run the following command:
90+
91+
```sh
92+
CGO_ENABLED=1 go install -tags extended,withdeploy
8793
```
8894

8995
Step 6
@@ -125,34 +131,6 @@ Step 9
125131
Step 10
126132
: A project maintainer will review your PR and may request changes. You may delete your branch after the maintainer merges your PR.
127133

128-
## Building from source
129-
130-
You can build, install, and test Hugo at any point in its development history. The examples below build and install the extended edition of Hugo.
131-
132-
To build and install the latest release:
133-
134-
```sh
135-
CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@latest
136-
```
137-
138-
To build and install a specific release:
139-
140-
```sh
141-
CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@v0.158.0
142-
```
143-
144-
To build and install at the latest commit on the master branch:
145-
146-
```sh
147-
CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@master
148-
```
149-
150-
To build and install at a specific commit:
151-
152-
```sh
153-
CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@c0d9beb
154-
```
155-
156134
[Clang]: https://clang.llvm.org/
157135
[Contribution Guide]: https://github.com/gohugoio/hugo/blob/master/CONTRIBUTING.md
158136
[GCC]: https://gcc.gnu.org/

content/en/host-and-deploy/deploy-with-hugo-deploy.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ aliases: [/hosting-and-deployment/hugo-deploy/]
99
Use the `hugo deploy` command to deploy your site Amazon S3, Azure Blob Storage, or Google Cloud Storage.
1010

1111
> [!note]
12-
> This feature requires the Hugo extended/deploy edition. See the [installation] section for details.
12+
> This feature requires the deploy or extended/deploy edition. See the [installation] section for details.
1313
1414
## Assumptions
1515

0 commit comments

Comments
 (0)