Hello world!¶

博客功能上线。本文将介绍博客的基本使用方法。(这是摘要部分)

这是正文。与摘要部分用分隔。

为什么添加博客¶

可以方便记录难以归类的内容，比如一些技术总结、心得体会、比赛经验、备忘事项、近期计划等。

博客的编写相较于文档更加简单，无需考虑目录结构，只需在docs/blog/posts目录下添加一个.md文件即可。文件名可以是中文或英文，但不要包含空格和特殊字符。

接下来详细说明步骤：

1. 创建新文章文件

2. 在文章开头填写基本信息（元数据）

下面这个例子是一个相对完整的元数据，其中date是文章的创建日期，authors是作者（需要事先在docs/blog/.authors.yml填写基本信息），categories是文章的分类，可以有多个，用于自动归档。

---
date: 2023-10-04
authors:
  - lcf
categories:
  - 新功能
  - 博客
---

3. 编写标题、摘要、正文

摘要和正文之间用分隔。

4. 保存、预览并提交

具体流程和编写常规文档一致，只不过不需要额外编辑mkdocs.yml的nav部分。

修改docs/blog/.authors.yml文件，按照下面的格式添加即可。

your_alias:
  name: 姓名
  description: 简要的个人介绍
  avatar: 头像图片的网址或文件路径，建议直接就用github头像，用F12查看元素即可

写文章时只需要在最开头的元数据中的authors填写your_alias即可。（注：your_alias可以是任意别名，比如lcf）