Jelu完整指南如何从EPUB/OPF文件自动读取书籍元数据本地导入教程【免费下载链接】jeluSelf hosted read and to-read list book tracker项目地址: https://gitcode.com/gh_mirrors/je/jeluJelu 是一个自托管的读书与待读清单追踪工具。本教程带你使用 Jelu 本地导入功能从 EPUB 或 OPF 文件中一键自动读取书籍元数据告别手动填写书名、作者、ISBN 等繁琐信息。什么是书籍元数据为什么要自动导入每一本 EPUB 电子书内部都藏着一份身份信息——即元数据Metadata书名、作者、出版日期、出版社、语言、标签、丛书信息甚至 ISBN 条码号。OPF 文件则是 Calibre 等电子书管理软件常用的元数据描述格式。Jelu 的本地导入功能可以直接解析这些文件把信息自动填进你的书库✅ 书名与多位作者✅ ISBN-10 / ISBN-13自动校验格式合法性✅ 出版日期、出版社、语言✅ 简介、标签Subject 主题✅ 丛书名称及册序号Calibre series✅ Google / Amazon / Goodreads 外部 ID 解析逻辑位于 OpfParser.kt它会校验 ISBN 有效性并把用分号分隔的多位作者自动拆分为独立作者。导入入口两种获取文件的方式在添加图书界面选择从文件导入后Jelu 提供两种来源方式说明 从服务器读取直接浏览 Jelu 服务器上的目录树系统只显示.epub和.opf文件见 FileSystemController.kt 中的扩展名过滤逻辑 从电脑上传选择本地文件上传支持.opf、.epub含大写扩展名最快导入步骤5步完成EPUB导入打开添加图书在 Jelu 界面点击新增书籍选择从文件导入入口前端实现见 AutoImportFileModal.vue选择文件来源打开从服务器上传开关可直接挑选服务器上的书籍文件否则用本地文件选择器等待解析完成上传进度条走完即可文件解析在后端 FileMetadataService.kt 中完成核对预览结果确认书名、作者、标签等信息是否正确点击导入确认无误后点击导入不满意可点放弃重新选择Jelu 是如何读取 EPUB 文件的很多人好奇 EPUB 的元数据藏在哪里。原理其实很直观EPUB 文件本质是一个 ZIP 压缩包。Jelu 先读取包内的META-INF/container.xml从中找到 OPF 清单文件的真实路径rootfile标签再解析其中的metadata节点OPF 文件直接就是标准 XML 元数据文件无需解压步骤对应的 HTTP 接口在 MetadataController.ktPOST /api/v1/metadata/file—— 接收浏览器上传的文件GET /api/v1/metadata/file?filepath...—— 读取服务器上指定路径的文件解析出的字段结构与前端 Metadata.ts 模型一一对应保证预览界面能完整展示所有信息。导入后书籍自动进入你的书库导入成功后新书立刻出现在书架列表中封面、作者、丛书信息一应俱全可以直接标记在读、已读或放入待读清单。常见问题与实用技巧Q1为什么解析结果缺少某些字段OPF 中没写就不可能凭空生成。建议在导入前用 Calibre 补全书籍信息Jelu 会优先读取calibre:series等扩展字段。Q2支持哪些文件格式仅支持.epub和.opf大小写均可。其他格式如 MOBI、PDF 暂不支持可先在 Calibre 中转换。Q3多位作者会乱掉吗不会。OPF 中用分号;分隔的多位作者会被自动拆分见 OpfParser.kt 的splitValues方法每位作者独立建立档案。Q4ISBN 识别不了怎么办Jelu 内置 ISBN-10/13 校验器只接受合法编号带urn:isbn:前缀的值会自动清洗后再校验。Q5没有本地文件只有书名怎么办Jelu 还支持按 ISBN / 书名 / 作者在线抓取元数据可搭配 Calibre 的fetch-ebook-metadata或 Google Books 等插件见 CalibreMetadataProvider.kt前端表单见 AutoImportFormModal.vue甚至可以用摄像头扫描条码直接获取 ISBN。总结Jelu 的本地导入功能让书籍入库变得极其简单丢一个 EPUB 或 OPF 文件进去书名、作者、ISBN、丛书、标签等元数据全部自动就位。配合自托管部署你的书库数据完全掌握在自己手中是搭建私人阅读追踪系统的省心之选。【免费下载链接】jeluSelf hosted read and to-read list book tracker项目地址: https://gitcode.com/gh_mirrors/je/jelu创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Jelu完整指南：如何从EPUB/OPF文件自动读取书籍元数据（本地导入教程）
Jelu完整指南如何从EPUB/OPF文件自动读取书籍元数据本地导入教程【免费下载链接】jeluSelf hosted read and to-read list book tracker项目地址: https://gitcode.com/gh_mirrors/je/jeluJelu 是一个自托管的读书与待读清单追踪工具。本教程带你使用 Jelu 本地导入功能从 EPUB 或 OPF 文件中一键自动读取书籍元数据告别手动填写书名、作者、ISBN 等繁琐信息。什么是书籍元数据为什么要自动导入每一本 EPUB 电子书内部都藏着一份身份信息——即元数据Metadata书名、作者、出版日期、出版社、语言、标签、丛书信息甚至 ISBN 条码号。OPF 文件则是 Calibre 等电子书管理软件常用的元数据描述格式。Jelu 的本地导入功能可以直接解析这些文件把信息自动填进你的书库✅ 书名与多位作者✅ ISBN-10 / ISBN-13自动校验格式合法性✅ 出版日期、出版社、语言✅ 简介、标签Subject 主题✅ 丛书名称及册序号Calibre series✅ Google / Amazon / Goodreads 外部 ID 解析逻辑位于 OpfParser.kt它会校验 ISBN 有效性并把用分号分隔的多位作者自动拆分为独立作者。导入入口两种获取文件的方式在添加图书界面选择从文件导入后Jelu 提供两种来源方式说明 从服务器读取直接浏览 Jelu 服务器上的目录树系统只显示.epub和.opf文件见 FileSystemController.kt 中的扩展名过滤逻辑 从电脑上传选择本地文件上传支持.opf、.epub含大写扩展名最快导入步骤5步完成EPUB导入打开添加图书在 Jelu 界面点击新增书籍选择从文件导入入口前端实现见 AutoImportFileModal.vue选择文件来源打开从服务器上传开关可直接挑选服务器上的书籍文件否则用本地文件选择器等待解析完成上传进度条走完即可文件解析在后端 FileMetadataService.kt 中完成核对预览结果确认书名、作者、标签等信息是否正确点击导入确认无误后点击导入不满意可点放弃重新选择Jelu 是如何读取 EPUB 文件的很多人好奇 EPUB 的元数据藏在哪里。原理其实很直观EPUB 文件本质是一个 ZIP 压缩包。Jelu 先读取包内的META-INF/container.xml从中找到 OPF 清单文件的真实路径rootfile标签再解析其中的metadata节点OPF 文件直接就是标准 XML 元数据文件无需解压步骤对应的 HTTP 接口在 MetadataController.ktPOST /api/v1/metadata/file—— 接收浏览器上传的文件GET /api/v1/metadata/file?filepath...—— 读取服务器上指定路径的文件解析出的字段结构与前端 Metadata.ts 模型一一对应保证预览界面能完整展示所有信息。导入后书籍自动进入你的书库导入成功后新书立刻出现在书架列表中封面、作者、丛书信息一应俱全可以直接标记在读、已读或放入待读清单。常见问题与实用技巧Q1为什么解析结果缺少某些字段OPF 中没写就不可能凭空生成。建议在导入前用 Calibre 补全书籍信息Jelu 会优先读取calibre:series等扩展字段。Q2支持哪些文件格式仅支持.epub和.opf大小写均可。其他格式如 MOBI、PDF 暂不支持可先在 Calibre 中转换。Q3多位作者会乱掉吗不会。OPF 中用分号;分隔的多位作者会被自动拆分见 OpfParser.kt 的splitValues方法每位作者独立建立档案。Q4ISBN 识别不了怎么办Jelu 内置 ISBN-10/13 校验器只接受合法编号带urn:isbn:前缀的值会自动清洗后再校验。Q5没有本地文件只有书名怎么办Jelu 还支持按 ISBN / 书名 / 作者在线抓取元数据可搭配 Calibre 的fetch-ebook-metadata或 Google Books 等插件见 CalibreMetadataProvider.kt前端表单见 AutoImportFormModal.vue甚至可以用摄像头扫描条码直接获取 ISBN。总结Jelu 的本地导入功能让书籍入库变得极其简单丢一个 EPUB 或 OPF 文件进去书名、作者、ISBN、丛书、标签等元数据全部自动就位。配合自托管部署你的书库数据完全掌握在自己手中是搭建私人阅读追踪系统的省心之选。【免费下载链接】jeluSelf hosted read and to-read list book tracker项目地址: https://gitcode.com/gh_mirrors/je/jelu创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考