关于win7系统下gitbook的安装与gitbook editor的配合使用

1.安装nodejs

2.node -v，可查看node版本； npm -v，可查看npm版本

3.npm install gitbook-cli -g，安装gitbook

此过程经常报错，如果报错，找到  nodejs\node_modules\npm\npmrc文件，打开后，修改如下：

这是我的原文件的内容：prefix=${APPDATA}\npm

这是修改后的内容：

prefix=${APPDATA}\npm
proxy = null
registry = https://registry.npm.taobao.org/
disturl = https://npm.taobao.org/dist

4.gitbook -V（注意V要大写），显示 cli版本，同时安装gitbook

如果安装没反应，可能是网速问题，将电脑重启后再试

5.安装完成后，在当前目录下创建mybook的文件夹：

　　　　mkdir mybook

6.进入mybook目录： 　　

　　　　cd .\my book

7.初始化，在mybook文件夹下会生成两个文件（README.md、SUMMARY.md）：　　　

　　　　gitbook init

8.　　    gitbook serve

输入此命令，最后出现如下语句：

Starting serve ...

Serving book on http://localhost:4000

这样在地址栏输入http://127.0.0.1:4000/就可以进行本地访问了

 

--------------------------------------------华丽的分割线----------------------------------------------------------

--gitbook editor的使用

1、下载安装

首先到官网（https://www.gitbook.com/editor）下载Gitbook Editor，然后安装，我的是win7系统，安装是提示缺少.net4.5，去微软官网下载安装就行，我安装的.net版本是NDP451-KB2858728-x86-x64.3505182529。

 

2、使用GitBook.Editor

点击桌面上的GitBook.Editor图标

如下图所示

 

点击New Book新建电子书

 

记得输入英文的书名，不识别中文

 

点击新建的电子书

 

无法将word中的字段复制到GitBook.Editor，不过我测试Notepad++是可以的

 

Introduction：

点击左侧的Introduction进行编写电子书的简介信息

上边的H1、H2和H3分别代表一级标题、二级标题以及三级标题

 

表格的添加需要点击右上角的Insert Table按钮，然后添加内容

点击表格会出现添加行和列以及删除行和列的选项

 

电子书章节内容添加：

1）引言

在左侧右键点击“Add Article”

 

 

左侧点击引言章节，在右侧可以添加章节内容

 

1.1） 概述

右侧右键点击引言添加章节，章节名为1.1.概述

添加章节内容

 

1.2）功能简介

参照之前的添加章节和内容

 

按照上面的方式把其他章节依次添加，如果需要添加图片，点击菜单栏的Insert Image图标，选择本地的图片上传就ok了，最后编辑完成后点击save保存电子书。

 

对于GitBook.Editor其他的应用大家就自由学习自由发挥吧。

 

-----------------------------------------------华丽的分割线-------------------------------------

--使用gitbook发布电子书

1.当用gitbook editor编辑电子书my_python后，如果你是按照默认路径安装的gitbook editor，那么编辑好的电子书所在目录为：C:\Users\Administrator\GitBook\Library\Import\my_python

2.把该目录下的电子书my_python拷贝到安装好的gitbook服务器上，D:\Program Files\nodejs

3.进入电子书路径 cd D:\Program Files\nodejs\my_python，调用命令gitbook serve，直至出现以下语句：

Starting serve ...

Serving book on http://localhost:4000

然后就可以本地进行访问了