docs: cloudflare pages deployments

hbstack · Oct 15, 2024 · 03eafdc · 03eafdc
1 parent 6db8d34
commit 03eafdc
Show file tree

Hide file tree

Showing 4 changed files with 11 additions and 1 deletion.
diff --git a/content/docs/deployment/cloudflare-pages/codes/workflow.yaml b/content/docs/deployment/cloudflare-pages/codes/workflow.yaml
@@ -1,4 +1,4 @@
-```yaml
+```yaml {data-max-lines=30}
 name: Cloudflare Pages
 
 on:
@@ -12,6 +12,7 @@ on:
 
 jobs:
   publish:
+    # Must runs on Ubuntu, since this workflow use snap to install Dart Sass.
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -26,6 +27,9 @@ jobs:
         with:
           node-version: "19"
 
+      - name: Setup Dart Sass
+        run: sudo snap install dart-sass && sudo snap alias dart-sass sass
+
       - name: Cache dependencies
         uses: actions/cache@v3
         with:

diff --git a/content/docs/deployment/cloudflare-pages/index.en.md b/content/docs/deployment/cloudflare-pages/index.en.md
@@ -32,9 +32,11 @@ There are multiple ways to deploy you sites on Cloudflare Pages.
    1. Framework preset: Hugo.
    1. Build command: it depends on how you install the build tools, for [starter theme](https://github.com/hbstack/theme): `npm ci && hugo --gc --minify --enableGitInfo`.
    1. Build output directory: `/public`.
+   1. **Make sure the `Build system version` was `2`, it's required to install Dart Sass.**
    1. Environment variables:
       1. `HUGO_VERSION`: i.e. `0.111.3`.
       1. `NODE_VERSION`: any version large than `16`, e.g `19`.
+      1. `EMBEDDED_DART_SASS_VERSION`: Embedded Dart Sass, i.e. `1.62.1`.
 
 ## Deploy Sites via GitHub Cloudflare Pages Actions
 

diff --git a/content/docs/deployment/cloudflare-pages/index.zh-hans.md b/content/docs/deployment/cloudflare-pages/index.zh-hans.md
@@ -32,9 +32,11 @@ authors:
    1. 框架预设置：Hugo。
    1. 构建命令：其取决于你如何安装构建工具，对于[新手主题](https://github.com/hbstack/theme)：`npm ci && hugo --gc --minify --enableGitInfo`。
    1. 构建输出目录：`/public`。
+   1. **确保 `Build system version` 为 `2`，否则无法安装 Dart Sass。**
    1. 环境变量：
       1. `HUGO_VERSION`：比如 `0.111.3`。
       1. `NODE_VERSION`：任意大于 `16` 的版本，如：`19`。
+      1. `EMBEDDED_DART_SASS_VERSION`：Embedded Dart Sass，如：`1.62.1`。
 
 ## 通过 GitHub Cloudflare Pages Actions 部署站点
 

diff --git a/content/docs/deployment/cloudflare-pages/index.zh-hant.md b/content/docs/deployment/cloudflare-pages/index.zh-hant.md
@@ -32,9 +32,11 @@ authors:
    1. 框架預設置：Hugo。
    1. 構建命令：其取決於你如何安裝構建工具，對於[新手主題](https://github.com/hbstack/theme)：`npm ci && hugo --gc --minify --enableGitInfo`。
    1. 構建輸出目錄：`/public`。
+   1. **確保 `Build system version` 為 `2`，否則無法安裝 Dart Sass。**
    1. 環境變量：
       1. `HUGO_VERSION`：比如 `0.111.3`。
       1. `NODE_VERSION`：任意大於 `16` 的版本，如：`19`。
+      1. `EMBEDDED_DART_SASS_VERSION`：Embedded Dart Sass，如：`1.62.1`。
 
 ## 通過 GitHub Cloudflare Pages Actions 部署站點