From 0b0307b12f3da894264de96ae10c8de854ba8504 Mon Sep 17 00:00:00 2001 From: wait4xx Date: Mon, 2 Nov 2026 20:37:01 +0800 Subject: [PATCH] =?UTF-8?q?docs(admin):=20=E8=A1=A5=E6=A1=A3=E6=A1=88?= =?UTF-8?q?=E5=8D=A1=E4=B8=8E=E8=AE=A1=E6=95=B0=E5=BE=BD=E6=A0=87=E8=AF=B4?= =?UTF-8?q?=E6=98=8E=EF=BC=885h=20T7=20=E6=96=87=E6=A1=A3=E6=94=B6?= =?UTF-8?q?=E5=B0=BE=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 管理台「开源页」节：说明开篇已改原生 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 --- content/.link-cache.json | 7 +++++++ docs/管理台.md | 38 ++++++++++++++++++++++++++++++++++++++ 2 files changed, 45 insertions(+) diff --git a/content/.link-cache.json b/content/.link-cache.json index e7eec4a..628deb9 100644 --- a/content/.link-cache.json +++ b/content/.link-cache.json @@ -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 } } diff --git a/docs/管理台.md b/docs/管理台.md index 14593a6..c3846ab 100644 --- a/docs/管理台.md +++ b/docs/管理台.md @@ -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：`彩色 + 楷体`（可用类清单见写作指南「文章排版类」一节，与文章完全同一份白名单） +- 仍守外壳灰阶纪律：彩色是**强调**不是装饰，一页 ≤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 访客徽章）与 `
` 居中——本站按普通块渲染，故居中失效；外链图在慢网或被墙时全空白。这也是当初"部分内容没居中、有些图片没显示"的根因。 + | 字段 | 取值 | 说明 | |---|---|---| | `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 断构建期提取管线）