gitbook能够很方便的和github关联,实现团队协作的效果.可是github私有库需要付费.但是开源中国码云能够建私有库,于是考虑将gitbook关联码云,折腾了一番后,能够可视化的关联,后面就没有继续的深入了,毕竟预期的目的基本达到了.以下内容均为实践所得,仅供大家参考!
windows下搭建gitbook平台
参考:gitbook安装与使用之windows下搭建gitbook平台,非常详细
与码云关联
需要用到的工具:gitbookEditor,git版本控制器
1.首先在码云中新建一个项目,并复制该项目的地址,由于目前gitbookEditor只支持https方式,所以不要复制ssh地址.
2在本地的gitbook项目文件夹下,新建一个文件夹(为了方面,名为testbook),用来新建书籍和版本控制,先git clone码云上的新项目到该文件夹,然后用cmd在该文件gitbook init一本新书(先引进.git文件,gitbookEitor打开后,push的时候就知道是关联的开源中国码云).
3打开gitbookEditor,在local Library下open文件夹testbook,它会找到你建的新书(open与import的区别在于,import打开,你编辑的不是testbook,而是它又复制了一份你的书籍进行操作,比如你在gitbookEditor上编辑并保存了新内容,你在testbook中是看不到变化,它是在另外一个文件夹下保存,你需要push你的内容再pull,testbook才会更新,而open是直接操作的testbook)
4通过gitbookEditor来编辑你的新书,保存后,在窗口book工具栏选择push,就可以推送你的内容到码云了,第一次需要输入你的码云的账号密码,所以也不需要考虑以https方式需要多次输入账号密码,这样就可以团队协作来编辑在码云私有库中的项目了.
windows下gitbook转pdf
需要用到的工具:calibre,phantomjs(这个貌似需FQ,我下载的时候不FQ均失败);
1将上述2个安装,calibre默认安装的路径C:\Program Files\Calibre2,phantomjs为你解压路径;
2并将其目录均加入到系统变量path中,参考:目录添加到系统变量path中;
3在cmd打开你需要转pdf的文件夹,输入gitbook pdf即可;