1.GitBook账号注册
GitBook原注册地址 https://legacy.gitbook.com/join 改为: https://www.gitbook.com/
(1)注册账号:https://app.gitbook.com/join,输入用户名、邮箱地址、密码,点击创建账号
(2)激活你的账号,填入国家,真实的手机号码,点击send me…
(3)在输入框中输入发过来 的验证码,点击确定(图忘记截图了)
(4)进入GitBook后台管理界面
2.GitBook安装
2.1下载和安装Node.j
GitBook 是一个基于 Node.js 的命令行工具,因此需要下载和安装Node.js
下载地址:http://nodejs.cn/download/
点击windows安装包
弹出另存为,自定义下载路径,这里是安装包,非压缩包,放到桌面即可
去到桌面双击安装,下一步,同意协议,自定义安装路径,一直下一步,点击完成,安装完成后,去到你安装的路径下,如
检测是否输出hello node文件,以管理员的身份打开cmd,输入以下语句测试,下图表示编译成功
那测试test.js,能否运行,先在桌面创建node_test文件夹,里面放test.js文件
其内容:
var http = require("http"); http.createServer(function(req, res) { res.writeHead( 200 , {"Content-Type":"text/html"}); res.write("<h1>Node.js</h1>"); res.write("<p>Hello World</p>"); res.end("<p>beyondweb.cn</p>"); }).listen(3000); console.log("HTTP server is listening at port 3000.");
以普通的cmd进入desktop/node_test/,输入node test.js编译
访问网址http://127.0.0.1:3000。如果正常访问了,则安装成功
最简单是否安装成功的方法,查看版本号,在cmd,输入
node -v
1.2.2安装GitBook
输入命令,全局安装gitbook
npm install gitbook-cli -g
安装完成之后,使用下面的命令来检验是否安装成功
gitbook -V
3.GitBook的简单使用
(1)初始化gitbook
$ mkdir /d/mygitbook #创建文件夹 $ cd /d/mygitbook #进入所创建的文件夹 $ gitbook init #初始化gitbook warn: no summary file in this book info: create README.md info: create SUMMARY.md info: initialization is finished #初始化成功
初始化 GitBook 目录,创建两个 md 格式的文件 README.md 和 SUMMARY.md
- README.md - 项目的介绍
- SUMMARY.md - GitBook 的目录结构
(2)定义目录结构
在 SUMMARY.md 文件中定义目录结构有两种方法。
方法 1: 先定义好目录结构,通过
gitbook init
自动生成目录结构对应的文件夹和 Markdown 文件。方法 2: 先创建好文件夹和 Markdown 文件再来编辑目录结构。
个人定义SUMMARY.md 的目录结构:
# Summary
*[简介](README.md) *[安装和下载](docs/安装和下载.md) *[简单使用](docs/简单使用.md) *[深入学习](docs/深入学习.md) *[总结](docs/总结.md)
在跟目录下执行命令:
$ gitbook init
gitbook init
只支持生成两级目录,
在根目录下执行启动服务命令,
gitbook serve
出现出错:
Error: ENOENT: no such file or directory, stat
'D:\mygitbook\_book\gitbook\gitbook-plugin-fontsettings\fontsettings.js'
解决方法:
修改 <CODE>C:\Users\Administrator\.gitbook\versions\3.2.3\lib\output\website\copyPluginAssets.js</CODE> 文件中的 112 行
将 confirm: true</CODE> 改为 <CODE>confirm: false</CODE>
参考:https://www.cnblogs.com/wenhui92/p/9482629.html
重新输入
gitbook serve
参考:
https://www.cnblogs.com/Lam7/p/6109872.html
https://www.cnblogs.com/wenhui92/p/9482629.html