最简洁好用的文档构建工具Gitbook的使用

本文介绍如何使用GitBook创建和管理基于Markdown的电子书,包括安装、初始化项目、编辑目录和文档,以及生成html和pdf文件。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

GitBook 是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书,目前gitbook可以支持生成静态html和pdf文档

安装使用

首先你需要安装node.js的环境,然后便可以使用npm脚手架工具下载安装gitbook工具

npm install gitbook-cli -g

或者使用cnpm淘宝的镜像源

cnpm install gitbook-cli -g

安装成功后,新建一个文件夹,此处为了方便演示,我们新建mybook文件夹

接着开始初始化gitbook项目

gitbook init

初始化成功后,可以看到目录中生成了两个文件

其中SUMMARY.md是目录文档,我们使用notepad++或者记事本打开

此时,gitbook默认生成了一个标题叫Introduction的目录,对应的文档是README.md。在这里为了达到演示效果,新建一个文档

取名字叫content_01,然后使用记事本或notepad++打开编辑

同时编辑SUMMARY.md文件,添加如下内容

保存后,在命令提示符中输入

gitbook serve

在浏览器中打开此地址,即可看到生成的文档

选择“第一章”标题,查看一下生成的文档内容

是不是很到玩呢?哈哈,如果有的小伙伴问二级目录该怎么生成呢?很简单,只需要在目录前加一个空格即可

运行效果如下:

最后,如果想生成html,放在服务器上运行,怎么办?

gitbook build

此时,项目目录下会生成_book文件夹,此文件夹中就是我们想要的html文件

打开_book文件夹

当然,此时若直接打开index.html文件是无法直接运行的,我们需要给它一个web环境,可以在本地启动一个tomcat也可以启动一个IIS,直接将_book文件夹中的内容丢进去即可

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值