GitBook的使用方式,快速建立网页文档

环境需求:node npm 得装好html

-----------------------------------node

我一开始不知道得先装gitbook-cligit

先执行了 npm install gitbook -gnpm

而后执行 gitbook -V   报了个错:浏览器

You need to install "gitbook-cli" to have access to the gitbook command anywhere on your system.
If you've installed this package globally, you need to uninstall it.
>> Run "npm uninstall -g gitbook" then "npm install -g gitbook-cli"服务器

而后我没npm uninstall -g gitbook ui

就直接npm install -g gitbook-clithis

结果执行:gitbook -V  始终显示在安装gitbook3d

以后uninstall 也卸载不了,只好去npm的目录下,把gitbook和gitbook-cli在npm的目录文件里删了,最后从新先执行:npm install -g gitbook-clicode

而后执行:gitbook -V,就自动开始安装gitbook了

而后再执行: gitbook  -V,这时候显示以下,安装成功!

--------------------------------这时候能够开始建立写网页文档模板了------------------------------------

新建一个你要写网页文档的文件夹

在当前文件夹下启动cmd执行:gitbook init

建立成功,这时候咱们能够看见文件夹下出现了两个文件README.md 和 SUMMARY.md 

 

README.md 是说明文档,而 SUMMARY.md 其实就是书的章节目录

接下来,咱们执行:gitbook serve ,而后在浏览器地址栏中输入 http://localhost:4000 即可预览书籍。

浏览器显示:

这时候咱们能够看见在gitbook文件夹中生成一个 _book 文件夹, 里面的内容即为生成的 html 文件

 

当咱们不想开启服务器,能够执行:gitbook build

这时候咱们就能够直接本地打开_book文件夹下的index.html

 

SUMMARY.md

这个文件主要决定 GitBook 的章节目录,它经过 Markdown 中的列表语法来表示文件的父子关系,以下:

对应的目录就是下面这样

 

 是否是很简单啊

相关文章
相关标签/搜索