在 SourceHut Pages 上托管

在 SourceHut Pages 上托管您的網站。

假設

熟悉使用 Git 或 Mercurial 進行版本控制
完成 Hugo [快速入門][]
擁有 [SourceHut 賬戶][]
在本地計算機上准備好發布的 Hugo 網站

所有 <YourUsername> 的引用都指您實際的 SourceHut 用戶名，必須相應替換。

BaseURL

如果您使用 SourceHut Pages 提供的默認地址（例如 https://<YourUsername>.srht.site/），則網站配置中的 baseURL 必須反映 SourceHut Pages 提供的完整 URL。如果您想使用其他域名，請查看官方文檔的 [自定義域名部分][]。

手動部署

此方法不需要付費賬戶。要繼續，您需要創建 [SourceHut 個人訪問令牌][] 並安裝和配置 hut CLI 工具：

hugo
tar -C public -cvz . > site.tar.gz
hut init
hut pages publish -d <YourUsername>.srht.site site.tar.gz

將自動為您獲取 TLS 證書，您的新網站將在 https://<YourUsername>.srht.site/（或提供的自定義域名）可用。

自動部署

此方法需要付費賬戶並依賴 SourceHut 構建系統。

首先，通過在項目根目錄創建 .build.yml 文件來定義您的 [構建清單][]。以下是一個基本模板：

.build.yml

image: alpine/edge
packages:
  - hugo
  - hut
oauth: pages.sr.ht/PAGES:RW
environment:
  site: <YourUsername>.srht.site
tasks:
- package: |
    cd $site
    hugo
    tar -C public -cvz . > ../site.tar.gz
- upload: |
    hut pages publish -d $site site.tar.gz

如果您的網站需要 Dart Sass 將 Sass 轉譯為 CSS，請將 DART_SASS_VERSION 設置為 [最新版本號][] 並在運行 Hugo 構建步驟之前包含 Dart Sass 安裝行。注意對於 Alpine，使用 linux-x64-musl 版本。

.build.yml

image: alpine/edge
packages:
  - hugo
  - hut
  - curl # 用於安裝 Dart Sass
oauth: pages.sr.ht/PAGES:RW
environment:
  site: <YourUsername>.srht.site
tasks:
- package: |
    DART_SASS_VERSION=1.97.1 # 截至 20/12/2025 的最新版本
    mkdir -p $HOME/.local
    curl -L https://github.com/sass/dart-sass/releases/download/${DART_SASS_VERSION}/dart-sass-${DART_SASS_VERSION}-linux-x64-musl.tar.gz -o dart-sass.tar.gz
    tar -xzf dart-sass.tar.gz -C $HOME/.local
    rm dart-sass.tar.gz
    chmod -R +x $HOME/.local/dart-sass/src
    export PATH="$HOME/.local/dart-sass:$PATH"
    sass --version # 驗證安裝
    cd $site
    hugo
    tar -C public -cvz . > ../site.tar.gz
- upload: |
    hut pages publish -d $site site.tar.gz

現在剩下的是創建一個名為 <YourUsername>.srht.site（或您的自定義域名，如果適用）的倉庫並推送您的本地項目。以下是使用 Git 的示例：

# 初始化新的 git 倉庫
git init

# 將 /public 目錄添加到 .gitignore 文件
echo "/public" >> .gitignore

# 提交並將代碼推送到 main 分支
git add .
git commit -m "Initial commit"
git remote add origin https://git.sr.ht/~<YourUsername>/<YourUsername>.srht.site
git push -u origin main

您現在可以在 https://builds.sr.ht/ 關注頁面的構建進度。

構建通過後，將自動為您獲取 TLS 證書，您的新網站將在 https://<YourUsername>.srht.site/（或提供的自定義域名）可用。

其他資源

Last updated: January 1, 0001

Improve this page