docs(admin): 补档案卡与计数徽标说明（5h T7 文档收尾）
- 管理台「开源页」节：说明开篇已改原生 GitHub 档案卡（零第三方图片、 语言占比灰阶、取数失败只隐藏该项），并把 intro_from: github-readme 标为「仍可用但不推荐」——点名 7 类外链图与 align 居中失效正是用户 报告的"没居中/图片不显示"根因 - 新增「浏览与评论计数」节：眼睛/气泡含义、一页只计一次（其余为只读镜像， 不会出现两个不同数字）、开评论不算浏览、接口挂掉显示「–」不给假零、 换页重计属定义而非双计 验证: pnpm astro build exit 0 Spec: 2026-11-02_blog-5h-content-social (T7 收尾) Co-authored-by: GLM-5.3
This commit is contained in:
wait4xandGLM-5.3 committed
1 parent
3e377adc7f
commit
0b0307b12f
2 files changed
+45
No files matched your search
@@ -27,5 +27,12 @@
|
||||
"image": "https://astro.build/og/astro.jpg",
|
||||
"favicon": "https://astro.build/favicon.svg",
|
||||
"ts": 1793593759816
|
||||
},
|
||||
"https://astro.build": {
|
||||
"title": "Astro",
|
||||
"desc": "Astro builds fast content sites, powerful web applications, dynamic server APIs, and everything in-between.",
|
||||
"image": "https://astro.build/og/astro.jpg",
|
||||
"favicon": "https://astro.build/favicon.svg",
|
||||
"ts": 1793621147252
|
||||
}
|
||||
}
|
||||
+38
@@ -24,6 +24,27 @@
|
||||
- **文章英文版**：不在后台写。跑 `python3 scripts/translate/translate_posts.py` 生成 `content/posts-en/` 同名文件；手写润色过的译文在 frontmatter 写 `locked: true`，翻译脚本会无条件跳过它。
|
||||
- **保存即提交**：后台保存等于向仓库提交，push 后约 10 秒自动构建上线。
|
||||
|
||||
## 文章置顶（5h 新增）
|
||||
|
||||
文章编辑页有一个「置顶」开关。打开后这篇文章排在首页分轨、归档、书架三处列表的最前面，列表里显示一个灰阶「置顶」小徽标。
|
||||
|
||||
语义边界（刻意如此，别当 bug 报）：
|
||||
- **只影响列表顺序**：`pubDate` 不变、URL 不变、RSS 里的时间序列不变，订阅者不会看到时间错乱
|
||||
- 多篇同时置顶时，置顶组内部仍按日期倒序
|
||||
- 关掉开关立即恢复时间序，没有"冷却期"
|
||||
|
||||
## 瞬间（5h 起与文章同级）
|
||||
|
||||
「瞬间」集合的「文字」字段是 **markdown 编辑器**，与文章同一套表达力：
|
||||
|
||||
- markdown：`**加粗**`、`*斜体*`、列表、`> 引用`、`` `行内代码` ``
|
||||
- 排版类 HTML：`<span class="c-blue font-kai">彩色 + 楷体</span>`（可用类清单见写作指南「文章排版类」一节，与文章完全同一份白名单）
|
||||
- 仍守外壳灰阶纪律：彩色是**强调**不是装饰，一页 ≤3 处
|
||||
|
||||
**每条瞬间自带评论区**：时间线卡片下方有「评论」折叠条，读者点开才加载评论（不点开不为它付任何加载成本）。中文页与英文页共用同一条评论流，语言切换不会丢评论。
|
||||
|
||||
**每条的浏览 / 评论数字是只读的**：读者点开评论区不会虚增浏览数（只有整页访问才计一次）。
|
||||
|
||||
## 照片上传流
|
||||
|
||||
1. 图库照片 → New Entry：填标题（**必填**，空标题会让构建炸——实测坑）、选分组（street/landscape）、可写 alt
|
||||
@@ -118,6 +139,12 @@ blocks:
|
||||
|
||||
### 开源页（opensource.yaml）
|
||||
|
||||
**开篇是原生「GitHub 档案卡」（5h 起）**：头像 / 名字@handle / 定位叙述 / 社交图标 / 统计四格（关注者、公开仓、总星标）/ 语言占比灰阶条（只有第一名用强调色，其余灰阶）。**零第三方图片、零 iframe**。数据失败只隐藏对应数字，不会破版。
|
||||
|
||||
想换那段「定位叙述」，改本文件的 `blurb` + `blurb_after`（双语，后台可改）——它们现在同时供给档案卡与项目墙下方的说明。
|
||||
|
||||
下面的 `intro_from: "github-readme"` **仍可用但不推荐**：那会把 GitHub 专用 README 原样渲染，带 7 类外链图（shields.io、readme-typing-svg、github-readme-stats、streak-stats、activity-graph、snake、komarev 访客徽章）与 `<div align="center">` 居中——本站按普通块渲染，故居中失效；外链图在慢网或被墙时全空白。这也是当初"部分内容没居中、有些图片没显示"的根因。
|
||||
|
||||
| 字段 | 取值 | 说明 |
|
||||
|---|---|---|
|
||||
| `pinned` | 仓短名数组 | 置顶顺序即展示顺序 |
|
||||
@@ -143,6 +170,17 @@ token 位在 `~/docker_apps/blog/github-token.txt`（本机，0600）。
|
||||
- **README 里的相对链接不重写**（如 `./img/x.png`、`docs/foo.md`）：它们相对 GitHub 仓根解析，在本站没有对应产物，点了多半 404。保原样比猜一个基址可信，所以不做改写。
|
||||
- **外部徽章图片加固但不参与构建**：shields.io、readme-typing-svg 这类第三方徽章在构建期**不抓取**，渲染时统一补 `loading="lazy"`（缺 alt 补空），它们慢、被墙或 404 都不影响页面渲染；尺寸已由样式限制在内容宽度内。
|
||||
|
||||
## 浏览与评论计数（5h 新增）
|
||||
|
||||
文章页、瞬间页、开源页、关于页都用同一枚灰阶徽标：**眼睛图标 = 浏览数，气泡图标 = 条评论**，数据来自自建 Artalk，不依赖任何第三方徽章服务。
|
||||
|
||||
几条行为约定（省得当成 bug）：
|
||||
|
||||
- **一页只计一次浏览**：「计一次」发生在这页唯一那个 `page` 模式徽标（文章页在标题下方），同一页其余徽标都是只读镜像，显示的是同一个数字——不会出现"页头 17、评论区 16"
|
||||
- **开评论不算浏览**：瞬间逐条徽标是只读的，读者展开评论区不会给那条动态虚增浏览量
|
||||
- **接口挂掉显示「–」而不是 0**：宁可留白，也不给读者看一个错误的零
|
||||
- **换页重计、同页刷新重计**：这是浏览量的定义，不是重复计数的 bug（软导航回同一页也算新一次访问）
|
||||
|
||||
## 纪律（与写作指南同源）
|
||||
|
||||
- **图片体积**：上传前自行压缩（长边 ≤2400px）——Sveltia 内建优化**刻意关闭**（会抹 EXIF 断构建期提取管线）
|
||||
|
||||
Reference in new issue
Block a user