31 lines
1.8 KiB
Markdown
31 lines
1.8 KiB
Markdown
# famzheng.me
|
||
|
||
自己维护的应用入口与博客，纯静态 HTML/CSS/JS。不再依赖 Hugo、PaperMod 或运行时后端。
|
||
|
||
## 开发与发布
|
||
|
||
源码：~/projects/fzc-src/blog（本机）；生产：ssh fzc。服务器只接收构建产物。
|
||
构建要求 Python 3.10+ 和 uv；浏览器回归使用 Playwright，可通过 npm ci 安装。
|
||
|
||
- make install：安装固定版本构建依赖。
|
||
- make test：文章完整性、站内链接、RSS、应用清单测试。
|
||
- make serve：http://127.0.0.1:4176 本地预览。
|
||
- make deploy：本机构建测试，rsync 产物，切换指定站点的挂载目录，公网验收。
|
||
|
||
应用清单集中在 apps.json：名称、简介、URL、分类、图标、访问提示。不要放密钥、分享令牌或管理初始化链接。
|
||
|
||
文章在 content/posts/<slug>.md，保留 YAML frontmatter（title/date/summary/draft/tags）。文件名就是永久 URL。原有 11 篇文章全文、/posts/、/about/、标签、归档、分页旧地址、RSS 和 /demos/ 均保留。
|
||
|
||
assets/ 是独立设计；首页无外部字体、分析脚本或 JS 框架。过滤是渐进增强，无 JS 仍可浏览全部入口。只有含 Mermaid 的文章按需加载固定版本渲染器，失败保留文本。
|
||
|
||
## 部署边界与回滚
|
||
|
||
沿用 gnoc-hugo/hugo 的 nginx、Service、Ingress 与 TLS；名称是历史兼容，不再运行 Hugo。
|
||
每次产物上传到 /var/gnoc/site-releases/<timestamp>-<commit>，只更新该 Deployment 的 site hostPath；失败恢复原目录。
|
||
原 /var/gnoc/hugo-public 和每版发布目录保留，可回滚 Deployment 或改回发布时显示的旧路径。
|
||
Gitea、其他子域名、数据库及私人应用数据不受影响。CI 仅校验，不再在服务器重建站点。
|
||
|
||
## 文风
|
||
|
||
第一人称、自然简洁。原文不为改版而改写；不要替作者捏造经历、观点或项目能力。
|