用途:在不放弃本地编辑器(VS Code、Neovim、Emacs)的前提下,把 Overleaf 作为协作与编译中心,实现混合工作流。
主要能力:三种集成方式。一是官方 Git 桥接,仅付费版与 Server Pro 提供,每个项目暴露为 Git 仓库,用 git clone/pull/push 同步。二是开源 overleaf-sync(pip install overleaf-sync),支持免费账号,命令包括 ols login、ols list、ols download、ols upload、ols sync。三是直接 API 交互。还包含自动化:从 Zotero(经 Better BibTeX)自动导出参考文献 bib、用脚本重新生成图表、通过 GitHub Actions 的 texlive 容器做 CI 编译并上传 PDF 制品。
使用方式:Git 桥接克隆后配置好远端,日常先 git pull、本地改、git add/commit/push;遇冲突按 <<<<<<< 标记解决并确认可编译。免费账号用 ols 系列命令做下载、上传、双向同步。建议目录结构分 sections、figures、tables、references.bib、custom.sty、scripts 等,并用 .gitignore 排除 aux、bbl、log 等构建产物与本地脚本。编辑器可配 LaTeX Workshop 或 VimTeX。
限制:Git 桥接需付费;overleaf-sync 可用于免费计划;本地与 Overleaf 的 TeX Live 版本可能不同(文中称 Overleaf 使用 TeX Live 2024),编译结果可能有差异;存在 API 速率限制;二进制图片易造成大 diff。上述命令与配置需原样执行,具体账号、价格与可用性以官方为准。