@jet-w/astro-blog 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (110) hide show
  1. package/dist/{chunk-HVQKQN6B.js → chunk-6D3XRDNY.js} +1 -1
  2. package/dist/{chunk-ATRISB7B.js → chunk-A2E2VSAQ.js} +43 -3
  3. package/dist/{chunk-AZHCNNAC.js → chunk-TJTPX2WP.js} +1 -1
  4. package/dist/config/index.d.ts +1 -1
  5. package/dist/config/index.js +2 -2
  6. package/dist/{i18n-5H4W145i.d.ts → i18n-PgMCFBw0.d.ts} +20 -0
  7. package/dist/index.d.ts +21 -3
  8. package/dist/index.js +20 -3
  9. package/dist/integration.d.ts +1 -1
  10. package/dist/integration.js +2 -2
  11. package/package.json +1 -1
  12. package/src/components/blog/FloatingToc.vue +11 -3
  13. package/src/components/blog/Hero.astro +17 -2
  14. package/src/components/blog/NavigationTabs.vue +46 -15
  15. package/src/components/blog/PostCard.astro +28 -10
  16. package/src/components/blog/RelatedPosts.astro +23 -7
  17. package/src/components/blog/TableOfContents.astro +10 -4
  18. package/src/components/blog/TagCloud.astro +4 -3
  19. package/src/components/home/FeaturedPostsSection.astro +22 -6
  20. package/src/components/home/QuickNavSection.astro +33 -4
  21. package/src/components/home/RecentPostsSection.astro +22 -6
  22. package/src/components/home/StatsSection.astro +24 -6
  23. package/src/components/layout/Header.astro +9 -5
  24. package/src/components/layout/Sidebar.astro +14 -11
  25. package/src/components/ui/SearchBox.vue +13 -5
  26. package/src/components/ui/SearchInterface.vue +49 -25
  27. package/src/pages/archives/[year]/[month].astro +36 -17
  28. package/src/pages/archives/index.astro +36 -20
  29. package/src/pages/categories/[category].astro +33 -16
  30. package/src/pages/categories/index.astro +37 -14
  31. package/src/pages/posts/[...slug].astro +125 -18
  32. package/src/pages/posts/index.astro +59 -37
  33. package/src/pages/posts/page/[page].astro +65 -27
  34. package/src/pages/search.astro +50 -14
  35. package/src/pages/slides/index.astro +25 -6
  36. package/src/pages/tags/[tag].astro +32 -15
  37. package/src/pages/tags/index.astro +39 -16
  38. package/src/plugins/remark-containers.mjs +351 -322
  39. package/src/plugins/remark-protect-code.mjs +69 -0
  40. package/src/styles/global.css +35 -1
  41. package/templates/default/.claude/ralph-loop.local.md +48 -0
  42. package/templates/default/astro.config.mjs +13 -4
  43. package/templates/default/content/posts/blog_docs_en/{get-started → 01.get-started}/01-intro.md +1 -1
  44. package/templates/default/content/posts/blog_docs_en/{get-started → 01.get-started}/02-install.md +1 -1
  45. package/templates/default/content/posts/blog_docs_en/{get-started → 01.get-started}/03-create-post.md +1 -1
  46. package/templates/default/content/posts/blog_docs_en/{get-started → 01.get-started}/04-structure.md +1 -1
  47. package/templates/default/content/posts/blog_docs_en/01.get-started/05-deploy.md +208 -0
  48. package/templates/default/content/posts/blog_docs_en/{get-started → 01.get-started}/README.md +1 -1
  49. package/templates/default/content/posts/blog_docs_en/02.guide/02-containers.md +245 -0
  50. package/templates/default/content/posts/blog_docs_en/{guide/markdown → 02.guide}/03-code-blocks.md +2 -1
  51. package/templates/default/content/posts/blog_docs_en/{guide/features/01-mermaid.md → 02.guide/03-mermaid.md} +1 -1
  52. package/templates/default/content/posts/blog_docs_en/{guide/features → 02.guide}/04-icons.md +4 -2
  53. package/templates/default/content/posts/blog_docs_en/{guide/features/02-latex.md → 02.guide/06-latex.md} +1 -1
  54. package/templates/default/content/posts/blog_docs_en/{guide/features/03-video.md → 02.guide/07-video.md} +1 -1
  55. package/templates/default/content/posts/blog_docs_en/02.guide/08-slides.md +359 -0
  56. package/templates/default/content/posts/blog_docs_en/{guide/markdown → 02.guide}/README.md +22 -3
  57. package/templates/default/content/posts/blog_docs_en/{config → 03.config}/01-site.md +1 -1
  58. package/templates/default/content/posts/blog_docs_en/{config → 03.config}/02-sidebar.md +1 -1
  59. package/templates/default/content/posts/blog_docs_en/{config → 03.config}/03-i18n.md +88 -24
  60. package/templates/default/content/posts/blog_docs_en/{config → 03.config}/README.md +1 -1
  61. package/templates/default/content/posts/blog_docs_en/README.md +2 -1
  62. package/templates/default/content/posts/blog_docs_zh/01.get-started/01-intro.md +81 -0
  63. package/templates/default/content/posts/blog_docs_zh/01.get-started/02-install.md +137 -0
  64. package/templates/default/content/posts/blog_docs_zh/01.get-started/03-create-post.md +176 -0
  65. package/templates/default/content/posts/blog_docs_zh/01.get-started/04-structure.md +173 -0
  66. package/templates/default/content/posts/blog_docs_zh/01.get-started/05-deploy.md +208 -0
  67. package/templates/default/content/posts/blog_docs_zh/01.get-started/README.md +52 -0
  68. package/templates/default/content/posts/blog_docs_zh/02.guide/02-containers.md +245 -0
  69. package/templates/default/content/posts/blog_docs_zh/02.guide/03-code-blocks.md +206 -0
  70. package/templates/default/content/posts/blog_docs_zh/02.guide/03-mermaid.md +194 -0
  71. package/templates/default/content/posts/blog_docs_zh/02.guide/04-icons.md +229 -0
  72. package/templates/default/content/posts/blog_docs_zh/02.guide/06-latex.md +233 -0
  73. package/templates/default/content/posts/blog_docs_zh/02.guide/07-video.md +184 -0
  74. package/templates/default/content/posts/blog_docs_zh/02.guide/08-slides.md +359 -0
  75. package/templates/default/content/posts/blog_docs_zh/02.guide/README.md +213 -0
  76. package/templates/default/content/posts/blog_docs_zh/03.config/01-site.md +208 -0
  77. package/templates/default/content/posts/blog_docs_zh/03.config/02-sidebar.md +240 -0
  78. package/templates/default/content/posts/blog_docs_zh/03.config/03-i18n.md +348 -0
  79. package/templates/default/content/posts/blog_docs_zh/03.config/README.md +85 -0
  80. package/templates/default/content/posts/blog_docs_zh/README.md +78 -0
  81. package/templates/default/src/config/locales/en/index.ts +5 -1
  82. package/templates/default/src/config/locales/en/menu.ts +3 -1
  83. package/templates/default/src/config/locales/en/sidebar.ts +18 -2
  84. package/templates/default/src/config/locales/en/site.ts +1 -1
  85. package/templates/default/src/config/locales/en/ui.ts +29 -0
  86. package/templates/default/src/config/locales/zh-CN/index.ts +5 -1
  87. package/templates/default/src/config/locales/zh-CN/menu.ts +7 -5
  88. package/templates/default/src/config/locales/zh-CN/sidebar.ts +22 -6
  89. package/templates/default/src/config/locales/zh-CN/site.ts +2 -2
  90. package/templates/default/src/config/locales/zh-CN/ui.ts +29 -0
  91. package/templates/default/src/config/site.ts +2 -2
  92. package/templates/default/src/content.config.ts +15 -3
  93. package/templates/default/content/posts/blog_docs/01-quick-start.md +0 -162
  94. package/templates/default/content/posts/blog_docs/02-frontmatter.md +0 -277
  95. package/templates/default/content/posts/blog_docs/03-markdown-basic.md +0 -350
  96. package/templates/default/content/posts/blog_docs/04-containers.md +0 -331
  97. package/templates/default/content/posts/blog_docs/05-code-blocks.md +0 -388
  98. package/templates/default/content/posts/blog_docs/06-mermaid.md +0 -431
  99. package/templates/default/content/posts/blog_docs/07-video.md +0 -243
  100. package/templates/default/content/posts/blog_docs/08-latex.md +0 -382
  101. package/templates/default/content/posts/blog_docs/09-icons.md +0 -326
  102. package/templates/default/content/posts/blog_docs/10-sidebar.md +0 -445
  103. package/templates/default/content/posts/blog_docs/11-config.md +0 -334
  104. package/templates/default/content/posts/blog_docs/12-i18n.md +0 -355
  105. package/templates/default/content/posts/blog_docs/12-slides.mdx +0 -552
  106. package/templates/default/content/posts/blog_docs/README.md +0 -152
  107. package/templates/default/content/posts/blog_docs_en/get-started/05-deploy.md +0 -197
  108. package/templates/default/content/posts/blog_docs_en/guide/README.md +0 -59
  109. package/templates/default/content/posts/blog_docs_en/guide/features/README.md +0 -51
  110. package/templates/default/content/posts/blog_docs_en/guide/markdown/02-containers.md +0 -226
@@ -1,382 +0,0 @@
1
- ---
2
- title: LaTeX 数学公式
3
- description: 使用 LaTeX 语法排版数学公式
4
- pubDate: 2025-12-11
5
- author: Astro Blog
6
- categories:
7
- - 博客教程
8
- tags:
9
- - LaTeX
10
- - 数学公式
11
- - KaTeX
12
- ---
13
-
14
- # LaTeX 数学公式
15
-
16
- 本博客使用 KaTeX 渲染 LaTeX 数学公式,支持行内公式和块级公式。
17
-
18
- ## 基本语法
19
-
20
- ### 行内公式
21
-
22
- 使用单个美元符号 `$...$` 包裹:
23
-
24
- ```markdown
25
- 爱因斯坦的质能方程 $E = mc^2$ 揭示了质量和能量的关系。
26
- ```
27
-
28
- 效果:爱因斯坦的质能方程 $E = mc^2$ 揭示了质量和能量的关系。
29
-
30
- ### 块级公式
31
-
32
- 使用双美元符号 `$$...$$` 包裹:
33
-
34
- ```markdown
35
- $$
36
- E = mc^2
37
- $$
38
- ```
39
-
40
- 效果:
41
-
42
- $$
43
- E = mc^2
44
- $$
45
-
46
- ## 基础数学符号
47
-
48
- ### 上标和下标
49
-
50
- | 语法 | 效果 | 说明 |
51
- |:---|:---|:---|
52
- | `x^2` | $x^2$ | 上标 |
53
- | `x_i` | $x_i$ | 下标 |
54
- | `x^{10}` | $x^{10}$ | 多字符上标 |
55
- | `x_{ij}` | $x_{ij}$ | 多字符下标 |
56
- | `x_i^2` | $x_i^2$ | 同时使用 |
57
-
58
- ### 分数
59
-
60
- ```markdown
61
- $\frac{a}{b}$
62
- $\frac{x+1}{x-1}$
63
- $\dfrac{a}{b}$ <!-- 更大的分数 -->
64
- ```
65
-
66
- 效果:$\frac{a}{b}$ 、 $\frac{x+1}{x-1}$ 、 $\dfrac{a}{b}$
67
-
68
- ### 根号
69
-
70
- ```markdown
71
- $\sqrt{x}$
72
- $\sqrt[3]{x}$
73
- $\sqrt{x^2 + y^2}$
74
- ```
75
-
76
- 效果:$\sqrt{x}$ 、 $\sqrt[3]{x}$ 、 $\sqrt{x^2 + y^2}$
77
-
78
- ### 求和与积分
79
-
80
- ```markdown
81
- $\sum_{i=1}^{n} x_i$
82
- $\prod_{i=1}^{n} x_i$
83
- $\int_{a}^{b} f(x) dx$
84
- ```
85
-
86
- 效果:
87
-
88
- - 求和:$\sum_{i=1}^{n} x_i$
89
- - 连乘:$\prod_{i=1}^{n} x_i$
90
- - 积分:$\int_{a}^{b} f(x) dx$
91
-
92
- 块级显示(更大的符号):
93
-
94
- $$
95
- \sum_{i=1}^{n} x_i \quad \prod_{i=1}^{n} x_i \quad \int_{a}^{b} f(x) \, dx
96
- $$
97
-
98
- ## 希腊字母
99
-
100
- | 小写 | 代码 | 大写 | 代码 |
101
- |:---|:---|:---|:---|
102
- | $\alpha$ | `\alpha` | $A$ | `A` |
103
- | $\beta$ | `\beta` | $B$ | `B` |
104
- | $\gamma$ | `\gamma` | $\Gamma$ | `\Gamma` |
105
- | $\delta$ | `\delta` | $\Delta$ | `\Delta` |
106
- | $\epsilon$ | `\epsilon` | $E$ | `E` |
107
- | $\theta$ | `\theta` | $\Theta$ | `\Theta` |
108
- | $\lambda$ | `\lambda` | $\Lambda$ | `\Lambda` |
109
- | $\mu$ | `\mu` | $M$ | `M` |
110
- | $\pi$ | `\pi` | $\Pi$ | `\Pi` |
111
- | $\sigma$ | `\sigma` | $\Sigma$ | `\Sigma` |
112
- | $\phi$ | `\phi` | $\Phi$ | `\Phi` |
113
- | $\omega$ | `\omega` | $\Omega$ | `\Omega` |
114
-
115
- ## 运算符
116
-
117
- ### 基本运算符
118
-
119
- | 符号 | 代码 | 符号 | 代码 |
120
- |:---|:---|:---|:---|
121
- | $+$ | `+` | $-$ | `-` |
122
- | $\times$ | `\times` | $\div$ | `\div` |
123
- | $\pm$ | `\pm` | $\mp$ | `\mp` |
124
- | $\cdot$ | `\cdot` | $\ast$ | `\ast` |
125
-
126
- ### 关系运算符
127
-
128
- | 符号 | 代码 | 符号 | 代码 |
129
- |:---|:---|:---|:---|
130
- | $=$ | `=` | $\neq$ | `\neq` |
131
- | $<$ | `<` | $>$ | `>` |
132
- | $\leq$ | `\leq` | $\geq$ | `\geq` |
133
- | $\approx$ | `\approx` | $\equiv$ | `\equiv` |
134
- | $\sim$ | `\sim` | $\propto$ | `\propto` |
135
-
136
- ### 集合运算符
137
-
138
- | 符号 | 代码 | 符号 | 代码 |
139
- |:---|:---|:---|:---|
140
- | $\in$ | `\in` | $\notin$ | `\notin` |
141
- | $\subset$ | `\subset` | $\supset$ | `\supset` |
142
- | $\subseteq$ | `\subseteq` | $\supseteq$ | `\supseteq` |
143
- | $\cup$ | `\cup` | $\cap$ | `\cap` |
144
- | $\emptyset$ | `\emptyset` | $\infty$ | `\infty` |
145
-
146
- ### 逻辑运算符
147
-
148
- | 符号 | 代码 | 符号 | 代码 |
149
- |:---|:---|:---|:---|
150
- | $\land$ | `\land` | $\lor$ | `\lor` |
151
- | $\neg$ | `\neg` | $\forall$ | `\forall` |
152
- | $\exists$ | `\exists` | $\Rightarrow$ | `\Rightarrow` |
153
-
154
- ## 括号
155
-
156
- ### 普通括号
157
-
158
- ```markdown
159
- $(a+b)$
160
- $[a+b]$
161
- $\{a+b\}$
162
- ```
163
-
164
- 效果:$(a+b)$ 、 $[a+b]$ 、 $\{a+b\}$
165
-
166
- ### 自适应括号
167
-
168
- 使用 `\left` 和 `\right` 让括号自动调整大小:
169
-
170
- ```markdown
171
- $\left( \frac{a}{b} \right)$
172
- $\left[ \sum_{i=1}^{n} x_i \right]$
173
- ```
174
-
175
- 效果:
176
-
177
- $$
178
- \left( \frac{a}{b} \right) \quad \left[ \sum_{i=1}^{n} x_i \right]
179
- $$
180
-
181
- ## 矩阵
182
-
183
- ### 基本矩阵
184
-
185
- ```markdown
186
- $$
187
- \begin{matrix}
188
- a & b \\
189
- c & d
190
- \end{matrix}
191
- $$
192
- ```
193
-
194
- $$
195
- \begin{matrix}
196
- a & b \\
197
- c & d
198
- \end{matrix}
199
- $$
200
-
201
- ### 带括号的矩阵
202
-
203
- ```markdown
204
- $$
205
- \begin{pmatrix}
206
- a & b \\
207
- c & d
208
- \end{pmatrix}
209
- $$
210
-
211
- $$
212
- \begin{bmatrix}
213
- a & b \\
214
- c & d
215
- \end{bmatrix}
216
- $$
217
- ```
218
-
219
- $$
220
- \begin{pmatrix}
221
- a & b \\
222
- c & d
223
- \end{pmatrix}
224
- \quad
225
- \begin{bmatrix}
226
- a & b \\
227
- c & d
228
- \end{bmatrix}
229
- $$
230
-
231
- ### 行列式
232
-
233
- ```markdown
234
- $$
235
- \begin{vmatrix}
236
- a & b \\
237
- c & d
238
- \end{vmatrix}
239
- = ad - bc
240
- $$
241
- ```
242
-
243
- $$
244
- \begin{vmatrix}
245
- a & b \\
246
- c & d
247
- \end{vmatrix}
248
- = ad - bc
249
- $$
250
-
251
- ## 多行公式
252
-
253
- ### 对齐的多行公式
254
-
255
- ```markdown
256
- $$
257
- \begin{aligned}
258
- f(x) &= (x+1)^2 \\
259
- &= x^2 + 2x + 1
260
- \end{aligned}
261
- $$
262
- ```
263
-
264
- $$
265
- \begin{aligned}
266
- f(x) &= (x+1)^2 \\
267
- &= x^2 + 2x + 1
268
- \end{aligned}
269
- $$
270
-
271
- ### 分段函数
272
-
273
- ```markdown
274
- $$
275
- f(x) = \begin{cases}
276
- x^2 & \text{if } x \geq 0 \\
277
- -x^2 & \text{if } x < 0
278
- \end{cases}
279
- $$
280
- ```
281
-
282
- $$
283
- f(x) = \begin{cases}
284
- x^2 & \text{if } x \geq 0 \\
285
- -x^2 & \text{if } x < 0
286
- \end{cases}
287
- $$
288
-
289
- ## 特殊函数
290
-
291
- ### 三角函数
292
-
293
- $\sin x$、$\cos x$、$\tan x$、$\cot x$、$\sec x$、$\csc x$
294
-
295
- ### 对数函数
296
-
297
- $\log x$、$\ln x$、$\log_2 x$、$\lg x$
298
-
299
- ### 极限
300
-
301
- ```markdown
302
- $$
303
- \lim_{x \to \infty} \frac{1}{x} = 0
304
- $$
305
- ```
306
-
307
- $$
308
- \lim_{x \to \infty} \frac{1}{x} = 0
309
- $$
310
-
311
- ### 导数
312
-
313
- $f'(x)$、$f''(x)$、$\frac{df}{dx}$、$\frac{\partial f}{\partial x}$
314
-
315
- ## 常用公式示例
316
-
317
- ### 二次方程求根公式
318
-
319
- $$
320
- x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
321
- $$
322
-
323
- ### 欧拉公式
324
-
325
- $$
326
- e^{i\pi} + 1 = 0
327
- $$
328
-
329
- ### 高斯积分
330
-
331
- $$
332
- \int_{-\infty}^{\infty} e^{-x^2} dx = \sqrt{\pi}
333
- $$
334
-
335
- ### 麦克劳林级数
336
-
337
- $$
338
- e^x = \sum_{n=0}^{\infty} \frac{x^n}{n!} = 1 + x + \frac{x^2}{2!} + \frac{x^3}{3!} + \cdots
339
- $$
340
-
341
- ### 贝叶斯公式
342
-
343
- $$
344
- P(A|B) = \frac{P(B|A) \cdot P(A)}{P(B)}
345
- $$
346
-
347
- ### 麦克斯韦方程组
348
-
349
- $$
350
- \begin{aligned}
351
- \nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\
352
- \nabla \cdot \mathbf{B} &= 0 \\
353
- \nabla \times \mathbf{E} &= -\frac{\partial \mathbf{B}}{\partial t} \\
354
- \nabla \times \mathbf{B} &= \mu_0 \mathbf{J} + \mu_0 \varepsilon_0 \frac{\partial \mathbf{E}}{\partial t}
355
- \end{aligned}
356
- $$
357
-
358
- ## 间距调整
359
-
360
- | 代码 | 效果 | 说明 |
361
- |:---|:---|:---|
362
- | `a \quad b` | $a \quad b$ | 大空格 |
363
- | `a \qquad b` | $a \qquad b$ | 更大空格 |
364
- | `a \, b` | $a \, b$ | 小空格 |
365
- | `a \! b` | $a \! b$ | 负空格 |
366
-
367
- ## 注意事项
368
-
369
- ::: tip 语法转义
370
- 在 Markdown 中,某些字符需要转义:
371
- - 下划线 `_` 有时需要写成 `\_`
372
- - 美元符号 `$` 用 `\$` 转义
373
- :::
374
-
375
- ::: warning 兼容性
376
- 部分高级 LaTeX 语法可能不被 KaTeX 支持。如遇到渲染问题,可查阅 [KaTeX 支持的函数列表](https://katex.org/docs/supported.html)。
377
- :::
378
-
379
- ## 下一步
380
-
381
- - [图标系统](./09-icons) - 使用各种图标
382
- - [侧边栏配置](./10-sidebar) - 自定义导航结构
@@ -1,326 +0,0 @@
1
- ---
2
- title: 图标系统
3
- description: 多图标库使用指南,美化你的文章和导航
4
- pubDate: 2025-12-11
5
- author: Astro Blog
6
- categories:
7
- - 博客教程
8
- tags:
9
- - 图标
10
- - UI
11
- ---
12
-
13
- # 图标系统
14
-
15
- 本博客内置支持多种图标库,可以在 Frontmatter 的 `icon` 字段中使用,用于侧边栏导航和文章列表的视觉增强。
16
-
17
- ## 支持的图标库
18
-
19
- | 图标库 | 前缀 | 特点 |
20
- |:---|:---|:---|
21
- | Emoji | 直接使用 | 简单直观,无需配置 |
22
- | Remix Icon | `ri:` | 现代简洁,推荐使用 |
23
- | Font Awesome | `fa:` | 最流行的图标库 |
24
- | Bootstrap Icons | `bi:` | Bootstrap 风格 |
25
- | Material Icons | `mi:` | Google Material 设计 |
26
- | Ionicons | `ion:` | Ionic 框架图标 |
27
-
28
- ## Emoji 图标
29
-
30
- 最简单的方式,直接使用 Emoji:
31
-
32
- ```yaml
33
- ---
34
- icon: "📚"
35
- ---
36
-
37
- # 或者
38
- icon: "🚀"
39
- icon: "💡"
40
- icon: "⚙️"
41
- icon: "🎨"
42
- ```
43
-
44
- ### 常用 Emoji 推荐
45
-
46
- | 分类 | Emoji |
47
- |:---|:---|
48
- | 文档 | 📄 📝 📋 📑 📃 |
49
- | 文件夹 | 📁 📂 🗂️ |
50
- | 技术 | 💻 🖥️ ⚙️ 🔧 🛠️ |
51
- | 编程 | 👨‍💻 👩‍💻 🐛 🔨 |
52
- | 学习 | 📚 📖 🎓 ✏️ |
53
- | 提示 | 💡 ⚡ ✨ 🔥 |
54
- | 警告 | ⚠️ 🚨 ❗ ❌ |
55
- | 成功 | ✅ ✔️ 👍 🎉 |
56
- | 网络 | 🌐 🔗 📡 |
57
- | 安全 | 🔒 🔐 🛡️ |
58
-
59
- ## Remix Icon
60
-
61
- 现代简洁的图标库,推荐作为主要图标来源。
62
-
63
- ### 语法格式
64
-
65
- ```yaml
66
- icon: ri:图标名-样式
67
- ```
68
-
69
- 样式分为:
70
- - `-line` 线性图标
71
- - `-fill` 填充图标
72
-
73
- ### 常用图标
74
-
75
- ```yaml
76
- # 文件相关
77
- icon: ri:file-line # 文件
78
- icon: ri:folder-line # 文件夹
79
- icon: ri:folder-3-line # 文件夹(另一种样式)
80
- icon: ri:article-line # 文章
81
-
82
- # 编程相关
83
- icon: ri:code-line # 代码
84
- icon: ri:code-s-slash-line # 代码斜杠
85
- icon: ri:terminal-line # 终端
86
- icon: ri:git-branch-line # Git 分支
87
-
88
- # 技术栈
89
- icon: ri:javascript-line # JavaScript
90
- icon: ri:vuejs-line # Vue
91
- icon: ri:reactjs-line # React
92
- icon: ri:html5-line # HTML5
93
- icon: ri:css3-line # CSS3
94
-
95
- # 工具
96
- icon: ri:settings-3-line # 设置
97
- icon: ri:tools-line # 工具
98
- icon: ri:bug-line # Bug
99
- icon: ri:test-tube-line # 测试
100
-
101
- # 数据
102
- icon: ri:database-2-line # 数据库
103
- icon: ri:server-line # 服务器
104
- icon: ri:cloud-line # 云
105
-
106
- # UI/设计
107
- icon: ri:palette-line # 调色板
108
- icon: ri:layout-line # 布局
109
- icon: ri:paint-brush-line # 画笔
110
-
111
- # 其他
112
- icon: ri:book-line # 书籍
113
- icon: ri:lightbulb-line # 灯泡
114
- icon: ri:star-line # 星星
115
- icon: ri:rocket-line # 火箭
116
- icon: ri:trophy-line # 奖杯
117
- ```
118
-
119
- ### 查找更多图标
120
-
121
- 访问 [Remix Icon 官网](https://remixicon.com/) 查找图标名称。
122
-
123
- ## Font Awesome
124
-
125
- 最流行的图标库,图标数量丰富。
126
-
127
- ### 语法格式
128
-
129
- ```yaml
130
- # Solid 样式(默认)
131
- icon: fa:图标名
132
-
133
- # Regular 样式
134
- icon: fa-regular:图标名
135
-
136
- # Brands 样式(品牌图标)
137
- icon: fa-brands:图标名
138
- ```
139
-
140
- ### 常用图标
141
-
142
- ```yaml
143
- # 基础图标
144
- icon: fa:home # 主页
145
- icon: fa:user # 用户
146
- icon: fa:cog # 设置
147
- icon: fa:search # 搜索
148
-
149
- # 文件图标
150
- icon: fa:file # 文件
151
- icon: fa:folder # 文件夹
152
- icon: fa:file-code # 代码文件
153
- icon: fa:file-alt # 文档
154
-
155
- # 品牌图标
156
- icon: fa-brands:github # GitHub
157
- icon: fa-brands:docker # Docker
158
- icon: fa-brands:python # Python
159
- icon: fa-brands:node-js # Node.js
160
- icon: fa-brands:aws # AWS
161
- ```
162
-
163
- ### 查找更多图标
164
-
165
- 访问 [Font Awesome 官网](https://fontawesome.com/icons) 查找图标。
166
-
167
- ## Bootstrap Icons
168
-
169
- Bootstrap 风格的图标库。
170
-
171
- ### 语法格式
172
-
173
- ```yaml
174
- icon: bi:图标名
175
- ```
176
-
177
- ### 常用图标
178
-
179
- ```yaml
180
- icon: bi:house # 主页
181
- icon: bi:file-earmark # 文件
182
- icon: bi:folder # 文件夹
183
- icon: bi:code-slash # 代码
184
- icon: bi:terminal # 终端
185
- icon: bi:gear # 设置
186
- icon: bi:book # 书籍
187
- icon: bi:lightning # 闪电
188
- icon: bi:star # 星星
189
- ```
190
-
191
- ### 查找更多图标
192
-
193
- 访问 [Bootstrap Icons 官网](https://icons.getbootstrap.com/) 查找图标。
194
-
195
- ## Material Icons
196
-
197
- Google Material Design 风格图标。
198
-
199
- ### 语法格式
200
-
201
- ```yaml
202
- # 默认样式
203
- icon: mi:图标名
204
-
205
- # Outlined 样式
206
- icon: mi-outlined:图标名
207
-
208
- # Round 样式
209
- icon: mi-round:图标名
210
- ```
211
-
212
- ### 常用图标
213
-
214
- ```yaml
215
- icon: mi:home # 主页
216
- icon: mi:folder # 文件夹
217
- icon: mi:code # 代码
218
- icon: mi:settings # 设置
219
- icon: mi:article # 文章
220
- icon: mi-outlined:lightbulb # 灯泡(线性)
221
- icon: mi-round:star # 星星(圆角)
222
- ```
223
-
224
- ### 查找更多图标
225
-
226
- 访问 [Material Icons 官网](https://fonts.google.com/icons) 查找图标。
227
-
228
- ## Ionicons
229
-
230
- Ionic 框架的图标库。
231
-
232
- ### 语法格式
233
-
234
- ```yaml
235
- # 默认(filled)
236
- icon: ion:图标名
237
-
238
- # Outline 样式
239
- icon: ion:图标名-outline
240
-
241
- # Sharp 样式
242
- icon: ion:图标名-sharp
243
- ```
244
-
245
- ### 常用图标
246
-
247
- ```yaml
248
- icon: ion:home # 主页
249
- icon: ion:folder # 文件夹
250
- icon: ion:code # 代码
251
- icon: ion:settings # 设置
252
- icon: ion:book # 书籍
253
- icon: ion:rocket-outline # 火箭(线性)
254
- ```
255
-
256
- ## 使用场景
257
-
258
- ### 文章 Frontmatter
259
-
260
- 在文章的元数据中设置图标:
261
-
262
- ```yaml
263
- ---
264
- title: "Vue 3 入门教程"
265
- icon: ri:vuejs-line
266
- ---
267
- ```
268
-
269
- ### 系列文档的 README
270
-
271
- 为整个系列设置统一图标:
272
-
273
- ```yaml
274
- ---
275
- title: "Docker 完全指南"
276
- icon: fa-brands:docker
277
- ---
278
- ```
279
-
280
- ### 按内容类型选择图标
281
-
282
- | 内容类型 | 推荐图标 |
283
- |:---|:---|
284
- | 入门教程 | `ri:rocket-line` 🚀 |
285
- | API 文档 | `ri:code-s-slash-line` |
286
- | 配置指南 | `ri:settings-3-line` ⚙️ |
287
- | 最佳实践 | `ri:trophy-line` 🏆 |
288
- | 问题排查 | `ri:bug-line` 🐛 |
289
- | 版本更新 | `ri:refresh-line` |
290
-
291
- ### 按技术栈选择图标
292
-
293
- | 技术 | 推荐图标 |
294
- |:---|:---|
295
- | JavaScript | `ri:javascript-line` |
296
- | TypeScript | `ri:typescript-line` |
297
- | Vue | `ri:vuejs-line` |
298
- | React | `ri:reactjs-line` |
299
- | Node.js | `fa-brands:node-js` |
300
- | Python | `fa-brands:python` |
301
- | Docker | `fa-brands:docker` |
302
- | Git | `ri:git-branch-line` |
303
- | Database | `ri:database-2-line` |
304
-
305
- ## 图标大小
306
-
307
- 图标大小在组件中自动调整,一般不需要手动设置。默认大小为 `1em`,与文字大小一致。
308
-
309
- ## 注意事项
310
-
311
- ::: tip 图标命名
312
- - 不同图标库的命名规则不同
313
- - 建议在官网搜索确认准确名称
314
- - 名称区分大小写
315
- :::
316
-
317
- ::: warning 加载性能
318
- - 图标库通过 CDN 加载
319
- - 首次访问可能有轻微延迟
320
- - 建议同一项目使用统一的图标库
321
- :::
322
-
323
- ## 下一步
324
-
325
- - [侧边栏配置](./10-sidebar) - 配置导航菜单,结合图标使用
326
- - [站点配置](./11-config) - 自定义博客外观