跳到主要内容

Book reader

用于在 ONLYOFFICE Apps 专用阅读查看器中查看 EPUB、FB2 和 ZIP 文件的工具。

Book readerBook reader

安装​

默认在 ONLYOFFICE Apps SaaS 解决方案中可用。

您可以按照此处的说明启用它。

配置​

要开始使用该插件，您无需更改默认设置。

如需查看插件元数据（例如作者、版本、状态、主页和描述），请前往设置 → 集成 → 插件，然后点击 book-reader 插件旁的 设置图标设置图标。

使用​

该插件支持以下文件格式：

  • .epub：Electronic Publication（EPUB 2.0/3.0）
  • .fb2：FictionBook 2.0
  • .zip：包含 EPUB 或 FB2 文件的压缩包

在阅读器中打开文件：

  1. 打开文档部分或某个可用房间。

  2. 点击受支持的文件，或右键点击它，打开更多选项下拉菜单，然后选择在阅读器中打开。

    在阅读器中打开文件在阅读器中打开文件

  3. 文件会在模态窗口中打开。

使用底部的 ‹ 和 › 按钮在页面之间导航。进度条和页码计数器会显示您当前在书中的位置。

ZIP 文件​

ZIP 文件无法通过单击打开——因为 ONLYOFFICE Apps 有专门的压缩包插件处理 .zip 文件类型，图书阅读器仅通过上下文菜单打开 ZIP 文件（右键点击 → 在阅读器中打开）。

打开 ZIP 文件时，插件会检查其内容：

  • 找到一个受支持的文件（单个 .epub、.fb2，或带有 META-INF/container.xml 的原始 EPUB 结构）：文件会被提取并自动在阅读器中打开。
  • 找到多个受支持的文件：插件会先检查是否存在原始 EPUB 结构（META-INF/container.xml），然后查找任意 .epub 文件，再查找任意 .fb2 文件，并打开第一个匹配项——无论文件顺序如何，EPUB 内容始终优先于 FB2。
  • 未找到受支持的文件：显示错误通知，并且不会打开阅读器。

插件结构​

GitHub 仓库：reader。

所有必需文件在此处说明。

接口​

使用以下插件接口：

  • IPlugin。每个插件都需要。它包含插件 status（PluginStatus）变量，用于将插件嵌入 ONLYOFFICE Apps。
  • IContextMenuPlugin 和 IContextMenuItem。用于实现上下文菜单操作。该插件会为受支持的文件（.epub、.fb2、.zip）添加在阅读器中打开项目。
  • IFilePlugin 和 IFileItem。用于与指定的文件类型交互。支持直接从文件列表单击打开文件。

支持​

如需请求功能或报告与此插件相关的错误，请使用 GitHub 上的 issues 部分。