您的内容不受限制。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 导入不同,但遵循相同的单向源到副本模型。
当前限制
导入是异步的;资源在同步工作器认领并完成排队作业后出现。
同步模式的刷新取决于源报告的内容:没有可靠修改时间戳的源可能会在每个间隔重新导入。
导出以文档为中心。表格、构件和文件有各自的交互界面。
图片导出依赖于浏览器渲染,可能需要编辑器内容可见。
