docsify使用
参考网址:
简介
docsify同样是一个很好用的知识文档网站生成框架,轻量简便,而且无需构建,写完内容就可以直接发布,界面干净又卫生。
前置环境
docsify唯一需要的一个前置工具就是npm
工具,我想这个大家应该都安装了吧。
如果没有的话,直接在本地电脑上安装一个node.js
环境就可以了。
不管是macOS还是Windows系统,直接去https://nodejs.org/
官网下载个安装包就可以了,直接下一步下一步即可,安装完成之后会包含npm工具。
安装docsify
环境准备好了,接下来就可以安装docsify工具了。
直接在命令行中执行如下命令即可安装docsify的本地命令行工具:
npm install -g docsify-cli
上述过程完成之后,执行如下命令即可查看安装是否成功,并且能看到安装的docsify版本:
docsify -v
这样工具就安装OK了,非常简单。
新建项目文件夹
接下来我们从零开始来新建一个本地的项目文件夹。
可以在任何地方新建,名字也可以随便命名,这里取名为repository
,代表的意思是知识仓库
网站初始化
进入到上述新建的项目文件夹repository
,执行如下命令即可初始化网站,非常简单:
docsify init
初始化成功之后,命令行里也会输出对应初始化成功的打印信息。
启动本地预览
在命令行执行如下命令,即可启动知识库网站:
docsify serve
我们会发现docsify会帮我们在localhost:3000
启动一个知识库网站。
然后在浏览器打开http://localhost:3000
即可看见网站效果。
到此快速入门已经完成
其余操作参考网址:
https://mp.weixin.qq.com/s/cJIgBZVUl8qBpa1-hHc4Cg 即可
我的知识库网站地址
我基于 nginx 服务器进行发布的 , 我也试过 tomcat , 都是可以的 , 推荐使用 nginx , nginx更适合做这个事情
欢迎大家浏览
模板下载地址: (参考作者的模板直接进行改造即可
)