先改这四件事
大多数团队上线前只需要改四处:品牌、内容、价格、多语言。每一处都有明确的位置,上游更新可以正常合并。
| 修改 | 位置 | 说明 |
|---|---|---|
| Logo / favicon | public/logo*.png、public/favicon* | 保持文件名不变,就不用改组件 |
| 站点名 / SEO 默认值 | src/lib/seo.ts(SITE_NAME、默认关键词) | 所有页面 head 共用 |
| 营销文案 | messages/{en,zh,de}/*.json | Paraglide 消息目录,无需改代码 |
| 博客文章 | content/english-blog/*.md + 发布管线 | frontmatter 驱动 |
| 模板目录 | 管理后台(数据库)或 src/content/templates/*.json 兜底 | 有数据库时以数据库为准 |
| 价格 / 套餐 | 计费目录 + /pricing 页面数据 | 价格来自 Stripe,不是硬编码字符串 |
| 颜色 / 主题 | 全局样式表里的 CSS 变量 | 改 token,不要逐个改组件 |
不改组件也能换品牌
- 替换
public/里的 logo 文件(同名、同尺寸)。 - 更新
src/lib/seo.ts的SITE_NAME与默认 OG 图。 - 在消息目录里改页脚/关于文案。
- 在全局 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。新增语言:
- 在 Paraglide 配置里加 locale,并创建
messages/<locale>/。 - 翻译消息目录(首版可机翻,营销文案需人工复核)。
- 在
content/i18n/<locale>/加博客译文,slug与group_id必须与源文一致。 - 为要在该市场销售的商品添加目录语言行。
价格与计费
价格从计费目录(Stripe 支撑)读取。改价步骤:
- 更新 Stripe 商品/价格。
- 更新目录行的计费引用。
- 提升目录缓存版本,让页面立即生效。
不要在组件里硬编码价格——定价页、模板页、结账读的是同一个来源。
不要改的文件
src/paraglide/**—— 生成物,改messages/。src/routeTree.gen.ts—— 路由生成物。- 已在生产执行过的迁移文件 —— 新增迁移,不要改旧的。
安全升级
合并流程与许可范围见许可与更新。