清明时候我去大理丽江，前一天晚上特别赶，我走的时候没有仔细检查镜头。SONY的屏幕比较小，拍摄的时候我主要关注曝光，构图，没有发现相片上有一些脏污。

仔细检查，污点由镜头上的灰尘引起，在小光圈的情况下，污点尤其明显。

污点映射到照片中的位置，因光圈大小、焦段而改变。

处理一张图片的污点，同步操作到所有的照片的办法是错误的。

续

经过半天摸索，我也算是摸索出了一套效率比较高的办法

• step1 首先选择一张有脏污的图片，按Q使用移除工具对污点进行移除，移除过程中的一些技巧，例如污点视图等不在此详述。

• step2

在移除了单张图片的污点之后，按住Shift，在图库中选择其他需要同步的照片。

注意：截图右上角显示了照片的光圈和焦距。只有在光圈和焦距相同的照片上，我们才能够进行同步。

• step3

在选定了需要同步的照片以后，我们点击界面右下角的同步按钮，即可同时批量消除所选全部照片中的污点。

图注

使用标准的 Markdown 图像语法 ![alt](src)，即可自动生成图注。在 alt 前添加下划线 _ 或留空 alt，即可隐藏图注。

语法

![图片描述](https://image.radishzz.cc/image/gallery/06.webp)

![_图片描述](https://image.radishzz.cc/image/gallery/06.webp)

效果

提示块

使用 GitHub 语法 > [!TYPE] 或三冒号语法 :::type，即可创建提示块。支持 note、tip、important、warning、caution 五种类型。

语法

> [!NOTE]
> 即使快速浏览，也值得用户留意的信息。

> [!TIP]
> 可选信息，可帮助用户更轻松地完成操作。

> [!IMPORTANT]
> 用户成功所需的关键信息。

:::warning
由于存在潜在风险，需要用户立即关注的关键内容。
:::

:::caution
某些操作可能带来的负面后果。
:::

:::note[自定义标题]
这是一个自定义标题的提示块。
:::

效果

[!NOTE] 即使快速浏览，也值得用户留意的信息。

[!TIP] 可选信息，可帮助用户更轻松地完成操作。

[!IMPORTANT] 用户成功所需的关键信息。

:::warning 由于存在潜在风险，需要用户立即关注的关键内容。 :::

:::caution 某些操作可能带来的负面后果。 :::

:::note[自定义标题] 这是一个自定义标题的提示块。 :::

折叠块

使用三冒号语法 :::fold[title]，即可创建折叠块。点击标题可以展开或收起。

语法

:::fold[使用提示]
如果需要添加并非所有读者都会感兴趣的内容，可以将其放在折叠块中。
:::

效果

:::fold[使用提示] 如果需要添加并非所有读者都会感兴趣的内容，可以将其放在折叠块中。 :::

Mermaid 图表

使用代码块包裹 Mermaid 语法，并标注语言类型 mermaid，即可创建 Mermaid 图表。

语法

```mermaid
graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;
```

效果

graph TD;
    A-->B;
    A-->C;
    B-->D;
    C-->D;

画廊

使用三冒号语法 :::gallery，即可创建图片画廊。水平滚动以查看更多图片。

语法

:::gallery
![羊驼](https://image.radishzz.cc/image/gallery/sheep-1.jpg)
![转头](https://image.radishzz.cc/image/gallery/sheep-2.jpg)
![对视](https://image.radishzz.cc/image/gallery/sheep-3.jpg)
![小羊驼](https://image.radishzz.cc/image/gallery/sheep-4.jpg)
![可爱捏](https://image.radishzz.cc/image/gallery/sheep-5.jpg)
:::

效果

:::gallery :::

GitHub 仓库

使用双冒号语法 ::github{repo="owner/repo"}，即可嵌入 GitHub 仓库。

语法

::github{repo="radishzzz/astro-theme-retypeset"}

效果

::github{repo="radishzzz/astro-theme-retypeset"}

视频

使用双冒号语法 ::youtube{id="video-id"}，即可嵌入视频。

语法

::youtube{id="9pP0pIgP2kE"}

::bilibili{id="BV1sK4y1Z7KG"}

效果

::youtube{id="9pP0pIgP2kE"}

::bilibili{id="BV1sK4y1Z7KG"}

Spotify

使用双冒号语法 ::spotify{url="spotify-url"}，即可嵌入 Spotify 内容。

语法

::spotify{url="https://open.spotify.com/track/0HYAsQwJIO6FLqpyTeD3l6"}

::spotify{url="https://open.spotify.com/album/03QiFOKDh6xMiSTkOnsmMG"}

效果

::spotify{url="https://open.spotify.com/track/0HYAsQwJIO6FLqpyTeD3l6"}

::spotify{url="https://open.spotify.com/album/03QiFOKDh6xMiSTkOnsmMG"}

X 推文

使用双冒号语法 ::tweet{url="tweet-url"}，即可嵌入 X 推文。

语法

::tweet{url="https://x.com/hachi_08/status/1906456524337123549"}

效果

::tweet{url="https://x.com/hachi_08/status/1906456524337123549"}

CodePen

使用双冒号语法 ::codepen{url="codepen-url"}，即可嵌入 CodePen 演示。

语法

::codepen{url="https://codepen.io/jh3y/pen/NWdNMBJ"}

效果

::codepen{url="https://codepen.io/jh3y/pen/NWdNMBJ"}

为满足个性化需求，我为主题制作了一些配色方案。你可以在 src/config.ts 中替换默认配色，并重启开发服务器以预览新配色。

葱白

light: {
  primary: 'oklch(0.25 0.03 211.86)',
  secondary: 'oklch(0.40 0.03 211.86)',
  background: 'oklch(0.99 0.0039 106.47)',
  highlight: 'oklch(0.93 0.195089 103.2532 / 0.5)',
},
dark: {
  primary: 'oklch(0.92 0.0015 106.47)',
  secondary: 'oklch(0.79 0.0015 106.47)',
  background: 'oklch(0.24 0.0039 106.47)',
  highlight: 'oklch(0.93 0.195089 103.2532 / 0.2)',
},

鸦青

light: {
  primary: 'oklch(0.24 0.0172 280.05)',
  secondary: 'oklch(0.40 0.0172 280.05)',
  background: 'oklch(0.98 0.0172 280.05)',
  highlight: 'oklch(0.93 0.195089 103.2532 / 0.5)',
},
dark: {
  primary: 'oklch(0.92 0.0172 280.05)',
  secondary: 'oklch(0.79 0.0172 280.05)',
  background: 'oklch(0.24 0.0172 280.05)',
  highlight: 'oklch(0.93 0.195089 103.2532 / 0.2)',
},

墨蓝

light: {
  primary: 'oklch(0.24 0.053 261.24)',
  secondary: 'oklch(0.39 0.053 261.24)',
  background: 'oklch(1 0 0)',
  highlight: 'oklch(0.93 0.195089 103.2532 / 0.5)',
},
dark: {
  primary: 'oklch(0.92 0 0)',
  secondary: 'oklch(0.79 0 0)',
  background: 'oklch(0.24 0.016 265.21)',
  highlight: 'oklch(0.93 0.195089 103.2532 / 0.2)',
},

米黄

light: {
  primary: 'oklch(0.25 0 0)',
  secondary: 'oklch(0.41 0 0)',
  background: 'oklch(0.95 0.0237 59.39)',
  highlight: 'oklch(0.93 0.195089 103.2532 / 0.5)',
},
dark: {
  primary: 'oklch(0.93 0.019 59.39)',
  secondary: 'oklch(0.80 0.017 59.39)',
  background: 'oklch(0.23 0 0)',
  highlight: 'oklch(0.93 0.195089 103.2532 / 0.2)',
},

群论

Burnside 引理，有时也称为 Burnside 计数定理、Cauchy-Frobenius 引理或轨道计数定理。

设 $\wedge$ 是有限群 $G$ 在有限集合 $X$ 上的群作用。那么作用的轨道数 $t$ 由下面的公式给出。

$$ t=\frac{1}{|G|}\sum_{g\in G}|\text{Fix}(g)| $$

对于每个整数 $n\ge2$，商群 $\mathbb{Z}/n\mathbb{Z}$ 是由 $1+n\mathbb{Z}$ 生成的循环群，因此 $\mathbb{Z}/n\mathbb{Z}\cong\mathbb{Z}_n$。

商群 $\mathbb{R}/\mathbb{Z}$ 同构于 $([0,1),+_1)$，即区间 $[0,1)$ 上以 1 为模的实数加法群。

同构定理。设 $\phi\colon(G,\circ)\to(H,*)$ 是一个同态。那么函数

$$ \begin{aligned} f\colon G/\text{Ker}(\phi)&\to\text{Im}(\phi)\ x\text{Ker}(\phi)&\mapsto\phi(x) \end{aligned} $$

是一个同构，因此

$$ G/\text{Ker}(\phi)\cong \text{Im}(\phi) $$

泰勒定理

设函数 $f$ 在包含点 $a$ 和 $x$ 的开区间上 $(n+1)$ 次可微。那么

$$ f(x)=f(a)+f'(a)(x-a)+\cdots+\frac{f^{(n)}(a)}{n!}(x-a)^n+R_n(x) $$

其中

$$ R_n(x)=\frac{f^{(n+1)}(c)}{(n+1)!}(x-a)^{n+1}, $$

对于 $a$ 和 $x$ 之间的某个 $c$。

$\KaTeX$ 没有右对齐选项，因此使用额外的对齐列来显示方程编号。它们通过 mkern 间距（默认为 \mkern100mu）被推到右侧。align 和 align* 环境都可以使用，\tag 和 \notag 也可以使用。

Align 环境

$$ \begin{align} \frac{\pi}{4n^2} &= \frac{4^n(n!)^2}{2n^2(2n)!}n(2n-1)J_{n-1}-\frac{4^n(n!)^2}{2n^2(2n)!}2n^2J_n \tag{1} \ &= \frac{4^n}{4(2n)!}\left(\frac{n!}{n}\right)^22n(2n-1)J_{n-1}-\frac{4^n(n!)^2}{(2n)!}J_n \tag{$\ddagger$} \ &= \frac{4^{n-1}((n-1)!)^2}{(2n-2)!}J_{n-1}-\frac{4^n(n!)^2}{(2n)!}J_n \tag{2} \end{align} $$

Align* 环境

$$ \begin{align} \frac{4^N(N!)^2}{(2N)!}J_N &\leq \frac{4^N(N!)^2}{(2N)!}\frac{\pi^2}{4}\frac{1}{2n+2}I_{2N} \tag{*} \ &= \frac{\pi^2}{8(N+1)}\frac{4^N(N!)^2}{(2N)!}I_{2N} \ &= \frac{\pi^2}{8(N+1)}\frac{\pi}{2} \tag{**} \ &= \frac{\pi^3}{16(N+1)} \ \frac{x}{\sin x} &\leq \frac{\pi}{2} \tag{3} \ \text{所以} \qquad\qquad x &\leq \frac{\pi}{2}\sin x \tag{4} \end{align} $$

级数求和

$$ \begin{align*} \sum_{i=1}^{k+1}i &= \left(\sum_{i=1}^{k}i\right) +(k+1) \tag{1} \ &= \frac{k(k+1)}{2}+k+1 \tag{2} \ &= \frac{k(k+1)+2(k+1)}{2} \tag{3} \ &= \frac{(k+1)(k+2)}{2} \tag{4} \ &= \frac{(k+1)((k+1)+1)}{2} \tag{5} \end{align*} $$

乘积符号

$$ 1 + \frac{q^2}{(1-q)}+\frac{q^6}{(1-q)(1-q^2)}+\cdots = \prod_{j=0}^{\infty}\frac{1}{(1-q^{5j+2})(1-q^{5j+3})}, \text{ 对于 }\lvert q\rvert < 1. $$

叉积

$$ \mathbf{V}_1 \times \mathbf{V}_2 = \begin{vmatrix} \mathbf{i} & \mathbf{j} & \mathbf{k} \[1ex] \frac{\partial X}{\partial u} & \frac{\partial Y}{\partial u} & 0 \[2.5ex] \frac{\partial X}{\partial v} & \frac{\partial Y}{\partial v} & 0 \end{vmatrix} $$

麦克斯韦方程组

$$ \begin{align*} \nabla \times \vec{\mathbf{B}} -, \frac1c, \frac{\partial\vec{\mathbf{E}}}{\partial t} &= \frac{4\pi}{c}\vec{\mathbf{j}} \ \nabla \cdot \vec{\mathbf{E}} &= 4 \pi \rho \ \nabla \times \vec{\mathbf{E}}, +, \frac1c, \frac{\partial\vec{\mathbf{B}}}{\partial t} &= \vec{\mathbf{0}} \ \nabla \cdot \vec{\mathbf{B}} &= 0 \end{align*} $$

希腊字母

$$ \begin{align*} &\Gamma\ \Delta\ \Theta\ \Lambda\ \Xi\ \Pi\ \Sigma\ \Upsilon\ \Phi\ \Psi\ \Omega\ &\alpha\ \beta\ \gamma\ \delta\ \epsilon\ \zeta\ \eta\ \theta\ \iota\ \kappa\ \lambda\ \mu\ \nu\ \xi\ \omicron\ \pi\ \rho\ \sigma\ \tau\ \upsilon\ \phi\ \chi\ \psi\ \omega\ \varepsilon\ \vartheta\ \varpi\ \varrho\ \varsigma\ \varphi \end{align*} $$

箭头符号

$$ \begin{align*} &\gets\ \to\ \leftarrow\ \rightarrow\ \uparrow\ \Uparrow\ \downarrow\ \Downarrow\ \updownarrow\ \Updownarrow\ &\Leftarrow\ \Rightarrow\ \leftrightarrow\ \Leftrightarrow\ \mapsto\ \hookleftarrow\ &\leftharpoonup\ \leftharpoondown\ \rightleftharpoons\ \longleftarrow\ \Longleftarrow\ \longrightarrow\ &\Longrightarrow\ \longleftrightarrow\ \Longleftrightarrow\ \longmapsto\ \hookrightarrow\ \rightharpoonup\ &\rightharpoondown\ \leadsto\ \nearrow\ \searrow\ \swarrow\ \nwarrow \end{align*} $$

符号

$$ \begin{align*} &\surd\ \barwedge\ \veebar\ \odot\ \oplus\ \otimes\ \oslash\ \circledcirc\ \boxdot\ \bigtriangleup\ &\bigtriangledown\ \dagger\ \diamond\ \star\ \triangleleft\ \triangleright\ \angle\ \infty\ \prime\ \triangle \end{align*} $$

示例取自 KaTeX Live Demo

标题

在文本前添加井号 # 与空格，即可创建标题。井号数量对应标题等级。

语法

# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果

一级标题

二级标题

三级标题

四级标题

五级标题

六级标题

段落

使用空行分隔文本，即可创建段落。

语法

孔乙己一到店，所有喝酒的人便都看着他笑，有的叫道：“孔乙己，你脸上又添上新伤疤了！”他不回答，对柜里说：“温两碗酒，要一碟茴香豆。”便排出九文大钱。他们又故意的高声嚷道：“你一定又偷了人家的东西了！”孔乙己睁大眼睛说：“你怎么这样凭空污人清白……”“什么清白？我前天亲眼见你偷了何家的书，吊着打。”孔乙己便涨红了脸，额上的青筋条条绽出，争辩道：“窃书不能算偷……窃书！……读书人的事，能算偷么？”接连便是难懂的话，什么“君子固穷”，什么“者乎”之类，引得众人都哄笑起来：店内外充满了快活的空气。

听人家背地里谈论，孔乙己原来也读过书，但终于没有进学，又不会营生；于是愈过愈穷，弄到将要讨饭了。

效果

孔乙己一到店，所有喝酒的人便都看着他笑，有的叫道：“孔乙己，你脸上又添上新伤疤了！”他不回答，对柜里说：“温两碗酒，要一碟茴香豆。”便排出九文大钱。他们又故意的高声嚷道：“你一定又偷了人家的东西了！”孔乙己睁大眼睛说：“你怎么这样凭空污人清白……”“什么清白？我前天亲眼见你偷了何家的书，吊着打。”孔乙己便涨红了脸，额上的青筋条条绽出，争辩道：“窃书不能算偷……窃书！……读书人的事，能算偷么？”接连便是难懂的话，什么“君子固穷”，什么“者乎”之类，引得众人都哄笑起来：店内外充满了快活的空气。

听人家背地里谈论，孔乙己原来也读过书，但终于没有进学，又不会营生；于是愈过愈穷，弄到将要讨饭了。

图片

使用感叹号 ! 方括号 [] 与圆括号 ()，即可添加图片。这些都是半角符号，而非全角符号。

语法

![图片描述](../_images/image-01.jpeg)

![图片描述](https://image.example.com/image-01.webp)

效果

块引用

使用 > 符号和空格，即可创建块引用，其中可包含多个段落。使用 <cite> 或 <footer> 标签，即可标注引用来源，同时可通过 [^1] 或 [^note] 格式插入脚注。

多个段落

语法

> 天地不仁，以万物为刍狗。
>
> **提示**：引用块内可使用 _Markdown 语法_。

效果

天地不仁，以万物为刍狗。

提示：引用块内可使用 Markdown 语法。

标注引用来源

语法

> 在我的后园，可以看见墙外有两株树，一株是枣树，还有一株也是枣树。
>
> —— <cite>《秋夜》[^1]</cite>

[^1]: 《[秋夜](https://zh.wikisource.org/wiki/%E7%A7%8B%E5%A4%9C_(%E9%AD%AF%E8%BF%85))》是鲁迅散文诗集《野草》中的第一首散文诗，创作于 1924 年。

效果

在我的后园，可以看见墙外有两株树，一株是枣树，还有一株也是枣树。

—— <cite>《秋夜》[^1]</cite>

[^1]: 《秋夜》是鲁迅散文诗集《野草》中的第一首散文诗，创作于 1924 年。

表格

使用三个或多个连字符 --- 分隔标题，并使用管道符 | 分隔每列，即可创建表格。

语法

| 斜体   | 粗体     | 代码   |
| ----- | ------- | ------ |
| _斜体_ | **粗体** | `代码` |
| _斜体_ | **粗体** | `代码` |

效果

代码块

使用三个反引号 ``` 包裹代码，即可创建代码块。在顶部的反引号后标注语言类型，例如 html、javascript、css、markdown 等，即可实现语法高亮。

语法

```html
<!doctype html>
<html lang="zh-CN">
  <head>
    <meta charset="utf-8" />
    <title>HTML5 示例文档</title>
  </head>
  <body>
    <p>测试</p>
  </body>
</html>
```

效果

<!doctype html>
<html lang="zh-CN">
  <head>
    <meta charset="utf-8" />
    <title>HTML5 示例文档</title>
  </head>
  <body>
    <p>测试</p>
  </body>
</html>

列表

有序列表

语法

1. 第一项
2. 第二项
3. 第三项

效果

1. 第一项
2. 第二项
3. 第三项

无序列表

语法

- 列表项
- 图表项
- 更多项

效果

• 列表项
• 图表项
• 更多项

嵌套列表

语法

- 水果
  - 苹果
  - 橙子
  - 香蕉
- 蔬菜
  - 青菜
  - 萝卜

效果

• 水果
  • 苹果
  • 橙子
  • 香蕉
• 蔬菜
  • 青菜
  • 萝卜

其他元素

包括 <sup> 上标，<sub> 下标，<abbr> 缩写，<del> 删除线，<u> 波浪线，<kbd> 键盘输入，<mark> 高亮，<hr> 分隔线。

语法

H<sub>2</sub>O

X<sup>n</sup> + Y<sup>n</sup> = Z<sup>n</sup>

<abbr title="Graphics Interchange Format">GIF</abbr> 是一种位图图像格式。

书籍是人类进步的<del>楼梯</del>阶梯。

优秀的作家总是会仔细检查<u title="拼写">拚写</u>问题。

按下 <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Delete</kbd> 以结束会话。

大多数<mark>蝾螈</mark>昼伏夜出，以昆虫、蠕虫等小生物为食。

使用三个连字符 `---` 或 `<hr>` 标签，即可创建如下分隔线。

---

效果

H₂O

Xⁿ + Yⁿ = Zⁿ

<abbr title="Graphics Interchange Format">GIF</abbr> 是一种位图图像格式。

书籍是人类进步的<del>楼梯</del>阶梯。

优秀的作家总是会仔细检查<u title="拼写">拚写</u>问题。

按下 <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>Delete</kbd> 以结束会话。

大多数<mark>蝾螈</mark>昼伏夜出，以昆虫、蠕虫等小生物为食。

使用三个连字符 --- 或 <hr> 标签，即可创建如下分隔线。

主题配置

通过修改配置文件 src/config.ts 来自定义你的博客。

站点信息

site: {
  // 站点标题
  title: 'Retypeset'
  // 站点副标题
  subtitle: 'Revive the beauty of typography'
  // 站点描述
  description: 'Retypeset is a static blog theme...'
  // 使用 src/i18n/ui.ts 中的多语言标题/副标题/站点描述，代替上方静态配置
  i18nTitle: true // true | false
  // 作者名称
  author: 'radishzz'
  // 站点地址
  url: 'https://retypeset.radishzz.cc'
  // 基础路径
  // 所有页面和资产的根目录
  base: '/' // 例如 '/blog', '/docs'
  // 站点图标
  // 推荐格式：svg, png, ico
  favicon: '/icons/favicon.svg' // 或 https://example.com/favicon.svg
}

主题配色

color: {
  // 默认主题
  mode: 'light' // light | dark | auto
  // 亮色模式
  light: {
    // 主要颜色
    // 用于站点标题、鼠标悬停效果等
    primary: 'oklch(25% 0.005 298)'
    // 次要颜色
    // 用于普通文本
    secondary: 'oklch(40% 0.005 298)'
    // 背景色
    background: 'oklch(96% 0.005 298)'
    // 高亮颜色
    // 用于导航栏、选中文本等
    highlight: 'oklch(0.93 0.195089 103.2532 / 0.5)'
  }
  // 暗色模式
  dark: {
    // 主要颜色
    primary: 'oklch(92% 0.005 298)'
    // 次要颜色
    secondary: 'oklch(77% 0.005 298)'
    // 背景色
    background: 'oklch(22% 0.005 298)'
    // 高亮颜色
    highlight: 'oklch(0.93 0.195089 103.2532 / 0.5)'
  }
}

全局设置

global: {
  // 默认语言
  // 站点根路径 '/' 的语言
  locale: 'zh' // de | en | es | fr | ja | ko | pl | pt | ru | zh | zh-tw
  // 更多语言
  // 生成 '/en/' '/es/' 等多语言路径
  // 不要重复填写默认语言，可以为空 []
  moreLocales: ['en', 'es', 'ja', 'ru', 'zh-tw'] // ['de', 'en', 'es', 'fr', 'ja', 'ko', 'pl', 'pt', 'ru', 'zh', 'zh-tw']
  // 字体样式
  fontStyle: 'sans' // sans | serif
  // 文章日期格式
  // YYYY-MM-DD | MM-DD-YYYY | DD-MM-YYYY | MMM D YYYY | D MMM YYYY
  // 2025-04-13, 04-13-2025, 13-04-2025, Apr 13 2025，13 Apr 2025
  dateFormat: 'YYYY-MM-DD'
  // 开启文章目录
  toc: true // true | false
  // 开启 KaTeX 数学渲染
  katex: true // true | false
  // 减少动画效果
  reduceMotion: false // true | false
}

评论系统

comment: {
  // 开启评论系统
  enabled: true // true | false
  // giscus 评论系统
  giscus: {
    repo: ''
    repoId: ''
    category: ''
    categoryId: ''
    mapping: 'pathname'
    strict: '0'
    reactionsEnabled: '1'
    emitMetadata: '0'
    inputPosition: 'bottom'
  }
  // twikoo 评论系统
  twikoo: {
    envId: ''
    // version: 前端版本可在 package.json 中修改
  }
  // waline 评论系统
  waline: {
    // 服务器地址
    serverURL: 'https://retypeset-comment.radishzz.cc'
    // emoji 表情地址
    emoji: [
      'https://unpkg.com/@waline/emojis@1.2.0/tw-emoji'
      // 'https://unpkg.com/@waline/emojis@1.2.0/bmoji'
      // 更多表情：https://waline.js.org/en/guide/features/emoji.html
    ]
    // gif 搜索
    search: false // true | false
    // 图片上传
    imageUploader: false // true | false
  }
}

搜索引擎优化

seo: {
  // @twitter ID
  twitterID: '@radishzz_'
  // 站点验证
  verification: {
    // google 搜索控制台
    google: 'AUCrz5F1e5qbnmKKDXl2Sf8u6y0kOpEO1wLs6HMMmlM'
    // bing 网站管理员工具
    bing: '64708CD514011A7965C84DDE1D169F87'
    // yandex 网站管理员
    yandex: ''
    // baidu 站长工具
    baidu: ''
  }
  // google 网站分析
  googleAnalyticsID: ''
  // umami 网站分析
  umamiAnalyticsID: 'dab0e4b9-9cbf-43c3-af60-b09d3b545c38'
  // folo 验证
  folo: {
    // 订阅 ID
    feedID: ''
    // 用户 ID
    userID: ''
  }
  // apiflash 访问密钥
  // 生成网站截图用于 open graph
  // 获取访问密钥：https://apiflash.com/
  apiflashKey: ''
}

自定义页脚

footer: {
  // 社交链接
  links: [
    {
      name: 'RSS',
      url: '/atom.xml', // 或 /rss.xml
    },
    {
      name: 'GitHub',
      url: 'https://github.com/radishzzz/astro-theme-retypeset',
    },
    {
      name: 'Email',
      url: 'email@radishzz.cc',
    }
    // {
    //   name: 'X',
    //   url: 'https://x.com/radishzz_',
    // },
  ]
  // 建站年份
  startYear: 2025
}

资源预加载

preload: {
  // 图床地址
  // 优化远程图片并生成低质量占位符
  imageHostURL: 'image.radishzz.cc'
  // 定制 google analytics 跟踪脚本
  // 适用于代理跟踪脚本到自定义域名的用户
  customGoogleAnalyticsJS: ''
  // 定制 umami 跟踪脚本
  // 适用于自部署 umami 或代理跟踪脚本到自定义域名的用户
  customUmamiAnalyticsJS: 'https://views.radishzz.cc/script.js'
}

更多配置

除了配置文件 src/config.ts 外，还有部分配置项位于其它文件中。

语法高亮

代码块的语法高亮主题。

// astro.config.ts

shikiConfig: {
  // 可选主题：https://shiki.style/themes
  // 背景色固定跟随博客主题，而非语法高亮主题
  themes: {
    light: 'github-light' // 亮色主题
    dark: 'github-dark' // 暗色主题
  }
}

文章摘要

文章自动摘要的字符数量。

// src/utils/description.ts

const excerptLengths: Record<ExcerptScene, {
  cjk: number // 中文、日文、韩文
  other: number // 其他语言
}> = {
  list: { // 首页文章列表
    cjk: 120, // 自动摘要前 120 字
    other: 240, // 自动摘要前 240 字
  },
}

Open Graph

Open Graph 社交卡片 样式。

// src/pages/og/[...image].ts

getImageOptions: (_path, page) => ({
  logo: {
    path: './public/icons/og-logo.png', // 本地路径的 PNG 图片
    size: [250], // logo 宽度
  },
  font: {
    title: { // 标题
      families: ['Noto Sans SC'], // 字体
      weight: 'Bold', // 字重
      color: [34, 33, 36], // 颜色
      lineHeight: 1.5, // 行高
    },
  },
  fonts: [ // 字体路径（本地或远程）
    'https://cdn.jsdelivr.net/gh/notofonts/noto-cjk@main/Sans/SubsetOTF/SC/NotoSansSC-Bold.otf',
    'https://cdn.jsdelivr.net/gh/notofonts/noto-cjk@main/Sans/SubsetOTF/SC/NotoSansSC-Regular.otf',
  ],
  bgGradient: [[242, 241, 245]], // 背景色
  // 更多配置：https://github.com/delucis/astro-og-canvas/tree/latest/packages/astro-og-canvas
})

RSS 订阅

RSS 订阅页 配色。

<style type="text/css">
body{color:oklch(25% 0.005 298)} /* 字体颜色 */
.bg-white{background-color:oklch(0.96 0.005 298)!important} /* 背景颜色 */
.text-gray{color:oklch(0.25 0.005 298 / 75%)!important} /* 次要字体颜色 */
</style>

创建新文章

执行 pnpm new-post <filename> 创建新文章，可在 src/content/posts/ 目录中编辑。

pnpm new-post                      ->  src/content/posts/new-post.md
pnpm new-post first-post           ->  src/content/posts/first-post.md
pnpm new-post 2025/03/first-post   ->  src/content/posts/2025/03/first-post.md
pnpm new-post first-post.mdx       ->  src/content/posts/first-post.mdx

Front Matter

title 和 published 为必填项，其余配置均可删除。

---
# 必填
title: 主题上手指南
published: 2025-01-26

# 可选
description: 自动选取文章前 120 字作为摘要。
updated: 2025-03-26
tags:
  - 博客主题
  - 指南

# 进阶，可选
draft: true/false
0-99
toc: true/false
lang: de/en/es/fr/ja/ko/pl/pt/ru/zh/zh-tw
abbrlink: theme-guide
---

进阶配置

draft

是否标记文章为草稿。设为 true 时无法发布文章，仅供本地开发预览。默认为 false。

pin

是否置顶文章。数字越大，文章的置顶优先级越高。默认为 0，即不置顶。

toc

是否生成目录。显示 h2 至 h4 标题。默认由全局配置项 global.toc 决定，可在文章中单独设置以覆盖全局配置。

lang

指定文章语言。只能指定一种语言，不指定则默认显示在所有语言路径下。

# src/config.ts
# locale: 'en'
# moreLocales: ['es', 'ru']

# lang: ''
src/content/posts/apple.md   ->  example.com/posts/apple/
                             ->  example.com/es/posts/apple/
                             ->  example.com/ru/posts/apple/
# lang: en
src/content/posts/apple.md   ->  example.com/posts/apple/
# lang: es
src/content/posts/apple.md   ->  example.com/es/posts/apple/
# lang: ru
src/content/posts/apple.md   ->  example.com/ru/posts/apple/

abbrlink

自定义文章 URL。只能包含小写字母、数字和连字符 -。

# src/config.ts
# locale: 'en'
# moreLocales: ['es', 'ru']
# lang: 'es'

# abbrlink: ''
src/content/posts/apple.md           ->  example.com/es/posts/apple/
src/content/posts/guide/apple.md     ->  example.com/es/posts/guide/apple/
src/content/posts/2025/03/apple.md   ->  example.com/es/posts/2025/03/apple/

# abbrlink: 'banana'
src/content/posts/apple.md           ->  example.com/es/posts/banana/
src/content/posts/guide/apple.md     ->  example.com/es/posts/banana/
src/content/posts/2025/03/apple.md   ->  example.com/es/posts/banana/

混排优化

执行 pnpm format-posts，可优化 src/content/ 目录中 Markdown 文件的排版格式。在 CJK（中文、日文、韩文）与英文混写的场景下，补充正确的空格，纠正标点符号等。

pnpm format-posts
🔍 Scanning Markdown files...
📦 Found 56 Markdown files
✅ src/content/posts/guides/Theme Guide-ja.md
✅ src/content/posts/guides/Theme Guide-zh-tw.md
✅ src/content/posts/guides/Theme Guide-zh.md
✨ Formatted 3 files successfully