content: Update Netlify hosting guide and version refs

2026-08-28 17:22:38 +00:00 · 2025-09-09 08:38:04 -07:00
parent 4f444fb533
commit 9bbbfb59df
36 changed files with 92 additions and 103 deletions
@@ -77,7 +77,7 @@ extended
 : (`bool`) Whether the extended edition of Hugo is required, satisfied by installing either the extended or extended/deploy edition.

 max
-: (`string`) The maximum Hugo version supported, for example `0.149.0`.
+: (`string`) The maximum Hugo version supported, for example `0.150.0`.

 min
 : (`string`) The minimum Hugo version supported, for example `0.102.0`.
@@ -143,7 +143,7 @@ CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@latest
 To build and install a specific release:

 ```sh
-CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@v0.149.0
+CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@v0.150.0
 ```

 To build and install at the latest commit on the master branch:
@@ -11,5 +11,5 @@ params:
 ---

 ```go-html-template
-{{ hugo.Generator }} → <meta name="generator" content="Hugo 0.149.0">
+{{ hugo.Generator }} → <meta name="generator" content="Hugo 0.150.0">
 ```
@@ -11,5 +11,5 @@ params:
 ---

 ```go-html-template
-{{ hugo.Version }} → 0.149.0
+{{ hugo.Version }} → 0.150.0
 ```
@@ -23,7 +23,7 @@ Let's say you need to publish a file named "site.json" in the root of your `publ
 ```json
 {
  "build_date": "2025-07-08T13:12:19-07:00",
-  "hugo_version": "0.149.0",
+  "hugo_version": "0.150.0",
  "last_modified": "2025-07-07T22:09:13-07:00"
 }
 ```
@@ -18,7 +18,7 @@ hugo version
 You should see something like:

 ```text
-hugo v0.149.0-66240338f1b908ca3b163384c8229943e74eb290+extended linux/amd64 BuildDate=2025-08-27T15:37:16Z VendorInfo=gohugoio
+hugo v0.150.0-3f5473b7d4e7377e807290c3acc89feeef1aaa71+extended linux/amd64 BuildDate=2025-09-08T13:01:12Z VendorInfo=gohugoio
 ```

 ## Display available commands
@@ -40,9 +40,9 @@ Step 2
  env:
    variables:
      # Application versions
-      DART_SASS_VERSION: 1.91.0
-      GO_VERSION: 1.25.0
-      HUGO_VERSION: 0.149.0
+      DART_SASS_VERSION: 1.92.1
+      GO_VERSION: 1.25.1
+      HUGO_VERSION: 0.150.0
      # Time zone
      TZ: Europe/Oslo
      # Cache
@@ -25,8 +25,6 @@ Step 1
 : Create a `wrangler.toml` file in the root of your project.

  ```toml {file="wrangler.toml" copy=true}
-  # Configure Cloudflare Worker
-
  name = "hosting-cloudflare-worker"
  compatibility_date = "2025-07-31"

@@ -53,9 +51,9 @@ Step 2

  main() {

-    DART_SASS_VERSION=1.91.0
-    GO_VERSION=1.25.0
-    HUGO_VERSION=0.149.0
+    DART_SASS_VERSION=1.92.1
+    GO_VERSION=1.25.1
+    HUGO_VERSION=0.150.0
    NODE_VERSION=22.18.0

    export TZ=Europe/Oslo
@@ -111,7 +111,7 @@ jobs:
    runs-on: codeberg-tiny-lazy
    container:
      # Specify "hugomods/hugo:exts" if you want to always use the latest version of Hugo for building.
-      image: "hugomods/hugo:exts-0.149.0"
+      image: "hugomods/hugo:exts-0.150.0"
    steps:
      - name: Clone the repository
        uses: https://code.forgejo.org/actions/checkout@v4
@@ -201,7 +201,7 @@ jobs:
    runs-on: codeberg-tiny-lazy
    container:
      # Specify "hugomods/hugo:exts" if you want to always use the latest version of Hugo for building.
-      image: "hugomods/hugo:exts-0.149.0"
+      image: "hugomods/hugo:exts-0.150.0"
    steps:
      - name: Clone the repository
        uses: https://code.forgejo.org/actions/checkout@v4
@@ -77,9 +77,9 @@ Step 4
    build:
      runs-on: ubuntu-latest
      env:
-        DART_SASS_VERSION: 1.91.0
-        GO_VERSION: 1.25.0
-        HUGO_VERSION: 0.149.0
+        DART_SASS_VERSION: 1.92.1
+        GO_VERSION: 1.25.1
+        HUGO_VERSION: 0.150.0
        NODE_VERSION: 22.18.0
        TZ: Europe/Oslo
      steps:
@@ -24,8 +24,8 @@ Define your [CI/CD](g) jobs by creating a `.gitlab-ci.yml` file in the root of y
 ```yaml {file=".gitlab-ci.yml" copy=true}
 variables:
  # Application versions
-  DART_SASS_VERSION: 1.91.0
-  HUGO_VERSION: 0.149.0
+  DART_SASS_VERSION: 1.92.1
+  HUGO_VERSION: 0.150.0
  NODE_VERSION: 22.18.0
  # Git
  GIT_DEPTH: 0
@@ -35,7 +35,7 @@ variables:
  TZ: Europe/Oslo

 image:
-  name: golang:1.25.0-bookworm
+  name: golang:1.25.1-bookworm

 pages:
  stage: deploy
@@ -23,108 +23,99 @@ Please complete the following tasks before continuing:

 ## Procedure

+<!-- Using "text" as the code block language because "toml" looks terrible. -->
+
 Step 1
-: Log in to your Netlify account, navigate to the Sites page, press the **Add new site** button, and choose "Import an existing project" from the dropdown menu.
+: Create a `netlify.toml` file in the root of your project.
+
+  ```text {file="netlify.toml" copy=true}
+  [build.environment]
+  DART_SASS_VERSION = "1.92.1"
+  GO_VERSION = "1.25.1"
+  HUGO_VERSION = "0.150.0"
+  NODE_VERSION = "22.18.0"
+  TZ = "Europe/Oslo"
+
+  [build]
+  publish = "public"
+  command = """\
+    git config core.quotepath false && \
+    hugo --gc --minify --baseURL "${URL}"
+    """
+  ```
+
+  If your site requires Dart Sass to transpile Sass to CSS, set the `DART_SASS_VERSION` and include the Dart Sass installation in the build step.
+
+  ```text {file="netlify.toml" copy=true}
+  [build.environment]
+  DART_SASS_VERSION = "1.92.1"
+  GO_VERSION = "1.25.1"
+  HUGO_VERSION = "0.150.0"
+  NODE_VERSION = "22.18.0"
+  TZ = "Europe/Oslo"
+
+  [build]
+  publish = "public"
+  command = """\
+    curl -sLJO "https://github.com/sass/dart-sass/releases/download/${DART_SASS_VERSION}/dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz" && \
+    tar -C "${HOME}/.local" -xf "dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz" && \
+    rm "dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz" && \
+    export PATH="${HOME}/.local/dart-sass:${PATH}" && \
+    git config core.quotepath false && \
+    hugo --gc --minify --baseURL "${URL}"
+    """
+  ```

 Step 2
-: Select your deployment method.
-
-  ![screen capture](netlify-step-02.png)
+: Commit the changes to your local Git repository and push to your GitHub repository.

 Step 3
-: Authorize Netlify to connect with your GitHub account by pressing the **Authorize Netlify** button.
+: In the upper right corner of the Netlify dashboard, press the **Add new project** button and select “Import an existing project".

-  ![screen capture](netlify-step-03.png)
+  ![screen capture](netlify-01.png)

 Step 4
-: Press the **Configure Netlify on GitHub** button.
+: Connect to GitHub.

-  ![screen capture](netlify-step-04.png)
+  ![screen capture](netlify-02.png)

 Step 5
-: Install the Netlify app by selecting your GitHub account.
+: Press the "Authorize Netlify" button to allow the Netlify application to access your GitHub account.

-  ![screen capture](netlify-step-05.png)
+  ![screen capture](netlify-03.png)

 Step 6
-: Press the **Install** button.
-
-  ![screen capture](netlify-step-06.png)
+: Press the **Configure Netlify on GitHub** button.
+  
+  ![screen capture](netlify-04.png)

 Step 7
-: Click on the site's repository from the list.
+: Select the GitHub account where you want to install the Netlify application.

-  ![screen capture](netlify-step-07.png)
+  ![screen capture](netlify-05.png)

 Step 8
-: Set the site name and branch from which to deploy.
+: Authorize the Netlify application to access all repositories or only select repositories, then press the Install button.

-  ![screen capture](netlify-step-08.png)
+  ![screen capture](netlify-06.png)
+
+Your browser will be redirected to the Netlify dashboard.

 Step 9
-: Define the build settings, press the **Add environment variables** button, then press the **New variable** button.
+: Click on the name of the repository you wish to import.

-  ![screen capture](netlify-step-09.png)
+  ![screen capture](netlify-07.png)

 Step 10
-: Create a new environment variable named `HUGO_VERSION` and set the value to the [latest version](https://github.com/gohugoio/hugo/releases/latest).
+: On the "Review configuration" page, enter a project name, leave the settings at their default values, then press the **Deploy** button.

-  ![screen capture](netlify-step-10.png)
+  ![screen capture](netlify-08.png)
+
+  ![screen capture](netlify-09.png)

 Step 11
-: Press the "Deploy my new site" button at the bottom of the page.
+: When the deployment completes, click on the link to your published site.

-  ![screen capture](netlify-step-11.png)
+  ![screen capture](netlify-10.png)

-Step 12
-: At the bottom of the screen, wait for the deploy to complete, then click on the deploy log entry.
-
-  ![screen capture](netlify-step-12.png)
-
-Step 13
-: Press the **Open production deploy** button to view the live site.
-
-  ![screen capture](netlify-step-13.png)
-
-## Configuration file
-
-In the procedure above we configured our site using the Netlify user interface. Most site owners find it easier to use a configuration file checked into source control.
-
-Create a new file named `netlify.toml` in the root of your project directory. In its simplest form, the configuration file might look like this:
-
-```toml {file="netlify.toml"}
-[build.environment]
-GO_VERSION = "1.25.0"
-HUGO_VERSION = "0.149.0"
-NODE_VERSION = "22.18.0"
-TZ = "Europe/Oslo"
-
-[build]
-publish = "public"
-command = """\
-  git config core.quotepath false && \
-  hugo --gc --minify --baseURL "${URL}"
-  """
-```
-
-If your site requires Dart Sass to transpile Sass to CSS, the configuration file should look something like this:
-
-```toml {file="netlify.toml"}
-[build.environment]
-DART_SASS_VERSION = "1.91.0"
-GO_VERSION = "1.25.0"
-HUGO_VERSION = "0.149.0"
-NODE_VERSION = "22.18.0"
-TZ = "Europe/Oslo"
-
-[build]
-publish = "public"
-command = """\
-  curl -sLJO "https://github.com/sass/dart-sass/releases/download/${DART_SASS_VERSION}/dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz" && \
-  tar -C "${HOME}/.local" -xf "dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz" && \
-  rm "dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz" && \
-  export PATH="${HOME}/.local/dart-sass:${PATH}" && \
-  git config core.quotepath false && \
-  hugo --gc --minify --baseURL "${URL}"
-  """
-```
+In the future, whenever you push a change from your local Git repository, Netlify will rebuild and deploy your site.
@@ -35,11 +35,11 @@ Step 1
      staticPublishPath: public
      envVars:
        - key: DART_SASS_VERSION
-          value: 1.91.0
+          value: 1.92.1
        - key: GO_VERSION
-          value: 1.25.0
+          value: 1.25.1
        - key: HUGO_VERSION
-          value: 0.149.0
+          value: 0.150.0
        - key: NODE_VERSION
          value: 22.18.0
        - key: TZ
@@ -47,9 +47,9 @@ Step 2

  main() {

-    DART_SASS_VERSION=1.91.0
-    GO_VERSION=1.25.0
-    HUGO_VERSION=0.149.0
+    DART_SASS_VERSION=1.92.1
+    GO_VERSION=1.25.1
+    HUGO_VERSION=0.150.0
    NODE_VERSION=22.18.0

    export TZ=Europe/Oslo