ubuntu上使用gitbook和gitbookedit

在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.
１．下载editor软件,https://legacy.gitbook.com/editor，这个由64和32位的只能在ubuntu和deepin上用．
２．本地安装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就是你的书的位置．
现在开始提交
１．点击publish
２．输入仓库的地址

３．检查是否同步完成．
这张图是我引用别处的图，请注意版权问题．来自：https://segmentfault.com/a/1190000011440899

改错

之前写这篇文章是，实在上传文件时，边上传边写的，所以没有发现问题，但是后来发现，无法提交到github上，并且一次提交后，后来的更新都是自动更新的．得！还是提交不上去，不知道有没有小伙伴有这种情况．如果有的话在试试我这种方法，在
~/GitBook/Library/Import/书名　目录下输入la,查看当前目录下的文件，里面有.git文件，其实这个编辑器是把ｇｉｔ集成再了编辑器内，几人自动提交不了，那就手动，我之前改了config文件发现不行，它这个配置文件是只和本地的master进行同步，不会和远端的同步的．那么还不如直接在这里克隆自己的仓库能，首先删除当前目录下的.git文件，（当然你可以赋值一份），然后cd .. 再git clone　自己的库到当前目录．然后git push就行了，这种方法比较笨，但就当只下载了个编辑器吧．

 

--------------------- 本文来自 siyan985 的CSDN 博客 ，全文地址请点击：https://blog.csdn.net/sb985/article/details/82252540?utm_source=copy