Windows下GitBook客户端安装


最近在看一些使用 GitBook 制作的在线书,感觉不错,可以用来整理技术笔记,集结成书,还可以导出 PDF,EPUB,HTML 等多种格式。可惜现在gitbook网站无法注册,那自己来安装一个。
Windows下GitBook客户端安装_第1张图片

先了解一下:GitBook 是一个基于 Node.js 的命令行工具,可通过Node.js命令安装GitBook。使用 Github/Git 和 Markdown 来制作精美的电子书。如果需要本地生成pdf,mobi,epub等格式的书籍需要安装Calibre。目前GitBook 的使用方式分为离线和在线方式:

  • 使用命令创建基本GitBook
  • 使用网页在线编辑器创建、编辑GitBook。
  • 使用GitBookEditor客户端创建、编辑GitBook。

最简单的使用方式是使用GitBook Editor编辑GitBook ,然后使用相关命令编译成功HTML。这次先使用命令创建基本的GitBook。下面记录了windows下gitbook安装过程。

1、下载并安装node

1)下载地址http://nodejs.cn/download/

Windows下GitBook客户端安装_第2张图片

2)下载后直接点击安装。一直点击下一步就可以了:
Windows下GitBook客户端安装_第3张图片

3)检查node安装是否成功。
在cmd输入 node,输入 console.log("Hello,World!");出现如下所示,node安装成功。
Windows下GitBook客户端安装_第4张图片

也可以输入node -v查看node.js版本,说明安装成功了。
Windows下GitBook客户端安装_第5张图片

2、用cnpm命令安装gitbook-cli

在系统上使用gitbook命令,需要安装“gitbook CLI”,执行以下命令
//安装命令
npm install -g gitbook-cli
//卸载命令
npm uninstall -g gitbook
但npm的服务器在境外,安装cnpm后安装软件速度会更快,用下述命令可将npm指向国内镜像源:
npm install cnpm -g --registry=https://registry.npm.taobao.org
然后,用cnpm命令安装gitbook-cli,cnpm install -g gitbook-cli

Windows下GitBook客户端安装_第6张图片

3、创建自己的gitbook目录并初始化

1)创建自己的gitbook目录,mkdir d:\gitbook
2)进入自己的gitbook目录下,初始化gitbook,输入gitbook init
3)初始化后,生成HTML发布,输入gitbook build

Windows下GitBook客户端安装_第7张图片

4、启动gitbook服务

在cmd中输入gitbook serve,启动gitbook服务:

Windows下GitBook客户端安装_第8张图片

在浏览器访问: http://127.0.0.1:4000,就可以看到自己的电子书了!


注:启动服务前可以修改README.md,和SUMMARY.md,增加自己的markdown文件。

README.md一般是这本书的简介部分。SUMMARY.md是gitbook的目录结构,可以参照格式增加章节目录。01.md就是每个章节的markdown文件。
Windows下GitBook客户端安装_第9张图片

你可能感兴趣的:(Windows下GitBook客户端安装)