Windows10安装和使用Gitbook

 

参考

查阅了很多网页和教程，并测试了多个版本的node.js，最终只有10.21.0是无差错安装上了。

https://www.bilibili.com/read/cv6932054/

 

安装

安装Git

https://git-scm.com/download/win

安装完成后，测试

git --version

安装Node.js

https://cdn.npm.taobao.org/dist/node/v10.21.0/node-v10.21.0-x64.msi

安装完成后，测试

node --version

npm --version

设置npm的国内配置

npm config set registry=https://registry.npm.taobao.org

查看配置

npm config list

安装gitbook

打开Windows Terminal命令行

npm install gitbook-cli -g

gitbook -V

等待Installing gitbook3.2.3安装完成

安装Calibre

https://calibre-ebook.com/download_windows

测试导出pdf插件的命令行

ebook-convert --version

 

使用方法

在当前书籍的目录中执行

gitbook pdf

也可以指定目录和文件名

gitbook pdf ./ ./myBook.pdf --log=debug

 

开源书籍的写作流程

初始化目录

在Windows10的目录中创建一个文件夹，通过Terminal进入，执行

gitbook init

之后会生成README.md和Summary.md两个文件

通过Github创建远程仓库

在Github Desktop应用中通过本地目录创建一个远程仓库，不用新建README.md等文件，然后push origin

链接Gitbook.com

在gitbook.com上创建一个新的空间，然后连接github账号

找到刚才新建的仓库即可。

然后设置书籍访问地址，比如我这个

https://smartpark.dormanthink.cc

记得在cloudflare中添加DNS的CNAME

编辑书籍并发布

并与Github.com上merge

本地更新并输出pdf

回到本地命令行，刚才init的地方。

更新文章内容

git pull

输出pdf格式

gitbook pdf

 

大功告成！

 

后期问题

1.输出pdf后，文字的段落不是页边距设定的格式，可能需要在目录中新建book.json来配置

2.通过acrobat软件的命令行，将生成的pdf直接转成word