在Linux系统部署docsify工具小记

2023-05-16

背景:
编写项目资料需要一个方便编辑和部署的文档网站,支持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- VERSIONDISTRO/bin添加到 /etc/profile 文件的PATH变量中,再重启下操作系统可以永久生效。
Doxsify的具体使用可以参考官网介绍,比较详实。

本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系:hwhale#tublm.com(使用前将#替换为@)

在Linux系统部署docsify工具小记 的相关文章

随机推荐