云端文档库
云端文档库是 Loci Server 上预先发布的公开文档快照。CLI 可以将快照下载为本地副本,之后即可离线浏览、搜索和读取。
修改默认的云端文档库地址
正式版 CLI 和桌面应用默认连接 https://loci.xiaowo.live。如果使用自行部署的 Loci Server,可以将 server-url 改为对应地址。
示例:
使用以下命令可以确认当前地址并检查 Server 是否可以访问:
server-url 是 CLI 与桌面应用共用的设置。这里修改的是云端文档库的 Server 地址,不会改变本地文档源的网页 URL。
桌面开发版的全新数据默认连接 http://localhost:7001。CLI 本地开发可以设置环境变量 LOCI_SERVER_URL=http://localhost:7001;npm 安装的正式版不设置该变量时,首次默认使用生产地址,并保留用户后来保存的自定义地址。
已经下载的云端副本会记录原 Server 地址。切换 server-url 后,如果需要更新旧副本,应先将地址切回该副本的来源 Server。
如果你希望自己在服务器上搭建 Loci Server,并向其他人发布文档库,请阅读 Admin:部署与管理 Server。
浏览和下载文档库
loci cloud list
读取 Server 上公开的文档库目录,显示页面数、内容大小和短 ID,并标记每个文档库在本地是否已经存在或有可用更新。
公开目录不会显示 0 页文档库。旧版或异常 Server 如果返回空快照,CLI 会拒绝导入并保留已有本地副本;Server 暂时不可访问时,已经下载的内容仍可离线读取,不会被清空。
示例:
loci cloud pull [library]
将一个公开文档库下载为本地副本。[library] 可以是云端文档库名称、完整 ID 或唯一短 ID;在交互终端中省略时可以从云端目录选择。
示例:
下载时添加 --auto-sync 会同时开启每日自动同步:
下载后可以使用 loci document list、loci document tree、loci document search 和 loci document read 浏览副本内容。
当云端没有可用内容或拉取失败时,可以改用 loci source add <官方文档 URL> 创建本地抓取库。云端副本不会占用同域名的本地文档源位置,因此两者可以并存。
loci cloud update [library]
从最初下载快照的 Server 更新本地云端副本。该命令只适用于已经下载的云端文档库;在交互终端中省略 [library] 时可以从本地云端副本中选择。
示例:
loci cloud remove [library]
删除一个本地云端副本,不会影响 Server 上的原始文档库。CLI 默认会再次确认;只有在脚本中确认目标无误时才应使用 --yes 跳过确认。
示例:
loci cloud auto-sync [library] [state]
为已经下载的云端副本开启或关闭每日同步。脚本中使用 on 或 off;交互终端省略状态时会询问。
CLI 不会在普通命令结束后偷偷驻留。只有显式运行 loci schedule run 时,才会以前台常驻
方式执行云端每日检查;按 Ctrl+C 可停止。桌面端已经运行计划任务时,CLI 会拒绝启动第二个运行器。
需要自己从公开网站创建和抓取文档时,查看本地文档库。