GitBook的账号注册和安装使用（一）

今天药忘吃喽~ 2023-08-17 16:21 140阅读 0赞

# 1.GitBook账号注册 #

GitBook原注册地址  [https://legacy.gitbook.com/join][https_legacy.gitbook.com_join] 改为： [https://www.gitbook.com/][https_www.gitbook.com]

(1)注册账号：[https://app.gitbook.com/join][https_app.gitbook.com_join]，输入用户名、邮箱地址、密码，点击创建账号

[![image][]][image 1]

（2）激活你的账号，填入国家，真实的手机号码，点击send me…

[![Snipaste\_2019-08-21\_17-00-47][Snipaste_2019-08-21_17-00-47]][Snipaste_2019-08-21_17-00-47_Snipaste_2019-08-21_17-00-47]

（3）在输入框中输入发过来 的验证码，点击确定（图忘记截图了）

（4）进入GitBook后台管理界面

[![image][image 2]][image_image 2]

# 2.GitBook安装 #

## 2.1下载和安装Node.j ##

GitBook 是一个基于 Node.js 的命令行工具,因此需要下载和安装Node.js

下载地址：[http://nodejs.cn/download/][http_nodejs.cn_download]

点击windows安装包

[![image][image 3]][image_image 3]

弹出另存为，自定义下载路径，这里是安装包，非压缩包，放到桌面即可

[![image][image 4]][image_image 4]

去到桌面双击安装，下一步，同意协议，自定义安装路径，一直下一步，点击完成，安装完成后，去到你安装的路径下，如

[![image][image 5]][image_image 5]

检测是否输出hello node文件，以管理员的身份打开cmd,输入以下语句测试，下图表示编译成功

[![image][image 6]][image_image 6]

那测试test.js，能否运行，先在桌面创建node\_test文件夹，里面放test.js文件

[![image][image 7]][image_image 7]

其内容：

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编译

[![image][image 8]][image_image 8]

访问网址[http://127.0.0.1:3000][http_127.0.0.1_3000]。如果正常访问了，则安装成功

[![image][image 9]][image_image 9]

最简单是否安装成功的方法，查看版本号，在cmd,输入

node -v

[![image][image 10]][image_image 10]

###  ###

### 1.2.2安装GitBook ###

输入命令，全局安装gitbook

npm install gitbook-cli -g

[![image][image 11]][image_image 11]

[![image][image 12]][image_image 12]

[![image][image 13]][image_image 13]

安装完成之后，使用下面的命令来检验是否安装成功

gitbook -V

[![image][image 14]][image_image 14]

# 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  #初始化成功

[![image][image 15]][image_image 15]

初始化 GitBook 目录，创建两个 md 格式的文件 README.md 和 SUMMARY.md

*  README.md - 项目的介绍
 *  SUMMARY.md - GitBook 的目录结构

[![image][image 16]][image_image 16]

（2）定义目录结构

在 SUMMARY.md 文件中定义目录结构有两种方法。

*  方法 1： 先定义好目录结构，通过 `gitbook init` 自动生成目录结构对应的文件夹和 Markdown 文件。
 *  方法 2： 先创建好文件夹和 Markdown 文件再来编辑目录结构。

#  #

个人定义SUMMARY.md 的目录结构：

# Summary

*[简介]（README.md）
    *[安装和下载]（docs/安装和下载.md）
    *[简单使用]（docs/简单使用.md）
    *[深入学习]（docs/深入学习.md）
    *[总结]（docs/总结.md）

在跟目录下执行命令：

$ gitbook init

[![image][image 17]][image_image 17]

`gitbook init` 只支持生成两级目录，

[![image][image 18]][image_image 18]

在根目录下执行启动服务命令，

gitbook serve

出现出错：

[![image][image 19]][image_image 19]

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 行

[![image][image 20]][image_image 20]

将 confirm: true</CODE> 改为 <CODE>confirm: false</CODE>

参考：[https://www.cnblogs.com/wenhui92/p/9482629.html][https_www.cnblogs.com_wenhui92_p_9482629.html]

重新输入

gitbook serve

[![image][image 21]][image_image 21]

访问：[http://127.0.0.1:4000/][http_127.0.0.1_4000]

[![image][image 22]][image_image 22]

参考：

[https://www.cnblogs.com/Lam7/p/6109872.html][https_www.cnblogs.com_Lam7_p_6109872.html]

[https://www.cnblogs.com/wenhui92/p/9482629.html][https_www.cnblogs.com_wenhui92_p_9482629.html]

[https://blog.qianchia.com/articles/6099a7cb.html][https_blog.qianchia.com_articles_6099a7cb.html]

[  
][Link 1]

转载于:https://www.cnblogs.com/fby698/p/11390771.html

[https_legacy.gitbook.com_join]: https://legacy.gitbook.com/join
[https_www.gitbook.com]: https://www.gitbook.com/
[https_app.gitbook.com_join]: https://app.gitbook.com/join
[image]: /images/20230810/c6842e66ce544694bc9193fa30cebef5.png
[image 1]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193241612-1326597716.png
[Snipaste_2019-08-21_17-00-47]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193311195-2073053113.jpg
[Snipaste_2019-08-21_17-00-47_Snipaste_2019-08-21_17-00-47]: /images/20230810/94d107a175cd4c81bac44d8972cf0832.png
[image 2]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193323934-1944135874.png
[image_image 2]: /images/20230810/481d09d243494866b78b4597c1e88684.png
[http_nodejs.cn_download]: http://nodejs.cn/download/
[image 3]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193337681-198095756.png
[image_image 3]: /images/20230810/7f77d8880d6444e9addf7f1369747b4c.png
[image 4]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193353963-1624847851.png
[image_image 4]: /images/20230810/c376e725dae242d9a636bc54f3fae9c3.png
[image 5]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193407611-1595184484.png
[image_image 5]: /images/20230810/a3db8fb2e8f0444799cd56f0e2ed6f50.png
[image 6]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193421357-1285271151.png
[image_image 6]: /images/20230810/0a10f7f8d1b84f1cba6451fe54d744a5.png
[image 7]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193434866-1865821998.png
[image_image 7]: /images/20230810/0ef54be1af7b48d797a2fa8e02c10b93.png
[image 8]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193449504-756378530.png
[image_image 8]: /images/20230810/d77ec938cb504fb493e5af987829fb10.png
[http_127.0.0.1_3000]: http://127.0.0.1:3000
[image 9]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193505969-179923132.png
[image_image 9]: /images/20230810/299a96e235124f499acdda5644bdde8b.png
[image 10]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193528518-271259123.png
[image_image 10]: /images/20230810/f4f352b9ddac48fda0a8161c4bf20965.png
[image 11]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193542478-553698380.png
[image_image 11]: /images/20230810/000258cff8074d43bdb9278f0f2c9e07.png
[image 12]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193557766-169057968.png
[image_image 12]: /images/20230810/35c3889e7973408ea1cd94f6fc1da8d5.png
[image 13]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193617655-1852474993.png
[image_image 13]: /images/20230810/8a2df3c5cee245b79121adc33017acbc.png
[image 14]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193630334-680308957.png
[image_image 14]: /images/20230810/0bca0725909441f49f7267c6c8f59d15.png
[image 15]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193646840-160583610.png
[image_image 15]: /images/20230810/de68fb60779b4563b092a83e7e51636a.png
[image 16]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193659542-995810500.png
[image_image 16]: /images/20230810/a0867c1edf9348a8a808796fac35f6c3.png
[image 17]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193712162-449427442.png
[image_image 17]: /images/20230810/5413339d87894b5a87fceb2ce10fe0ef.png
[image 18]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193823203-815858233.png
[image_image 18]: /images/20230810/c51539c6676c447593cef568ae1c5b84.png
[image 19]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193845623-2129795286.png
[image_image 19]: /images/20230810/30dfd0caa2c144cb8be9260f318a5f97.png
[image 20]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193858837-410785105.png
[image_image 20]: /images/20230810/ada45bd6b6cf4932b1afc5b9ec1bc334.png
[https_www.cnblogs.com_wenhui92_p_9482629.html]: https://www.cnblogs.com/wenhui92/p/9482629.html
[image 21]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193912896-630293487.png
[image_image 21]: /images/20230810/0cbfa9b0a4eb4b06a970e44867a6ebe8.png
[http_127.0.0.1_4000]: http://127.0.0.1:4000/
[image 22]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821193929165-480240071.png
[image_image 22]: /images/20230810/de98420b3cfa4609b3a9b888db405f09.png
[https_www.cnblogs.com_Lam7_p_6109872.html]: https://www.cnblogs.com/Lam7/p/6109872.html
[https_blog.qianchia.com_articles_6099a7cb.html]: https://blog.qianchia.com/articles/6099a7cb.html
[Link 1]: https://img2018.cnblogs.com/blog/1378339/201908/1378339-20190821194325949-485842798.png