从本地目录发布站点
适用场景:源目录就在当前机器上,希望本地构建、把产物上传到服务器。
前置条件:已知服务器地址(docdoc://host:port)与管理员分发的访问令牌;服务器已由管理员启动。
操作步骤
-
在源目录所在位置执行:
docdoc add --remote docdoc://docs.example.com:10001 ./my-docs --name my-docs -
终端打印
本地源:构建产物…,首次接入该服务器时提示输入令牌;输入后自动缓存,之后免输。 -
看到
注册成功:my-docs,N 页,构建于 <时间>即完成。 -
访问
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 命令。
