CentOS 7 云服务器部署踩坑记（六）：Hugo 主题迁移与远程部署工作流

ssh root@你的服务器IP

ssh-keygen -t ed25519 -C "your@email.com"

ssh-copy-id root@你的服务器IP

curl ifconfig.me

# 服务器上生成密钥
ssh-keygen -t ed25519 -C "your@email.com"

# 查看公钥
cat ~/.ssh/id_ed25519.pub

# 测试连接
ssh -T git@github.com
# 看到 "Hi xxx! You've successfully authenticated" 即成功

# 用 SSH 协议克隆
git clone git@github.com:你的用户名/my-blog.git blog-source

# 本地执行，删除旧主题
cd F:\ECS_PJS\my-blog
Remove-Item -Recurse -Force themes/PaperMod

# 用 submodule 安装 hugo-book
git submodule add https://github.com/alex-shpak/hugo-book.git themes/hugo-book

# 错误提示
warning: adding embedded git repository: themes/PaperMod

# 删除主题内的 .git
Remove-Item -Recurse -Force themes/PaperMod/.git

# 从 Git 索引中移除缓存
git rm -r --cached themes/PaperMod

# 重新添加并推送
git add themes/PaperMod/
git commit -m "add: PaperMod theme"
git push

TOCSS: failed to transform "book.scss" (text/x-scss).
Check your Hugo installation; you need the extended version to build SCSS/SASS.

本地（extended 版本）→ hugo 构建 → public/
    ↓
scp 上传 public/* 到服务器 /var/www/blog/
    ↓
Nginx 对外提供访问

[params]
  BookSection = "*"

---
title: "📁 作品集"
weight: 1
bookFlatSection: true
---
我做过什么 — 核心项目与成果展示

{{ define "main" }}
<div class="book-page">
  <h1>{{ .Title }}</h1>

  {{ with .Content }}
    <div class="book-content">{{ . }}</div>
  {{ end }}

  <div class="article-list">
    {{ range .Pages.ByDate.Reverse }}
    <a href="{{ .Permalink }}" class="article-item">
      <div class="article-title">{{ .Title }}</div>
      <div class="article-meta">
        <span class="article-date">{{ .Date.Format "2006-01-02" }}</span>
        {{ with .Params.tags }}
          {{ range . }}
          <span class="article-tag">{{ . }}</span>
          {{ end }}
        {{ end }}
      </div>
    </a>
    {{ end }}
  </div>
</div>
{{ end }}

# 1. 写完文章，本地预览
cd F:\ECS_PJS\my-blog
hugo server    # 访问 http://localhost:1313 确认效果

# 2. 构建静态文件
hugo           # 生成 public/ 目录

# 3. 上传到服务器
scp -r public/* root@你的服务器IP:/var/www/blog/

# 本地推送到 GitHub
git add .
git commit -m "新增：文章标题"
git push

# 服务器拉取源码（可选，不影响访问）
ssh root@你的IP
cd /var/www/blog-source
git pull origin main

# deploy.ps1
param(
    [string]$SERVER = "root@你的服务器IP"
)

Write-Host "=== 构建博客 ===" -ForegroundColor Cyan
hugo --cleanDestinationDir

Write-Host "=== 上传到服务器 ===" -ForegroundColor Cyan
scp -r public/* "${SERVER}:/var/www/blog/"

Write-Host "=== 部署完成！===" -ForegroundColor Green
Write-Host "访问 https://misaku.site 查看效果"

.\deploy.ps1

baseURL = "https://misaku.site/"
theme = "hugo-book"

[params]
  BookSection = "*"      # 渲染所有 section 到侧边菜单
  BookToC = true         # 显示文章内目录
  BookTheme = "auto"     # 跟随系统深色/浅色
  BookSearch = true      # 开启搜索
  BookCustomCSS = "css/custom.css"  # 自定义样式

server {
    listen 443 ssl;
    server_name misaku.site;

    ssl_certificate /etc/nginx/ssl/misaku.site.pem;
    ssl_certificate_key /etc/nginx/ssl/misaku.site.key;

    root /var/www/blog;
    index index.html;

    location / {
        try_files $uri $uri/ =404;
    }
}