Chirpy教程-3. Chirpy基本配置

本节介绍一些Chirpy的基本语法，来源是官方的教程 及教程的源代码

发布第一个Post

Post设置

Front Matter设置。如前所述，关于博文中要呈现什么信息，都是在Front Matter中设置的。一个完整相对完整的配置应该如下

---
title: 量子力学基础
date: 2025-4-9 21:33:00 +0800
categories: [物理, 量子力学]
tags: [量子力学]     
description: 量子力学的背景和基础知识～
pin: true
math: true
mermaid: true
---

其中categories表示分类，最多分两类；tags可以有很多。math和mermaid图按需开启。

这部分更详细的内容请访问官网的write-a-new-post 教程，不过你看我这个其实也足够。

_config.yml的配置

按照要求配置即可，我把注释翻译成了中文 （Claude翻译的，错了别打我）。按照注释操作就行了，这里挑重点讲一下重要的配置：

1. lang：请设置成zh-CN，然后到源代码中下载中文配置_data/locales/zh-CN.yml ，按照相同的路径保存到本地。这样主页中的英文就变成中文啦！默认的en下不影响博文中的中文显示，但是导航栏之类的设置都是英文的。
2. 如果你觉得每篇博文都要手动开启math或mermaid很麻烦，你可以找到第173行左右的defaults设置，在对应type为posts的那个scope中进行操作：

defaults:
  - scope:
      path: "" # 这里的空字符串表示项目中的所有文件
      type: posts
    values:
      layout: post
      comments: true # 在帖子中启用评论。
      toc: true # 在帖子中显示TOC列。
      math: true # 默认所有文章都启用数学模式
      mermaid: true # 同上，均启用mermaid
      # 除非您有足够的信心更新此项目中所有其他帖子链接的代码，
      # 否则请勿修改以下参数。
      permalink: /posts/:title/

​ 这样设置后就不用每次都手动开启啦！

文件管理

1. 博文管理：可以_posts文件夹中建立子文件夹，分门别类的进行管理。Jekyll会遍历_posts文件夹中的所有符合命名规范的文件，所以不用担心jekyll找不到～。
2. 图片管理：官网的教程write-a-new-post 啰里八嗦烦死了，图片管理贼简单的——把图片都丢到assets/img/文件夹中就可以了（img文件夹需要你自己创建），在md文件中使用标准的相对路径调用即可。如果你担心上传图片太多会超出GitHub Pages的1G限制，你也可以参考这篇Typora+PicGo的教程 上传到云端～

Kramdown语法

如前所述，Chirpy选择了Kramdown作为解释器，相较于普通的markdown，kramdown有丰富的功能。本节参考官网的教程text-and-typography ，同时再次建议你对照源代码进行学习。

图片

标准的图片插入语法为![]()，Kramdown允许你在后面添加{}完成更丰富的操作。以下是一些例子

图片居中，宽度为50%

![](){: .w-50}

向左浮动，宽度为25%

![](){: .w-25 .left}

我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说我有好多话要说

添加标题和阴影

![](){: .w-50 .shadow .rouded-10}_我是标题我是标题我是标题_

}我是标题我是标题我是标题