从本地目录发布站点

适用场景:源目录就在当前机器上,希望本地构建、把产物上传到服务器。

前置条件:已知服务器地址(docdoc://host:port)与管理员分发的访问令牌;服务器已由管理员启动。

操作步骤

  1. 在源目录所在位置执行:

    docdoc add --remote docdoc://docs.example.com:10001 ./my-docs --name my-docs
    
  2. 终端打印 本地源:构建产物…,首次接入该服务器时提示输入令牌;输入后自动缓存,之后免输。

  3. 看到 注册成功:my-docs,N 页,构建于 <时间> 即完成。

  4. 访问 http://<服务器>:端口/my-docs/ 核验站点;需要独立域名时追加 --domain:

    docdoc add --remote docdoc://docs.example.com:10001 ./my-docs --name my-docs --domain docs.example.com
    

    域名须已解析到服务器;绑定后 http(s)://docs.example.com/ 直接落在此站点。

本地源还是 git 源

你的情况 选择
源在本机、随时改随时发 本地源(本页)
源在共享仓库、以仓库为唯一事实源 git 源(站内搜索 ?git 源发布)
服务器无法访问你的 git 仓库 本地源

把 --name / --domain 写进源目录 docdoc.json 的 name / domain 字段后,发布与下架都可以省略这些参数(docdoc add --remote … ./my-docs、docdoc del --remote … ./my-docs),命令行参数仍然优先,可在发布时同步覆盖。

命令选项说明见站内搜索 ?add 命令。