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

2023-01-19 10:13:30 浏览数 (1)

本页目录

  • 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)

代码语言:javascript复制
yum install npm复制

查看Node.js安装情况

开始配置 docsify

创建一个文件夹,并进入

代码语言:javascript复制
 mkdir docsify && cd docsify复制

全局配置docsify-cli客户端

代码语言:javascript复制
sudo npm i docsify-cli -g复制

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

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

本质就是帮我们创建项目

代码语言:javascript复制
docsify init ./docs复制

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

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

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

代码语言:javascript复制
docsify serve ./docs复制

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

Nginx配置docsify

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

代码语言:javascript复制
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(不推荐)

代码语言:javascript复制
 nohup docsify serve ./docs > log.out 2>&1  &

参考效果:update.ff11sf.com

0 人点赞