docsify使用

docsify使用

参考网址:

https://mp.weixin.qq.com/s/cJIgBZVUl8qBpa1-hHc4Cg

简介

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更适合做这个事情

http://www.shaoming.club:8080/#/

欢迎大家浏览

模板下载地址: (参考作者的模板直接进行改造即可)

http://www.shaoming.club/upload/2022/02/%E6%89%93%E9%80%A0%E4%B8%80%E4%B8%AA%E5%B9%B2%E5%87%80%E5%8F%88%E5%8D%AB%E7%94%9F%E7%9A%84%E7%9F%A5%E8%AF%86%E5%BA%93-1fc4ec58f8434eb8a939166fbf05e396.zip