1. gitbook调试
warn: "options" property is deprecated, use config.get(key) instead
warn: "page.progress" property is deprecated
warn: "sections" property is deprecated, use page.content instead
TypeError: Path must be a string. Received undefined
这种问题的原因是,gitbook的版本太低。大家执行 gitbook update 命令进行升级,升级到3.2.2版本即可。
# 用gitbook生成的网站有如下特点
会生成
<li class="chapter " data-level="1.3" data-path="api/"> <a href="api/">
...
<li class="chapter " data-level="1.3.1.1" data-path="api/ugrp/addugrp.html">
看到目录的路径和底部文件生成的文件完全不一样。目录的部分没有index.html,而底部文件直接说好了.
这种文件目录放到oss里,就不会自动解析到api/index.html
oss遇到api/后会解析到根目录,参考:https://help.aliyun.com/document_detail/31872.html?spm=5176.8466029.static-page-info-block.1.41dd1450WGQ2dF
截取网站部分页面 用户访问http://oss-sample.oss-cn-hangzhou.aliyuncs.com/和http://oss-sample.oss-cn-hangzhou.aliyuncs.com/directory/的时候,相当于访问http://oss-sample.oss-cn-hangzhou.aliyuncs.com/index.html ``` 所以我们在生成页面后还需要对生成的Index.html进行替换,但这样生成出来的目录,第一次点击还可以,第二次就不行了。又回到了api/,这是gitbook内置的逻辑.
最后我们发现,所有目录只有不写对应文件,就会更加像目录,点击目录就会展开,关闭目录。所以建议目录不要添加对应文章。
2. 调试
3. 如果遇到如下问题:Error: ENOENT: no such file or directory, stat '/var/www/html/doc.xdua.com/_book/gitbook/gitbook-plugin-prism/prism-coy.css'
https://zhidao.baidu.com/question/1864965293733859947.html
4. 修改的就是文件尾巴里的confirm:true设为confirm:false
vi ~/.gitbook/versions/3.2.3/lib/output/website/copyPluginAssets.js
https://www.jianshu.com/p/427b8bb066e6 flexible-alerts 警报