GitBook的账号注册和安装使用(一)

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

1.GitBook账号注册

  1. 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,输入用户名、邮箱地址、密码,点击创建账号

image

(2)激活你的账号,填入国家,真实的手机号码,点击send me…

Snipaste\_2019-08-21\_17-00-47

(3)在输入框中输入发过来 的验证码,点击确定(图忘记截图了)

(4)进入GitBook后台管理界面

image

2.GitBook安装

2.1下载和安装Node.j

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

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

点击windows安装包

image

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

image

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

image

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

image

那测试test.js,能否运行,先在桌面创建node_test文件夹,里面放test.js文件

image

其内容:

  1. var http = require("http");
  2. http.createServer(function(req, res) {
  3. res.writeHead( 200 , {"Content-Type":"text/html"});
  4. res.write("<h1>Node.js</h1>");
  5. res.write("<p>Hello World</p>");
  6. res.end("<p>beyondweb.cn</p>");
  7. }).listen(3000);
  8. console.log("HTTP server is listening at port 3000.");

以普通的cmd进入desktop/node_test/,输入node test.js编译

image

访问网址http://127.0.0.1:3000。如果正常访问了,则安装成功

image

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

  1. node -v

image

#

#

1.2.2安装GitBook

输入命令,全局安装gitbook

  1. npm install gitbook-cli -g

image

image

image

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

  1. gitbook -V

image

3.GitBook的简单使用

(1)初始化gitbook

  1. $ mkdir /d/mygitbook #创建文件夹
  2. $ cd /d/mygitbook #进入所创建的文件夹
  3. $ gitbook init #初始化gitbook
  4. warn: no summary file in this book
  5. info: create README.md
  6. info: create SUMMARY.md
  7. info: initialization is finished #初始化成功

image

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

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

image

(2)定义目录结构

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

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

#

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

  1. # Summary
  2. *[简介](README.md
  3. *[安装和下载](docs/安装和下载.md
  4. *[简单使用](docs/简单使用.md
  5. *[深入学习](docs/深入学习.md
  6. *[总结](docs/总结.md

在跟目录下执行命令:

  1. $ gitbook init

image

gitbook init 只支持生成两级目录,

image

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

  1. gitbook serve

出现出错:

image

  1. Error: ENOENT: no such file or directory, stat
  2. 'D:\mygitbook\_book\gitbook\gitbook-plugin-fontsettings\fontsettings.js'

解决方法:

  1. 修改
  2. <CODE>C:\Users\Administrator\.gitbook\versions\3.2.3\lib\output\website\copyPluginAssets.js</CODE>
  3. 文件中的 112

image

  1. confirm: true</CODE> 改为 <CODE>confirm: false</CODE>

参考:https://www.cnblogs.com/wenhui92/p/9482629.html

重新输入

  1. gitbook serve

image

访问:http://127.0.0.1:4000/

image

参考:

https://www.cnblogs.com/Lam7/p/6109872.html

https://www.cnblogs.com/wenhui92/p/9482629.html

https://blog.qianchia.com/articles/6099a7cb.html

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

发表评论

表情:
评论列表 (有 0 条评论,189人围观)

还没有评论,来说两句吧...

相关阅读

    相关 gitbook安装使用

    目前习惯了使用markdown来写文档,发现确实很好用啊,写完之后,排版啥的,确实也比较赏心悦目点(也许可能我要求不搞哈,哈哈哈),但是人的心是不容易满足的,一篇一篇的写,如果

    相关 GitBook使用教程

    各大站长平时除了写博客外,可以使用 gitbook 将一系列的博客专栏整理成电子书出版。这样既方便各大网友阅读,还可以带来新的离线阅读功能。 在以前我们只能靠出版社,或者编写