在linux上使用gitbook
环境
ubuntu16.04
gitbook 3,2,3
gitbook-editor
前言
gitbook是一个可以让你轻松做文档,电子书的软件,有gitbook仓库可以保存你的书,还可以与github链接,实现同步.
首先说明,gitbook有两个网站,新版本需要翻墙才能使用,旧版本不用翻墙但是现在的新用户必须在新网站上与github连接,所以对于没有梯子的同学来说,就是用不了.当然,我这篇文章就是就绝这件事的.
一般,目前网上的文章都是在www.gitbook.com(新网站)上注册然后连接到github上,文档在线编辑,但是我试了一上午都没反应,因为我的网本来不好,后来发现是要翻墙,mmp.
还有一部分是用giteditor,这是一个本地的编辑环境,就是个编辑器而已,然后保存到本地.
其三就是用nodejs来下载gitbook的命令行工具.这个工具是方便你在本地制作pdf,或者其他格式的书籍,然后在浏览器上显示,如果只向把文档写完然后提交,就没必要下载这个.
我在这总结一下,省的后来的小伙伴继续踩坑.
1.如果你能翻墙,你就没有问题可言,网上任何一个博客就可以轻松完事.
2.如果你之前注册过gitbook的账户,老网https://legacy.gitbook.com/,你只需要在老网站授权一下github就行.
3.如果你既不能翻墙又不是老用户,那就和我一样,我们都太惨了.那你就看看我是怎模做的.
做法
我先解释一下大体思路,就是下载gitbookeditor, 然后用giteditor来上传你的书到github.前提你有github账号和空仓库,注册账号和创建仓库 我就不说了.主要说说怎么用gitbookeditor在本地编辑然后上传到github.
1.下载editor软件,https://legacy.gitbook.com/editor,这个由64和32位的只能在ubuntu和deepin上用.
2.本地安装deb包.sudo dpkg -i ***.deb
如果有问题则输入sudo apt-get install -f
3.那么是如何启动软件呢?
如果您之前下载过gitbook-cli就是用nodejs下的工具,输入gitbook是直接进入gitbook,不是editor.
启动命令:gitbook-editor
就会出现如下界面
目前为止大家都没有账户,所以点击Do that Later
在下一个页面中点击new book
编辑页面就是这样
安装就已经结束了.软件中有两个主要的文件
gitbook用的都是markdown的语法,所有的页都是md文件,
readme.md是介绍这本书的,summary.md是整本书的目录,以后每次要添加新的章节就要先在这个文件了加入文件位置.
现在说说如何提交到github
首先这里的save保存编辑的文件到本地目录,这个路径没法改,反正我是没有查到方法,但是windows版本的editor是可以改的,大家可以参考.
切记,不要更改已经保存了的文件的目录,否则editor不会识别你更改过的位置,就算改回去也无法识别,所以不要乱动这个目录.一般点击save后会在当前用户目录下生成一个GitBook的目录,里面的Library/Input就是你的书的位置.
现在开始提交
1.点击publish
2.输入仓库的地址
3.检查是否同步完成.这张图是我引用别处的图,请注意版权问题.来自:https://segmentfault.com/a/1190000011440899
改错
之前写这篇文章是,实在上传文件时,边上传边写的,所以没有发现问题,但是后来发现,无法提交到github上,并且一次提交后,后来的更新都是自动更新的.得!还是提交不上去,不知道有没有小伙伴有这种情况.如果有的话在试试我这种方法,在
~/GitBook/Library/Import/书名 目录下输入la,查看当前目录下的文件,里面有.git文件,其实这个编辑器是把git集成再了编辑器内,几人自动提交不了,那就手动,我之前改了config文件发现不行,它这个配置文件是只和本地的master进行同步,不会和远端的同步的.那么还不如直接在这里克隆自己的仓库能,首先删除当前目录下的.git文件,(当然你可以赋值一份),然后cd .. 再git clone 自己的库到当前目录.然后git push就行了,这种方法比较笨,但就当只下载了个编辑器吧.
--------------------- 本文来自 siyan985 的CSDN 博客 ,全文地址请点击:https://blog.csdn.net/sb985/article/details/82252540?utm_source=copy