因为没有执行git init导致折叠插件不生效

因为我的脚本会生成SUMMARY.md和Reademe.md,所以我一致认为gitbook init操作是没有意义的(其实我至今仍然认为这个操作没有任何意义),所以我选择直接使用gitbook build指令,结果发现我的折叠等插件根本没有生效。这个问题对我来说非常严重,如果笔记不能够折叠,看上就会有点乱糟糟的。

我花费了一个晚上定位修复这个问题,最后定位到了gitbook init操作上。gitbook init操作做了什么,目前我认为它主要生成了SUMMARY.md和README.md文件,而之所以我没有运行gitbook init导致我插件失效的原因就是,我的脚本是在Windows上开发的,我的SUMMARY.md生成的时候使用的是Windows的分割符,而gitbook貌似不支持这种分割符。

以往之所以能够成功,我觉得这里面更多的是运气吧,可能我运气好执行了gitbook init,又或者我的SUMMARY.md文件和gitbook init生成的几乎一致,所以导致我一直没有意识到这个问题。

后续:

这个问题可能没有我想象的这么简单,我又进行了一些尝试,如果我项目里原本没有READEME.md和SUMMARY.md则运行gitbook init后生成的SUMMARY.md也是空的(我需要再次验证这个问题),只有当我的项目里有SUMMARY.md时,gitbook init才会打印一些奇怪的create的日志信息(不是很理解这个日志信息)。

我是真的很想换掉gitbook了,node.js的版本问题就像魔鬼一样,我永远都不知道该使用哪个版本?现在gitbook暴漏出太多我无法理解的问题,需要靠无数次尝试才能够解决的问题,加之GitBook构建速度实在是太慢了,加之官方已经没有对GitBook Cli工具进行维护了。我现在真的挺想放弃GitBook。