Dokki Docs logo

导入和导出

您的内容不受限制。Dokki支持从编辑器导出文档,并通过工作区连接从九个外部来源导入。

视觉指南

导出格式

文档导出对话框支持五种格式:

  • PDF — 从文档内容渲染,延迟加载嵌入式CJK字体以更好地输出中文/日文/韩文。

  • Markdown — 纯文本,尽可能保留Markdown格式。

  • Text — 纯文本,无格式。

  • Word文档 (.docx) — 从文档结构生成的Microsoft Word格式。

  • 图片 (.jpg) — 将可见的编辑器内容捕获为JPEG图片。此选项需要在浏览器中打开文档编辑器。

导出源

当编辑器可用时,导出使用实时编辑器内容。当编辑器不可用时,Dokki会尽可能回退到持久化的文档JSON和资源标题。

从外部来源导入

导入对话框支持九个来源:Google Drive、Notion、Linear、Confluence、SharePoint、OneDrive、钉钉、飞书 / Lark 和企业微信。Google Drive、Notion、Linear、Confluence、SharePoint 和 OneDrive 可以通过 OAuth 连接;Notion 和其他来源也接受 API 令牌,而钉钉、飞书 / Lark 和企业微信是基于令牌的。每个来源都支持导入整个可读范围,而不仅仅是单个项目。

在工作区管理员连接来源后,管理员和编辑者可以选择要导入的内容——Google Drive 使用 Google 文件选择器,而其他来源则使用项目 URL 或 ID——并将导入作业排队到所选文件夹中。

创建的内容

每个选中的项目会变成一个 sync_connections 作业,在工作器运行后,变成一个 Dokki 资源。类似页面的内容——Notion 页面、Confluence 页面、Linear 问题和文档、钉钉/飞书/企业微信文档——会被转换为 Markdown 并以原生 Dokki 文档的形式进行更新或插入。对于 Google Drive:

  • Google 文档被导出为 Markdown 并以原生 Dokki 文档的形式进行更新或插入。

  • Google 表格被导出为 CSV 并存储为文件资源。

  • Google 幻灯片被导出为 PDF 并存储为文件资源。

  • 其他 Drive 文件在符合配置的文件大小限制时被下载并存储为文件资源。

文件导入会放在工作区存储的导入路径下,并符合文件索引条件。重新导入或同步的文件资源会覆盖已存储的对象,并再次将索引标记为待处理。

一次性导入与同步

  • 一次性导入会将一个运行一次后保持完成的作业排队。

  • 同步模式会将相同的导入作业排队,但会按照工作器的同步间隔使作业再次到期。

  • 同步是单向的:从外部源到 Dokki 副本。编辑 Dokki 副本不会将更改写回 Google Drive。

  • 当 Google Drive 报告与上次成功运行相同的修改时间戳时,同步作业会跳过工作。

连接必须属于同一工作区,必须与导入的提供者匹配,并且必须仍然获得授权。导入需要目标工作区中的管理员或编辑者角色。

工作区到工作区的同步

Dokki 还有一个内部工作区同步适配器,用于在复制资源时保持从原始源刷新。这与外部的 Google Drive 导入不同,但遵循相同的单向源到副本模型。

当前限制

  • 导入是异步的;资源在同步工作器认领并完成排队作业后出现。

  • 同步模式的刷新取决于源报告的内容:没有可靠修改时间戳的源可能会在每个间隔重新导入。

  • 导出以文档为中心。表格、构件和文件有各自的交互界面。

  • 图片导出依赖于浏览器渲染,可能需要编辑器内容可见。