【linux】docsify搭建markdown文件服务器

0. 中文说明地址：https://docsify.js.org/#/zh-cn/quickstart
1. 编译安装nodejs

• 安装依赖：yum install -y gcc make gcc-c++ openssl-devel wget
• 进入下载目录：cd /usr/local/src
• 下载nodejs：wget https://nodejs.org/dist/v12.16.1/node-v12.16.1.tar.gz
• 解压：tar zvxf node-v12.16.1.tar.gz
• 进入目录：cd node-v12.16.1
• 编译：./configure
• 安装：make && make install
• 测试：
  • node -v
  • npm

2. 安装docsify-cli工具：npm i docsify-cli -g
3. 搭建目录

• 新建目录：mkdir test
• 初始化目录：docsify init test # 建议使用绝对目录
  • 目录说明

    • index.html 入口文件

    • README.md 主页渲染内容

    • .nojekyll 用于阻止 GitHub Pages 会忽略掉下划线开头的文件

    • 可新建 _sidebar.md ,_navbar.md ,_coverpage.md等来美化或者操作多文件

      • sidebar.md

      * [文档说明](document/)
      

      • navbar.md

      * [文档说明](document/)
      

      • coverpage.md

      # 在线文档
      * [文档说明](document/)
      

    • 注意每个子目录中README.md为渲染文件，示例目录如下

      • test
        • document
          • README.md
        • index.html
        • README.me
        • .nojekyll
        • …
• 运行：docsify serve test
• 测试访问：curl http://localhost:3000

4. nginx转发代理配置

server {
    listen 80;
    server_name domain.com;

    location / {
        proxy_pass http://127.0.0.1:3000/;
        proxy_redirect off;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

• 注意记得重启nginx

5. supervisor守护进程

• 配置

  [program:test]
  directory = test_path
  command = docsify serve test
  autorestart = true
  user = root
  redirect_stderr = true
  stdout_logfile = /log_path/test_stdout.log
  stderr_logfile = /log_path/test_stderr.log
  loglevel = info
  

• 以supervisor守护启动：/usr/bin/python2 /usr/bin/supervisord -c /etc/supervisord.conf