Lost Pieces

My blog powered by Vitepress, for notes and life records ...

拿Vitepress搭的个人博客，很久以前拿airene的主题和默认主题混了混魔改的。C++写多了，有点类型强迫症，所以基本上能标都标了，尽量追求.vue和.ts文件里每个变量都能正确给出基于类型的语法提示。

目前支持的所有feature可参考👉测试显示效果。作为个人博客的话反正也不需要太多花里胡哨的功能，这样就挺好。

前端搞不懂啦，凑合用就行QwQ

目录结构

和airene的差不多，就是把posts之类的都移到了pages下，方便统一管理。另外，基于文件的页面路由以pages为根目录，比如pages/xx/yyy.md会被路由到<site>/xx/yyy。

├── .vitepress
│   ├── config.ts     // 主题配置文件
│   ├── ...
│
│
└── pages
    ├── index.md      // 主页
    ├── about.md
    ├── archives.md
    ├── tags.md
    ├── posts         // 存放博客文章
    └── public        // [可选]
       ├── L_32x32.ico
       └── favicon.ico

文章格式参考

文章推荐放在pages/posts下，其他路径下的markdown文件默认不会显示在主页中，如果有索引其他路径下文章的需求可以修改.vitepress/theme/data/posts.data.ts中的glob。

文章开头需要写frontmatter，格式如下：

---
title: 文章标题
date: 文章发布日期，格式为YYYY-MM-DD
tags: # 文章标签
  - math
  - 概率
description: 文章简介，在主页显示
# 其他可选字段
lastUpdated: 是否显示最后更新时间（默认true）
not_append_title: 是否禁用自动添加标题（默认false）
comment: 是否开启评论（默认true）
sidebar: 是否显示右侧的目录（默认true）
---

<!-- # 不用手写标题，会自动用frontmatter里的title生成，除非手动设置not_append_title: true -->

<!-- 内容 -->

关于评论

使用基于Github discussion的giscus来做评论，好处是不会污染issue，同时还能支持楼中楼回复。

用法上，在.vitepress/config.ts里指定themeConfig: { comment: true }就可以开启所有页面的评论，也可以在各个文章的frontmatter里手动设置comment: false覆盖全局设置（about.md是个例子）。

需要在.vitepress/config.ts中的主题设置里的giscusConfig条目中填入必要的配置并启用相关仓库的discussion后才能使用评论相关功能，具体可参考https://giscus.app/zh-CN