项目版本
以演示项目为例:
en/demo2/v
中是项目的当前版本号,会显示在侧栏大纲项目名称的右侧。
这里en/
是.i18n/conf.yml
配置的翻译源语言对应的语言代码。
如果你的源语言不是英语,那么v
文件应该放到你的源语言的项目目录下。
浏览文档历史版本的功能正在开发中。
建议只在发布重大更新时(比如v1
、v2
)修改文档的版本号,避免版本号太多导致搜索引擎索引的页面杂乱。
用空的v
文件,拆分不同项目的文件索引
在演示项目中,除了en/demo2/v
,还可以看到en/blog
和en/demo1
目录下都有内容为空v
文件。
空的v
不会显示在侧栏大纲中,但只要存在v
文件,就会为该目录及子目录下的文件生成独立的索引。
通过拆分不同项目的索引,可以避免一次性加载全站所有文件的索引导致访问速度缓慢。
比如,演示项目中blog
对应的索引文件是: https://unpkg.com/i18n.site/en/blog.json