部署指南

定制指南

在不破坏升级的前提下修改品牌、内容、价格与多语言的位置。

先改这四件事

大多数团队上线前只需要改四处:品牌、内容、价格、多语言。每一处都有明确的位置,上游更新可以正常合并。

修改位置说明
Logo / faviconpublic/logo*.png、public/favicon*保持文件名不变,就不用改组件
站点名 / SEO 默认值src/lib/seo.ts(SITE_NAME、默认关键词)所有页面 head 共用
营销文案messages/{en,zh,de}/*.jsonParaglide 消息目录,无需改代码
博客文章content/english-blog/*.md + 发布管线frontmatter 驱动
模板目录管理后台(数据库)或 src/content/templates/*.json 兜底有数据库时以数据库为准
价格 / 套餐计费目录 + /pricing 页面数据价格来自 Stripe,不是硬编码字符串
颜色 / 主题全局样式表里的 CSS 变量改 token,不要逐个改组件

不改组件也能换品牌

  1. 替换 public/ 里的 logo 文件(同名、同尺寸)。
  2. 更新 src/lib/seo.ts 的 SITE_NAME 与默认 OG 图。
  3. 在消息目录里改页脚/关于文案。
  4. 在全局 CSS 里调整主题 token(如 --coral、--sea-ink)。

提示

文件名与消息 key 保持稳定,git pull 上游时几乎不会与你的品牌改动冲突。

内容模型

  • 博客:带 YAML frontmatter 的 Markdown(title、slug、date、tags、locale)。发布管线会先校验 EEAT 字段再写库。
  • 文档:src/content/deploy/ 与 src/content/features/ 下的 Markdown,构建时加载。加文件、加导航项即可。
  • 目录:商品、语言、媒体、FAQ 都在数据库里,用管理后台编辑。src/content/templates/ 的静态 JSON 只是兜底。

多语言

站点自带 en、zh、de。新增语言:

  1. 在 Paraglide 配置里加 locale,并创建 messages/<locale>/。
  2. 翻译消息目录(首版可机翻,营销文案需人工复核)。
  3. 在 content/i18n/<locale>/ 加博客译文,slug 与 group_id 必须与源文一致。
  4. 为要在该市场销售的商品添加目录语言行。

价格与计费

价格从计费目录(Stripe 支撑)读取。改价步骤:

  1. 更新 Stripe 商品/价格。
  2. 更新目录行的计费引用。
  3. 提升目录缓存版本,让页面立即生效。

不要在组件里硬编码价格——定价页、模板页、结账读的是同一个来源。

不要改的文件

  • src/paraglide/** —— 生成物,改 messages/。
  • src/routeTree.gen.ts —— 路由生成物。
  • 已在生产执行过的迁移文件 —— 新增迁移,不要改旧的。

安全升级

合并流程与许可范围见许可与更新。