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 访客徽章)与 `