内容更新与部署指南文档
面向协作者与 AI 的「后续开发 + 文章更新」指南,明确代码仓与内容仓的使用方式。
时间周期
2025 Q1
工具
Markdown, 脚本
客户
个人
项目概述
在 MyWebsite 仓库的 docs/ 下维护《后续开发+文章更新指南》,用于说明:代码与内容分仓、环境变量、开发与部署流程、内容与素材的维护方式,以及给 AI 的提示词建议。目标是让后续协作者(含 AI)能按同一套规则操作,减少误改与部署事故。
技术栈
- 文档格式:Markdown。
- 与脚本配合:如
sync-content-to-repo.sh、deploy-content-only.sh、deploy-to-server.sh等,在文档中写明调用时机与路径。
核心特点
- 明确边界:代码在 MyWebsite,内容在 MyWebsite_Contents,严禁混淆。
- 环境变量:强调 CONTENT_BASE_PATH、CATEGORIES_TAGS_FILE 等必须正确配置。
- 先内容、后代码:写文章/传图只动内容仓;改逻辑/样式只动代码仓;部署时可只更内容或全量更新。
- 提示词示例:给出可直接复用的提示词,限制 AI 只改代码或只改内容,并在关键步骤前做 git status 等确认。
成果与后续
文档已覆盖日常开发、内容更新、服务器操作与故障排查。后续可根据新脚本或新模块继续在文档中补充路径与命令,并保持「代码仓 / 内容仓」的表述一致。