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

本页目录

• docsify环境准备
  • Linux安装Node.js（我当前是CentOS）
• 开始配置 docsify
  • 创建一个文件夹，并进入
  • 全局配置docsify-cli客户端
  • 有了docsify-cli客户端就可以初始化项目
  • 启动我们刚才初始化的项目（可不执行）
• Nginx配置docsify
  • Linux后台启动不停机利用node启动docsify（不推荐）

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