Deploy on Netlify
Donate
Become a backer or sponsor to support our work.
On this page
Sponsors
This article contains step-by-step instructions on how to deploy sites on Netlify.
There are multiple ways to deploy sites on Netlify, this article introduces the approach of using file-based configuration, which is more flexible than dashboard settings.
Deploy Sites via File-based Configuration
Create Netlify Configuration File
Firstly, create the following configuration file, and commit it to your repo.
netlify.toml
1[build]
2command = """
3DART_SASS_VERSION="${DART_SASS_VERSION:-1.79.5}" && \
4curl -LJO https://github.com/sass/dart-sass/releases/download/${DART_SASS_VERSION}/dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz && \
5tar -xf dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz && rm dart-sass-${DART_SASS_VERSION}-linux-x64.tar.gz && \
6export PATH=/opt/build/repo/dart-sass:$PATH && \
7npm ci && \
8hugo --minify -b $URL
9"""
10publish = "public"
11
12[build.environment]
13NODE_VERSION = "19"
14HUGO_VERSION = "0.121.2"
15HUGO_ENABLEGITINFO = "true"
16HUGO_ENV = "production"
17GO_VERSION = "1.20"
18
19[[headers]]
20 for = "/*"
21 [headers.values]
22 Referrer-Policy = "strict-origin-when-cross-origin"
23 X-Content-Type-Options = "nosniff"
24 X-Frame-Options = "deny"
25 X-XSS-Protection = "1; mode=block"
26
27# multilingual 404 pages, remove it on monolingual sites.
28[[redirects]]
29 from = "/en/*"
30 to = "/en/404.html"
31 status = 404
32
33[[redirects]]
34 from = "/zh-hans/*"
35 to = "/zh-hans/404.html"
36 status = 404
37
38# fallback 404 page.
39[[redirects]]
40 from = "/*"
41 to = "/404.html"
42 # to = "/en/404.html" # use this instead if defaultContentLanguageInSubdir is enabled.
43 status = 404
Note
The Dart Sass version is
-1.79.5by default, change it by specifying theDART_SASS_VERSIONenvironment variable.
Create a Site
- Login to Netlify dashboard.
- Click the Add new site, and select the
Import an existing projectoption. - Select the repository.
- Leave the form as it is, since we’ve configured via
netlify.toml. - Deploy site.
After modifying the custom domain name, you need to redeploy the site.
