GitBook最完整简易使用教程

GitBook最完整简易使用教程

Node.js安装

GitBook 是一个基于 Node.js 的命令行工具 ,使用前需要Node.js的环境,先下载node.js并安装

下载地址

安装完毕后,打开命令行,输入如下指令进行验证,若得到第二行的版本号,则安装成功

C:\Users\JunSIr>node -v
v10.16.3

C:\Users\JunSIr>npm -v
6.9.0

GitBook服务端安装

在安装完node.js并验证成功后,打开命令行,输入如下代码安装GitBook服务端

npm install -g gitbook-cli

安装完毕后,使用以下命令进行验证

gitbook -V

注意:此处V必须是大写

编辑器安装

大家可以选择市面上任意一款支持markdown语法的编译器,在这里我使用Typora编译器

下载地址

创建书目录

打开命令行,用以下指令创建一个书的文件夹

C:\Users\JunSIr>d:

D:\>mkdir gitbook_books

D:\>cd gitbook_books

D:\gitbook_books>

初始化GitBook

输入初始化指令 gitbook init 我们会在书文件夹中得到以下几个文件

153252.

其中,README文件为说明文档,可以用typora打开,添加我们创建的电子书的说明
在这里插入图片描述

接着介绍SUMMARY.md文件,此文件为章节目录设置文件,一般我们写博客不会定义章节,定义标题较多,而如果想把创作整合成电子书模式,我们会按章节创作,因此我们可以利用Sumary.md文件进行章节目录划分

在这里插入图片描述

我们通过【】()这种格式定义章节在【】里写入章节名,在()里写入英文名.md

注意,在编辑完SUMMARY文件后需要再次初始化

启动GitBook服务

在命令行(如果重新打开了命令行,记得cd到刚创建的书的文件夹下,以下所有有关命令行的操作都是一样的)输入 gitbook serve指令,启动gitbook服务

在这里插入图片描述

看到如上界面表示GitBook服务成功启动,我们访问命令行最下方的链接

http://localhost:4000

查看我们的电子书预览效果

在这里插入图片描述

内容编辑

很简单,在编辑完summary文件,经过初始化后,我们后在书文件夹中,用typora打开我们之前在summary文件中定义的md文件,进行编辑即可,如下

在这里插入图片描述

注意,编辑完要访问gitbook4000接口查看效果,需要重新初始化并再次启动服务。

在所有内容编辑完毕后,在命令行中输入指令 gitbook build

完成后,可见生成如下文件

在这里插入图片描述

同步到GitHub

首先,登陆GitHub,新建仓库

在这里插入图片描述
填写仓库信息

在这里插入图片描述

复制GitHub地址

–>进入刚刚创建好的仓库
在这里插入图片描述

在命令行中执行如下命令(需安装Git,安装完毕后重启命令行)

git clone + 刚刚在仓库中copy的GitHub地址
在这里插入图片描述

执行完毕后,在书文件夹下会产生一个与你项目名称一致的文件夹,到此文件夹下,将刚刚build后产生的文件全部拖入该文件夹

在这里插入图片描述
进入命令行,cd到刚刚git帮我们创建好的GitHub仓库文件夹下,执行Git发布命令,如下

D:\gitbook_books>cd MyGitBooks

D:\gitbook_books\MyGitBooks>git add .

D:\gitbook_books\MyGitBooks>git commit -m "put the books in github"

D:\gitbook_books\MyGitBooks>git push

若出现身份识别,跟随提示在命令行中输入你的github邮箱与名称

在这里插入图片描述

若出现登陆弹窗,在弹窗中输入你的Github账号名和密码

最终
在这里插入图片描述

全部执行完毕后,在Github刷新你的仓库,可见文件已经同步过来了



  • 12
    点赞
  • 59
    收藏
    觉得还不错? 一键收藏
  • 7
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 7
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值