Strapi入门指南

# 创建工作目录并进入
mkdir -p ~/project && cd ~/project

# 初始化 Hugo 前端项目，命名为 frontend
hugo new site frontend

cd frontend
# 创建 themes 文件夹
mkdir -p themes

# 将 PaperMod 主题克隆到 themes/PaperMod 目录下 (加上 --depth=1 可以让下载极快)
git clone https://github.com/adityatelange/hugo-PaperMod themes/PaperMod --depth=1
# 启用主题
echo 'theme = "PaperMod"' >> hugo.toml
# 预览
hugo server -D --bind 0.0.0.0 --port 1314

# 创建名为 backend 的 Strapi 项目，并默认使用 SQLite 数据库快速启动，
# 我们也可以指定其他数据库，支持的数据库有 sqlite、postgres、mysql。
pnpm create strapi-app@latest backend

cd ~/project
mkdir connector && cd connector
go mod init connector

package web

import (
	"fmt"
	"io"
	"log"
	"net/http"
	"os"
	"os/exec"
	"path/filepath"

	"encoding/json"
	"text/template"

	"github.com/gin-gonic/gin"
	"go.uber.org/zap"
)

func (h *StrapiHandler) RegisterRoutes(server *gin.Engine) {
	// 微信公众平台 (Official Account) 消息推送网关与管理接口
	g := server.Group("/portal")
	{
		g.POST("/webhook", h.webhookHandler) // portal 门户、入口站点需对微信服务器免登录放行
	}
}

func (h *StrapiHandler) webhookHandler(ctx *gin.Context) {
	log.Println("检测到内容更新，开始自动化构建...")
	go func() {
		if err := h.syncDataAndBuild(); err != nil {
			log.Printf("❌ 构建流程出错: %v\n", err)
		} else {
			log.Println("✅ 静态官网已成功生成至 ../frontend/public 目录！")
		}
	}()
	ctx.JSON(http.StatusOK, gin.H{"status": "building"})
}

func (h *StrapiHandler) syncDataAndBuild() error {
	// 1. 获取 Strapi 数据
	resp, err := http.Get("http://localhost:1337/api/articles")
	if err != nil {
		return fmt.Errorf("请求 Strapi 接口失败: %v", err)
	}
	defer resp.Body.Close()

	body, err := io.ReadAll(resp.Body)
	if err != nil {
		return fmt.Errorf("读取 Strapi 响应失败: %v", err)
	}

	// 拦截非 200 状态码（比如 403 权限未开）
	if resp.StatusCode != http.StatusOK {
		return fmt.Errorf("Strapi 返回异常状态码: %d, 响应体: %s", resp.StatusCode, string(body))
	}

	var result StrapiResponse
	if err := json.Unmarshal(body, &result); err != nil {
		return fmt.Errorf("解析 JSON 失败: %v, 原始数据: %s", err, string(body))
	}

	log.Printf("成功从 Strapi 拉取到 %d 篇文章", len(result.Data))

	// 2. 写入 Hugo 目录
	postsDir := "../frontend/content/posts/"
	os.RemoveAll(postsDir)
	if err := os.MkdirAll(postsDir, 0755); err != nil {
		return fmt.Errorf("创建文章目录失败: %v", err)
	}

	tmpl, err := template.New("md").Parse(mdTemplate)
	if err != nil {
		return fmt.Errorf("解析 Markdown 模板失败: %v", err)
	}

	for _, item := range result.Data {
		// 修改这里，直接访问 item.Slug
		slug := item.Slug
		if slug == "" {
			slug = fmt.Sprintf("article-%d", item.Id)
			log.Printf("⚠️ 警告: 文章《%s》的 Slug 为空，自动重命名为: %s", item.Title, slug)
		}

		fileName := filepath.Join(postsDir, fmt.Sprintf("%s.md", slug))
		file, err := os.Create(fileName)
		if err != nil {
			log.Printf("❌ 创建文件 %s 失败: %v", fileName, err)
			continue
		}

		err = tmpl.Execute(file, item)
		if err != nil {
			log.Printf("❌ 写入模板内容至 %s 失败: %v", fileName, err)
		}
		file.Close()
	}

	// 3. 执行 Hugo 构建
	cmd := exec.Command("hugo")
	cmd.Dir = "../frontend"

	// 核心修复：捕获 Hugo 的完整输出信息，而不仅仅是退出状态码
	output, err := cmd.CombinedOutput()
	if err != nil {
		return fmt.Errorf("Hugo 构建失败: %v\nHugo 详细报错信息:\n%s", err, string(output))
	}

	return nil
}

// 彻底适配 Strapi v5 拍平后的 JSON 结构
type StrapiResponse struct {
	Data []struct {
		Id          int    `json:"id"`
		Title       string `json:"title"`
		Description string `json:"description"` // 匹配你的 JSON 里的 description
		Slug        string `json:"slug"`
		PublishedAt string `json:"publishedAt"` // 直接复用 Strapi 的发布时间，解决未来时间不渲染的问题
	} `json:"data"`
}

// 去掉 Attributes 前缀，直接渲染，并自动使用真实的发布时间
const mdTemplate = `---
title: "{{.Title}}"
slug: "{{.Slug}}"
date: {{.PublishedAt}}
---

{{.Description}}
`

export default {
  config: {
    // 替换登录页的语言
    locales: ['zh-Hans'],
    // 替换后台左上角的文字
    translations: {
      'zh-Hans': {
        'Auth.form.welcome.title': '欢迎使用企业内容管理系统',
        'Auth.form.welcome.subtitle': '登录您的专属后台',
        'app.components.LeftMenu.navbrand.title': 'XX企业后台',
      },
    },
    // 替换登录页和左上角的 Logo (将图片放在 src/admin/extensions/ 目录下)
    auth: {
      logo: './extensions/my-company-logo.png',
    },
    menu: {
      logo: './extensions/my-company-icon.png',
    },
  },
  bootstrap(app) {
    console.log(app);
  },
};