云盘同步 #

云盘同步会把 TeXPage 项目保存一份到你自己的云盘里。你在网页上的修改会自动同步到云盘；你在云盘里修改的文件，也可以手动拉取回网页。

支持的云盘：Dropbox、OneDrive、Google Drive、百度网盘，以及任何支持 WebDAV 的网盘或服务器。

云盘同步是付费功能，升级账号后即可使用。

快速上手 #

1. 关联云盘：在控制台打开「我的账号 → 云盘同步」，选择要使用的云盘，点击「关联」完成授权。WebDAV 需要填写服务器地址、用户名和密码。可以同时关联多个云盘。
2. 开启同步：打开项目，点击顶部的「同步 → 云盘」，打开「云盘同步」开关。
3. 等待首次同步：开启后，TeXPage 会把项目的所有版本完整上传到每个已关联的云盘。文件较多时需要几分钟。

如果希望新建的项目自动开启云盘同步，可以在「我的账号 → 云盘同步」里打开「默认开启云盘同步」。

项目在云盘的什么位置 #

每个项目在云盘里是一个文件夹，名称为「项目名 (项目编号)」，项目的每个版本是其中的一个子文件夹。同步对话框里的「云盘文件夹」会显示这个名称。

例如，项目「毕业论文」的 main 版本在 Dropbox 中的位置是：

/Apps/TeXPage/毕业论文 (项目编号)/main/

请不要修改项目文件夹和版本文件夹的名称，TeXPage 依靠这两个名称找到云盘中的项目。

从网页到云盘：自动同步 #

在网页上新建、修改、删除、重命名文件，或者新建、删除版本，变化都会在几秒内自动同步到云盘，不需要任何操作。

不会覆盖你在云盘里的修改 #

如果某个文件你在云盘里改过、还没拉取回网页，网页的修改不会覆盖它：

• 网页修改了这个文件：云盘中的版本保持不变。
• 网页删除了这个文件：云盘中的文件会保留。

下次拉取时，这些文件会作为「冲突」列出来，由你决定保留哪一边。

从云盘到网页：拉取更新 #

在云盘里修改了文件之后，需要手动把修改拉取回网页：

1. 打开项目，点击「同步 → 云盘」。
2. 如果关联了多个云盘，先选择要拉取的云盘。
3. 点击「拉取更新」。

拉取只作用于当前打开的版本。云盘中的新文件会添加到网页，修改过的文件会更新，删除的文件也会在网页上删除。

什么是冲突 #

如果一个文件自上次同步后，在网页和云盘里都被改过，TeXPage 无法判断应该保留哪一边，这次拉取就会停下来，什么都不修改，并列出这些文件。你可以：

• 先处理再拉取：把需要保留的修改手动合并到一边，再拉取一次。
• 使用云盘的内容：点击「使用云盘的内容」，用云盘中的版本覆盖网页上的修改。

两边改成了完全相同的内容，不算冲突。

拉取进行的同时，如果有协作者正在网页上编辑某个文件，这个文件会留到下一次拉取，不会覆盖协作者正在写的内容。

哪些文件不会被拉取 #

以下文件会被跳过，拉取完成后会列出它们的名称：

• 文件名包含网页不支持的字符，例如 : * ? " < > |
• 文件超过 200 MB
• 文本文件不是 UTF-8 编码（例如 GBK）。请先在本地另存为 UTF-8。
• 云盘的在线文档，例如 Google 文档、OneNote 笔记本，以及快捷方式
• 与网页上已有的文件夹同名，或位于网页上某个文件的「下面」
• 名称只有大小写不同的两个文件（例如 Main.tex 和 main.tex）

另外，.git 文件夹、.DS_Store、Thumbs.db、desktop.ini 等系统文件会被直接忽略，不会提示。

首次拉取：先覆盖云盘 #

拉取需要知道每个文件「上次同步时是什么内容」，才能判断是哪一边做了修改。新开启同步的项目在首次同步完成后会自动记录这些信息。

在双向同步推出之前就已开启同步的项目，没有这份记录。第一次点击「拉取更新」时会看到提示：

需要先用网页内容完整覆盖云盘，才能拉取更新。

点击「覆盖云盘」后，TeXPage 会把项目的所有版本重新上传到这个云盘，云盘中对应的文件会被网页上的内容覆盖。完成后就可以正常拉取了。

• 如果你在云盘里有还没同步回网页的修改，请先把这些文件备份到其他位置，再点击「覆盖云盘」。
• 如果不点击，项目会继续保持单向同步：网页的修改照常同步到云盘，但无法从云盘拉取。
• 覆盖进行中时无法拉取，完成后再试即可。

常见问题 #

拉取提示「当前版本在云盘中的文件夹还不存在」

这个版本还没有同步到云盘。刚开启同步或刚新建版本时，请等几分钟再试。

我在云盘里误删了整个项目文件夹，会怎样？

下次在网页上修改任意文件时，TeXPage 发现云盘中的项目文件夹不见了，会自动把整个项目重新完整上传一遍。你也可以关闭再重新开启云盘同步。

关闭云盘同步后，云盘里的文件会怎样？

关闭项目的云盘同步后，云盘里的项目文件夹会被删除。网页上的项目不受影响。

重新关联云盘，或者换了一个账号，会怎样？

之前的同步记录会被清除。之后第一次拉取时，会提示先覆盖云盘，请参考「首次拉取：先覆盖云盘」。

协作者也能同步到自己的云盘吗？

可以。每位成员都可以在自己的账号下关联云盘，并为这个项目开启云盘同步，项目会同步到各自的云盘。拉取时，只会读取你自己云盘里的副本，并且需要你对项目有编辑权限。

为什么文件内容和我上传的不完全一样？

TeXPage 会把文本文件统一保存为 UTF-8 编码、LF 换行。从 Windows 拉取的文件，换行符会被转换，这不影响内容和编译。

某个云盘拉取比其他云盘慢？

不同云盘列出文件的方式不同。OneDrive、Google Drive 和 WebDAV 需要逐个文件夹读取，文件夹较多时会比 Dropbox 和百度网盘慢一些。