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

1.GitBook帐号注册

       GitBook原注册地址  https://legacy.gitbook.com/join 改成: https://www.gitbook.com/html

(1)注册帐号:https://app.gitbook.com/join,输入用户名、邮箱地址、密码,点击建立帐号node

image

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

Snipaste_2019-08-21_17-00-47

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

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

image

2.GitBook安装

2.1下载和安装Node.j

GitBook 是一个基于 Node.js 的命令行工具,所以须要下载和安装Node.jswindows

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

点击windows安装包工具

image

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

image

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

image

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

image

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

image

其内容:

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

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

image

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

node -v

image

1.2.2安装GitBook

输入命令,全局安装gitbook

npm install gitbook-cli -g

image

image

image

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

gitbook -V


image

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

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

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

image

(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

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

image

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

gitbook serve


出现出错:

image

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

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


参考:http://www.javashuo.com/article/p-ujkgdbzv-dp.html

从新输入

gitbook serve

image

访问:http://127.0.0.1:4000/

image


参考:

http://www.javashuo.com/article/p-hluwmccr-cv.html

http://www.javashuo.com/article/p-ujkgdbzv-dp.html

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

相关文章
相关标签/搜索