全部文章

操作手册:这里的文章怎么排版

一份随手可查的样张,列出文章里能用到的所有元素:标题、代码、公式、表格、提示框和图表。


这篇是本站的排版样张。文章能用到的元素都在这里,方便我集中检查样式,写作时也能直接照抄语法。每次改设计,我第一个打开的就是这一页。

正文

中文正文使用系统黑体(苹方、思源黑体或微软雅黑),西文和数字使用 Archivo,行宽控制在一屏舒适阅读的范围内。加粗只留给扫读时必须看到的那一句,斜体用于书名和术语,行内代码用于文件名,比如 astro.config.mjs。链接长这样,指向 Astro 文档。快捷键写作 Shift + /。脚注集中放在文末。1

先让它能用,再让它正确,最后让它快。顺序比速度更重要。

列表

无序列表使用方块标记:

  • 每个大版本和小版本都附带发布说明。
  • 热修复不走发布火车,但仍然要有工单。
    • 嵌套条目缩进一级。
  • 没有负责人的事情不发布。

有序列表使用两位数编号,短序列也能对齐:

  1. 拉发布分支。
  2. 冻结范围,跑回归测试。
  3. 发布,然后记下让你意外的地方。

提示框

代码

代码块带有语言标签和复制按钮,高亮配色跟随站点主题。

ts
// src/scripts/shutter-timing.ts
export const FULL = { close: 280, hold: 130, open: 420 };
export const QUICK = { close: 190, hold: 30, open: 320 };
python
import torch.nn.functional as F

def dpo_loss(policy_logratios, reference_logratios, beta=0.1):
    """每个参数都是同一个模型的 log p(chosen | x) - log p(rejected | x)。"""
    return -F.logsigmoid(beta * (policy_logratios - reference_logratios)).mean()
sh
pnpm install
pnpm dev

公式

行内公式嵌在句子里:直接偏好优化(DPO)让策略 πθ\pi_\theta 不要偏离参考策略 πref\pi_{\text{ref}} 太远,β\beta 控制偏离的程度。独立公式单独成块,窄屏上可以横向滚动:

LDPO=− E(x, yw, yl)∼D[log⁡σ ⁣(βlog⁡πθ(yw∣x)πref(yw∣x)−βlog⁡πθ(yl∣x)πref(yl∣x))]\mathcal{L}_{\text{DPO}} = -\,\mathbb{E}_{(x,\,y_w,\,y_l)\sim\mathcal{D}} \left[\log \sigma\!\left( \beta \log \frac{\pi_\theta(y_w \mid x)}{\pi_{\text{ref}}(y_w \mid x)} - \beta \log \frac{\pi_\theta(y_l \mid x)}{\pi_{\text{ref}}(y_l \mid x)} \right)\right]

表格

表格使用等宽数字,数值可以上下对齐。下面这张表就是你进入本页时看到的跳转动效。

阶段栏目切换栏目内跳转动作
合拢280 ms190 ms加速撞合
锁定130 ms30 ms锁定画面显示目标页名
分开420 ms320 ms快速弹开,缓慢停稳

图表

图表带编号说明,只画真实数据。这张图和跳转代码读取的是同一组常量。

两种跳转的时序对比 0 100 200 300 400 500 600 700 800 900 栏目切换 合拢 280 锁定 130 分开 420 栏目内跳转 合拢 190 分开 320
图 01 · 装甲闭合的时序(毫秒)。数据直接来自 src/scripts/shutter-timing.ts。

折叠内容

为什么闸门要等下一页加载?

面板合拢的同时下一页在后台下载,等待时间就藏在动画后面。页面提前到达,锁定画面依然会停一拍;页面来得晚,面板上会出现进度线。


工具箱就是这些。以后的文章如果需要新元素,会先加到这一页。

脚注

  1. 本站目前还没有绑定任何快捷键,这里只是展示样式。 ↩