項目版本
以演示項目為例:
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