背景:
编写项目资料需要一个方便编辑和部署的文档网站,支持Markdown
官方描述:
docsify 可以快速帮你生成文档网站。不同于 GitBook、Hexo 的地方是它不会生成静态的 .html 文件,所有转换工作都是在运行时。如果你想要开始使用它,只需要创建一个 index.html 就可以开始编写文档并直接部署在 GitHub Pages。
官网:
https://docsify.js.org/#/zh-cn/
部署环境:
debian 9.5 内核版本:4.9.0-12
部署步骤:
a、首先需要部署node.js
(1)到官网下载node.js安装包:https://nodejs.org/zh-cn/download/
我这里直接下载的是:Linux 二进制文件 (x64)
(2)创建nodejs目录并把二进制文件解压到此目录下
$ sudo mkdir -p /usr/local/lib/nodejs
$ sudo tar -xJvf node-$VERSION-$DISTRO.tar.xz -C /usr/local/lib/nodejs
(3)设置环境变量
$ export PATH=/usr/local/lib/nodejs/node-$VERSION-$DISTRO/bin:$PATH
$ . ~/.profile
(4)测试是否可用,命令执行后正常显示版本即ok
$ node -v
$ npm version
$ npx -v
b、安装docsify工具
(1)直接一条命令即可安装,需要联网。
$ su root
# npm i docsify-cli -g
(2)测试是否可用,命令执行后正常显示版本即ok
# docsify -v
PS:在步骤a里设置的环境变量是临时的,重新打开Terminal就会失效。可以把上面的环境路径/usr/local/lib/nodejs/node-
V
E
R
S
I
O
N
−
VERSION-
VERSION−DISTRO/bin添加到 /etc/profile 文件的PATH变量中,再重启下操作系统可以永久生效。
Doxsify的具体使用可以参考官网介绍,比较详实。
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)