博客使用

在初始化完环境之后,我们便可以开始我们的博客写作啦!

📑 创建博客文章

在vitepress的站点目录文件夹下建立一个名为posts的文件夹

在posts文件夹下创建的所有markdown文件将被视为博客文章

例如你的文件目录结构可能如下:

.
├─ docs
│  ├─ .vitepress
│  │  └─ config.js
│  ├─ posts
│  │    ├─ my-blog-0.md
│  │    └─ my-blog-1.md
│  ├─ markdown-examples.md
│  └─ index.md
└─ package.json

其中my-blog-0.md和my-blog-1.md便会被主题自动渲染为博客文章

📖 配置博客文章

一些和博客文章相关的配置

• title 文章的标题,会自动渲染在文章中
• date 文章的创建时间,默认为1900-01-01
• tags 文章的标签,支持多组标签
• pin 布尔值,是否置顶文章,默认为false
• desc 简介,当摘要为空的时候会显示desc的内容

摘要即为正文部分第一个---分割线前的所有内容

下面是一个包含完整博客配置的文章示例:

---
title: 我的第一篇博客
date: 2024-03-23
tags:
    - hello world
    - 标签1

pin: true
desc: xxxx
---

我是文章的摘要

---

我是一段废话

## 标题A

AAAAAAAAAAAAAAAAAAAAAA

## 标题B

BBBBBBBBBBBBBBB

🏠 搭建博客主页

博客主页会自动的展示所有的博客文章,并且会自动的根据文章的创建时间进行排序

同时还会显示头像昵称签名等其他内容,在版本1.1.0及以后还可以自己添加相关的主页小组件

例如: 博客主页示例

对于任意一个vitepress的markdown页面,使用layout配置便可转为博客主页:

---
layout: blog
---

也就是说,你可以自由的选择任意的一个甚至多个页面作为博客主页,不过更推荐将index.md作为博客主页,以符合博客站点的习惯

如果你还不清楚文件路径和网页路由的对应关系,可以参考vitepress的相关文档

现在你应该能在对应的博客主页中看到创建的文章了

🔖 创建标签页与归档页

与博客主页同理

标签页

---
layout: tags
---

归档页

---
layout: archive
---