体验了gitbook后,我坚定的觉得它能解决我目前的问题。
然后我就产生了新的需求:如何实现多人共同编辑一本书?
解决这个问题就需要知道gitbook的目录和文件结构
1、New book
做了new book 后,会在你的默认目录下创建一个文件夹,文件夹的命名就是你书的名字,当然它只能是英文(拼音)的。
然后在文件夹里,可以发现若干个文件,重要的是那几个md文件
SUMMARY.md是书本的目录,README.md 看得懂不解释,chapter1.md 这个是示例章节的正文
2、我们打开客户端验证下
这里面有两个TAB,TOC和FILES
TOC 就是书的目录了,也就是SUMMARY.md的内容,而FILES就是我们分散的书的正文,一个章节可以对应一份正文文件,当然这要配置。
3、新建一个章节看看
同步的会新建出一个md文件,当然在右侧的编辑框内编辑内容也是同步的,毕竟是同一个文件(废话)。
4、一个结论
gitbook 的章节可以对应一个文件,也就是团队编辑的时候,可以每个章节文件交给一个人编辑。至于怎么管理,可以使用 git 或者 svn。
5、新的问题
上面都是先有目录,然后生成了文件,那么如果已经有md文件了,怎么把它关联到书的目录里?
可以编辑 SUMMARY.md,创建个新目录
然后选择目录文字后,选择插入链接
链接里选择需要关联的md文件名即可
6、最后提一点(baidu到的,感谢网友分享)
左侧导航栏无法跳转
gitbook生成的静态网页很像wiki,左侧有电子书的导航栏,很方便。但是,点击链接居然不会跳转。不会跳转的超链接能叫超链接吗?
此时,在_book文件夹内,找到gitbook文件夹,在里面找到theme.js
打开,用文本搜索工具搜索查找
if(m)for(n.handler&&
注意,文本时压缩过的,不要搜索if(m),那样找不到。
找到后,将 if(m)
改成if(false)
再次打开_book下的网页,左侧导航栏超级链接就可以正常跳转了。