00:00:00
命名规则
命名规则
我们在维护Teek仓库之前,必须得弄清楚Teek里目录及文件的命名规则,以方便后续维护Teek网站。
原文链接:结构化目录 | vitepress-theme-teek
如果你搭建的是博客风的站点,那么 Teek 建议和 vdoing 一样,使用以下命名约定:
- 无论是文件还是文件夹,请为其名称添加上正确的正整数序号和
.
,从00
或01
开始累计,如01.文件夹
、02.文件.md
,我们将会按照序号的顺序来决定其在侧边栏当中的顺序 - 同一级别目录别内即使只有一个文件或文件夹也要为其加上序号
序号只是用于决定先后顺序,并不一定需要连着,如 01、02、03...
,实际可能会在两个文章中间插入一篇新的文章,因此为了方便可以采用间隔序号 10、20、30...
,后面如果需要在 10
和 20
中间插入一篇新文章,可以给定序号 15
。
当然可以使用非序号的命名,这并不影响使用,添加序号只是为了排序,且更具有结构化,如果同一个目录下同时存在带序号和不带序号的文件,在生成侧边栏时,Teek 会分为两个区:带序号区和不带序号区,两个区内部按照各自的逻辑排序,在最终生成侧边栏的时候,不带序号区始终放在带序号区的后面。
从维护性、可读性的角度分析,带有序号的文件名在本地目录看起来更加直观;从站点渲染的角度分析,在生成侧边栏时,Teek 会根据文件名的序号进行排序。
说明
没有为什么,照着弄就行;(这里都是最佳实践,刚开始可能感觉有点怪,但是用着用着就会觉得极其丝滑)