1.搭建Nodejs环境
前往Node.js官网
下载最新版Nodejs windows系统安装包
安装成功后再cmd窗体中输入node -v 查看是否安装成功
这次我选择的是nodejs的v10.21.0版本,最新版本无效,需要用较低版本的nodejs
node.js下载地址
安装完成后进行检视
npm config get registry
npm config set registry https://registry.npm.taobao.org
2.安装 GitBook 可视化编写工具
下载GitBook Editor windows版
安装成功后桌面会有个gitbook图标
双击打开查看是否安装成功:
运行效果
点击最下面** Do that later **可不用登陆进入主界面
3.安装gitbook
在任意目录下运行cmd控制台 输入:npm install gitbook-cli -g 进行安装
4.配置gitbook目录
在GitBook Editor界面菜单中找到Change Library Path..来改变工作路径
(比如在:F:\GitBook Editor files)
5.创建测试项目
比如创建项目test点击Confirm创建
创建成功后找到SUMMARY.md
相关说明:README.md 和 SUMMARY.md 是两个必须文件
README.md 是对书籍的简单介绍
SUMMARY.md 是书籍的目录结构
创建成功
点击右下角 问号 对 Edit Markdown选项打钩
输入示例内容:
#Summary
* [Introduction](README.md)
* [第一章](chapter1/README.md)
* [第一节](chapter1/section1.md)
* [第二节](chapter1/section2.md)
* [第二章](chapter2/README.md)
* [第一节](chapter2/section1.md)
* [第二节](chapter2/section2.md)
* [结束](end/README.md)
输入示例内容
然后切换到项目目录中
(比如:F:\GitBook Editor files\Import\test)
按住Shift 然后点击鼠标右键
打开cmd窗体后
输入:gitbook init进行初始化
初始化完成后目录会多出几个文件夹(这时GitBook Editor可能会提示重新加载项目,点击蓝色按钮进行加载就可以了)
然后
输入:gitbook serve命令运行查看效果
然后在浏览器中访问http://localhost:4000进行访问
http://localhost:4000