路径前缀
当站点部署在一些静态托管站点时,其根路径并不是/
。比如github pages,其根路径一般为/repertory_name/
,如果需要部署到多个平台,那么修改资源的访问地址将是个噩梦。为此,docsite将根路径抽取出来,放置在site_config/site.js
中的rootPath
字段进行配置,配置规则如下:
- 当部署根路径为
/
,则设置为''
空字符串即可。 - 当部署根路径不为
/
,则设置为具体的根路径,注意需以/
开头,但不能有尾/
。
在执行docsite build
前,请确保rootPath
配置正确。
路径配置
对于站点内的页面链接,在site_config
目录下配置时,请以/zh-cn
或/en-us
开头,内置页面会对这些链接进行处理,拼接上rootPath
,进而得到完整的访问地址。