feat(admin): Sveltia 管理台正式收编——页脚入口与使用指南
- Footer「管理」入口(data-astro-reload 绕 ClientRouter,官方集成守则) - docs/管理台.md:Token 登录/上传流/纪律(title 必填、内建优化禁用的 why、删除连带实测行为)/已知限制——试水期结论"值得留"转正 验证: pnpm astro build exit 0;dist 页脚含 /admin/ 入口 Spec: none (收编小特性:入口+文档,单提交意图) Co-authored-by: GLM-5.3
This commit is contained in:
1 parent
e57c853f20
commit
f57b1bde5f
1 file changed
+25
+25
@@ -0,0 +1,25 @@
|
|||||||
|
# 管理台(Sveltia CMS)使用指南
|
||||||
|
|
||||||
|
> 地址:`https://wait4x.online/admin/`(页脚「管理」入口)| 用途:照片上传与 sidecar 编辑的图形界面 | 保存即 commit 到 main → webhook 自动构建发布(约 10 秒上线)
|
||||||
|
|
||||||
|
## 登录
|
||||||
|
|
||||||
|
选 **Sign In with Token** → 用 gitea 的 access token(宿主 `~/docker_apps/gitea/init-templates.txt` 里的 api-token,或 gitea 网页新建 scope=read/write:repository)。token 存浏览器 localStorage,下次免登。
|
||||||
|
|
||||||
|
## 照片上传流
|
||||||
|
|
||||||
|
1. 图库照片 → New Entry:填标题(**必填**,空标题会让构建炸——实测坑)、选分组(street/landscape)、可写 alt
|
||||||
|
2. 图片字段 → 资产库上传 jpg(与 sidecar 同目录落位,零重压缩)
|
||||||
|
3. Save → 自动 commit + 构建 → 画廊出现(EXIF 构建期自动提取,exif 字段留空即可)
|
||||||
|
|
||||||
|
## 纪律(与写作指南同源)
|
||||||
|
|
||||||
|
- **图片体积**:上传前自行压缩(长边 ≤2400px)——Sveltia 内建优化**刻意关闭**(会抹 EXIF 断构建期提取管线)
|
||||||
|
- **删除**:删条目会连带删除被其独占引用的 jpg(实测行为,官方文档说的"不连带"是错的)
|
||||||
|
- EXIF 覆盖字段一般留空;文章 markdown 仍建议本地/gitea web 写(Sveltia 只管照片)
|
||||||
|
- 保存直连 main 无分支缓冲——webhook 构建是安全网,构建失败 gitea 的 webhook 投递记录可查
|
||||||
|
|
||||||
|
## 已知限制
|
||||||
|
|
||||||
|
- 启动时探测 /api/forgejo 报 404 属良性回落(日志噪音,无影响)
|
||||||
|
- 大视频仍走仓外 store + /media/ 绝对路径(见写作指南体积纪律表)
|
||||||
Reference in new issue
Block a user