docdoc 文档

从 git 仓库发布站点

适用场景：文档源在共享 git 仓库，希望以仓库为唯一事实源，由服务器端克隆并构建。

前置条件：服务器可以访问该 git 仓库；已知服务器地址与访问令牌。

操作步骤

  1. 执行：

    docdoc add --remote docdoc://docs.example.com:10001 https://github.com/your-org/your-docs.git --name my-docs

  2. 固定分支或标签时追加 --ref：

    docdoc add --remote docdoc://docs.example.com:10001 https://github.com/your-org/your-docs.git --name my-docs --ref v1.2.0

  3. 看到 注册成功：my-docs，N 页，构建于 <时间> 即完成，访问 http://<服务器>:端口/my-docs/ 核验。

注意

  • 服务器克隆失败会返回 422「git 克隆失败」，检查仓库地址与服务器网络可达性
  • 发布新内容是「更新仓库 → 重新走发布」（同名站点需先删除，见站内搜索 ?更新站点）