Skip to main content

​
如何开始导入

在浏览器中打开 docs.craft.do/import/quip，如果尚未登录，请登录你的 Craft 账户。

​
获取你的 Quip 访问令牌

Craft 通过你自行生成的个人访问令牌连接 Quip。
1

打开 Quip 的令牌页面

在登录你要导入内容的那个 Quip 账户后，访问 quip.com/dev/token。
2

生成并复制令牌

点击 Get Personal Access Token，然后复制显示出来的令牌。
访问令牌拥有你 Quip 账户中所有内容的完整权限。请勿分享，也不要发布到任何公开场合。
该令牌让 Craft 能够访问你的 Quip 账户可见的全部内容——你的私人文档，以及你参与的共享文件夹和群组文件夹。你无需逐个文档授权。

​
导入你的文档

1

粘贴访问令牌

把令牌粘贴到导入页面的输入框中。
2

选择目标位置

选择你希望 Quip 文档出现在其中的 Craft Space。你也可以选择一个目标文件夹，把导入的内容集中放在一起。
3

配置选项

如有需要，可打开包含评论，把 Quip 的评论与文档一起导入。
4

开始导入

点击 Import。导入过程中会显示进度条。你可以随时关闭页面——导入会在后台继续。
Quip 会限制读取数据的速度。如果你的账户较大，导入会自动暂停并继续，直到全部内容传输完毕——几百个文档可能需要十五分钟甚至更久。你不需要一直开着页面。

​
导入完成后

完成后你会看到一条确认信息，其中的按钮可以带你进入 Craft，在那里找到导入的文档。

​
Craft 未能带过来的内容

Quip 中有些内容在 Craft 里没有对应形式，偶尔也会有文件下载不成功。为了不让你自己去发现这些情况，Craft 会在导入结束后列出所有未能完整带过来的内容，并附上受影响的文档，方便你逐一查看。 你可能会看到以下几类：
  • 未能导入的文档——聊天和幻灯片，或 Quip 未返回的文档。
  • 未能下载的图片或附件——文档已导入，但不包含这些内容。
  • 以表格形式导入的 Live App——内容仍在，但不再可交互。
  • 未能导入的评论——文档导入时不包含评论。
  • 评论中的附件——评论正文已带过来，附加的文件没有。
  • 丢失了位置的评论——它们关联到整个文档，而不是原本所指的那段文字。
出现这样的汇总是正常的，账户较大时尤其如此，而且你的文档已经在 Craft 中了。它的作用是告诉你需要查看哪些内容，而不是提示出了问题。
未被导入的聊天或幻灯片在 Craft 中没有对应文档可打开，因此只会显示名称。其余条目都会直接链接到导入后的文档。

​
会被带过来的内容

标题、加粗、斜体、删除线、行内代码、链接、高亮、项目符号与编号列表、待办清单、表格、代码块、分隔线和引用。Quip 有下划线而 Craft 没有，因此带下划线的文字会以浅灰色高亮的形式导入——强调效果得以保留，尽管样式并不完全相同。
你的文件夹结构会在 Craft 中重建，你在 Quip 中加过星标的文档导入后同样带有星标。在 Quip 中，一个文档可以同时位于多个文件夹。Craft 会把每个文档放进其中一个，因此导入的文档会落在最先找到它的那个文件夹里。空文件夹不会被重建。
图片和附件会被下载并重新上传到 Craft，因此导入后仍可正常使用——它们不是指回 Quip 的链接。
Quip 电子表格会转换为 Craft 表格，可以直接查看和编辑。原始的 .xlsx 文件也会作为附件附在文档上，因此原件的内容不会有任何损失。
它们会转换为 Craft 集合，你的列会成为状态属性，每张卡片保留各自的状态。列的颜色也会一并保留。
指向其他 Quip 文档和文件夹的链接与提及，会被改写为指向导入后的 Craft 版本，因此内部链接仍然有效。指向未包含在本次导入中的文档的链接，仍会指向 Quip。
Quip 中的日期提及会转换为真正的 Craft 日期，而不是纯文本。
如果启用包含评论，评论及其回复会连同原始作者名称和时间一起导入，并锚定在其所针对的文字上。

​
限制

以下大多数情况会在导入后的汇总中列出，让你知道哪些文档受到影响。下方标注的两项不会提示，因为对 Craft 来说并没有缺失任何内容。
  • 聊天和幻灯片不会被导入。 Craft 对这两者都没有对应形式，因此 Quip 的对话和演示文稿会被跳过。文档和电子表格会被导入。
  • 除看板和 Project Tracker 之外的 Live App（例如日历）会以展示其内容的普通表格形式导入。信息仍在，但不再可交互。
  • 评论中的附件不会被导入。 评论正文仍会带过来，附加的文件不会。
  • 部分评论可能丢失位置。 如果某条评论所针对的文字在 Quip 的导出内容中已不存在，该评论会锚定到整个文档，而不是那段文字。内容不会丢失，但可能不在你预期的位置。
  • 模板会作为普通文档导入（不会提示）。Quip 模板会成为普通的 Craft 文档，而不是 Craft 模板。全部内容都在，只是没有被设置为模板。
  • Quip 回收站中的文档不会被导入（不会提示）。Craft 只能看到你的 Quip 账户中位于回收站之外的文档。
导入只会从 Quip 读取数据。你 Quip 账户中的任何内容都不会被移动、编辑或删除，因此你可以照常使用，并在需要时重新导入。

​
疑难解答

请确认你从 quip.com/dev/token 完整复制了整个令牌。如果你不确定粘贴的令牌是否是当前的令牌，请重新打开该页面并复制上面显示的令牌。
这表示令牌本身有效，但 Craft 通过它没有看到任何文档。请确认你是在登录正确的 Quip 账户时生成令牌的——如果你有多个账户，很容易为错误的账户创建令牌。
这通常是 Quip 的速率限制所致，而不是出了问题。导入会自动暂停并继续，关闭页面后也会继续运行。账户较大时可能需要一段时间。
位于多个 Quip 文件夹中的文档会被放入最先找到的那个文件夹，因此可能不在你预期的位置。如果某个文档完全找不到，请确认它是否是不会被导入的聊天或幻灯片，以及它是否在 Quip 的回收站中。
请尝试重新开始导入。已经导入的文档不会重复。如果问题仍然存在，请联系支持团队。