文档

路径前缀

当站点部署在一些静态托管站点时,其根路径并不是/。比如github pages,其根路径一般为/repertory_name/,如果需要部署到多个平台,那么修改资源的访问地址将是个噩梦。为此,docsite将根路径抽取出来,放置在site_config/site.js中的rootPath字段进行配置,配置规则如下:

  • 当部署根路径为/,则设置为''空字符串即可。
  • 当部署根路径不为/,则设置为具体的根路径,注意需以/开头,但不能有尾/

在执行docsite build前,请确保rootPath配置正确。

路径配置

对于站点内的页面链接,在site_config目录下配置时,请以/zh-cn/en-us开头,内置页面会对这些链接进行处理,拼接上rootPath,进而得到完整的访问地址。