Skip to content

写文章的一些注意事项。

第一项:目录区别

  1. pages 是文章存放地,@pages 是功能页,不用管。

  2. pages 下的目录是分类大目录,和主题的使用方式不一致,md 文章须存放在此目录的文件夹中再次新建的文件夹里,且不会在里再次创建文件夹。 例:pages/配置 是分类大目录,pages/配置/文章/ 是存放 md 文章的地方,这里只有 md 文章,以满足自定义的侧边栏。

第二项:文章设置

  1. top 表示精选文章 bool.

  2. sticky 表示置顶 number 排序

  3. titleTag 在精选和置顶文章列表有自定义小 tip, string ,比如 推荐,热门

  4. tags 取自 categories,所以是一样的,可以自行修改,YAML 结构,Array。

  5. title 在生成的时候和文件名称相同,可以自行修改。

  6. coverImg 是列表上的图片,不自动生成,手动添加,不是都要的,不然就太丑了。

  7. coverImg 选择非原图+ 8:5 + 横图,最后的效果比较好。

第三项:主题设置

  1. config.mts 是 vitepress 的设置。

  2. teekConfig.mts 是 teek 主题的设置

  3. theme/setting/teekConfig.mts 是文档模式/博客模式切换用的。

  4. Banner图全部是原图+16:9,不然放大太模糊了。

第四项:侧边栏,导航栏

  1. 在 getFiles.mts 里生成的,非主题再带提供的自动模式。

  2. 如第一项所谈。

第五项:

  1. 记得多找图,上部背景深色点的,好突出导航栏。
最近更新