zl程序教程

您现在的位置是:首页 >  其他

当前栏目

docsify 文档站点生成器 – 建站工具

2023-02-25 18:17:32 时间

本页目录

docsify官网:https://docsify.js.org/

docsify环境准备

需要我们准备Node.js环境。

Linux安装Node.js(我当前是CentOS)

yum install npm复制

查看Node.js安装情况

开始配置 docsify

创建一个文件夹,并进入

 mkdir docsify && cd docsify复制

全局配置docsify-cli客户端

sudo npm i docsify-cli -g复制

此时可能会让你执行更新npm的操作,你按照提示执行即可升级npm,然后在执行上面的命令

有了docsify-cli客户端就可以初始化项目

本质就是帮我们创建项目

docsify init ./docs复制

命令执行后会自动在文件创建了docs文件夹,里面有一个index.html

启动我们刚才初始化的项目(可不执行)

(如果你有Nginx不需要利用node启动服务,docsify纯静态资源)

docsify serve ./docs复制

注意,这条命令执行后,就会利用node启动一个http服务,一般端口是3000。我们通过3000端口就可以访问到我们的站点了。

Nginx配置docsify

docsify无需开服务,页面纯静态,Nginx直接指向文件目录就行了,注意 alias 前后都有/哦。

server
{
    listen 80;
    listen 443 ssl http2;
    server_name update.ff11sf.com;

    location / {
		# proxy_pass http://localhost:3000/;
		alias /home/myoutput/docsify/docs/;
    		index index.html;
    }
}复制

Linux后台启动不停机利用node启动docsify(不推荐)

 nohup docsify serve ./docs > log.out 2>&1  &

参考效果:update.ff11sf.com