Legado书源规则编写终极指南：从零基础到精通的全流程教程

想要在Legado阅读器中畅享海量网络小说资源吗？掌握书源规则编写技能，你就能打造专属的阅读宝库！本指南将带你从完全不懂到独立编写书源规则，享受自由获取阅读内容的乐趣。

【免费下载链接】legadoLegado 3.0 Book Reader with powerful controls & full functions❤️阅读3.0, 阅读是一款可以自定义来源阅读网络内容的工具，为广大网络文学爱好者提供一种方便、快捷舒适的试读体验。项目地址: https://gitcode.com/gh_mirrors/le/legado

🎯 新手快速上手方法

Legado书源规则本质上是一套JSON格式的配置文件，它告诉阅读器如何从特定网站获取书籍信息。就像给浏览器添加书签一样简单，但功能强大得多！

书源规则是什么？

想象一下，你有一把通用工具，可以打开不同网站的内容宝库。Legado书源规则就是这样一套工具，它包含：

• 基本信息：书源名称、网址、类型
• 搜索规则：如何查找书籍
• 目录规则：如何获取章节列表
• 内容规则：如何提取正文内容

📝 零基础配置步骤

第一步：了解基本结构

每个书源规则都包含几个核心部分，就像搭积木一样简单：

{ "bookSourceName": "你的书源名称", "bookSourceUrl": "https://example.com", "searchUrl": "https://example.com/search?q={{searchKey}}", "ruleSearch": { "bookList": "书籍列表路径", "name": "书名路径", "author": "作者路径" }

第二步：填写基本信息

在官方文档README.md中，你可以找到详细的字段说明。关键字段包括：

• bookSourceName：给你的书源起个好记的名字
• bookSourceUrl：目标网站的地址
• bookSourceType：0为文本，1为音频，2为图片

第三步：配置搜索规则

搜索规则定义了如何从搜索结果中提取书籍信息：

"ruleSearch": { "bookList": "$.data.books", "name": "$.title", "author": "$.author", "coverUrl": "$.cover", "bookUrl": "$.id" }

🔧 实战演练：编写你的第一个书源

准备工作

首先，你需要获取项目代码：

git clone https://gitcode.com/gh_mirrors/le/legado

选择目标网站

建议从结构简单的网站开始练习，比如一些小说网站的API接口。查看app/src/main/assets/defaultData/bookSources.json文件，里面有大量现成案例可以参考学习。

编写步骤分解

1. 观察网站结构：用浏览器开发者工具查看网络请求
2. 确定JSON路径：找到书籍信息的正确位置
3. 填写规则字段：按照模板填写对应路径
4. 测试验证：在Legado中测试书源是否正常工作

💡 实用技巧与注意事项

常见问题解决

• 规则不生效：检查JSON格式是否正确，路径是否匹配
• 搜索无结果：确认搜索URL格式和参数
• 内容显示异常：检查内容提取路径

调试方法

当书源规则出现问题时，可以：

1. 检查应用内的日志信息
2. 使用调试工具逐步排查
3. 参考app/src/main/java/io/legado/app/data/entities/BookSource.kt中的字段定义

🚀 进阶学习路径

掌握JavaScript增强功能

Legado支持在规则中嵌入JavaScript代码，实现更复杂的数据处理。比如：

"coverUrl": "$.cover@js:处理图片URL的逻辑"

处理特殊场景

• 登录验证：配置登录规则字段
• 反爬机制：添加适当的请求头或延迟
• 图片处理：使用coverDecodeJs字段配置解码逻辑

📚 学习资源推荐

官方文档

• 项目根目录的README.md文件
• api.md中的API接口说明
• CHANGELOG.md中的更新日志

实践建议

• 从修改现有书源开始
• 逐步尝试编写简单书源
• 多参考社区分享的优秀案例

✨ 总结与展望

通过本指南的学习，你已经掌握了Legado书源规则编写的基本方法。记住，实践是最好的老师，多动手尝试，你很快就能成为书源编写高手！

Legado的强大之处在于它的自定义性，通过书源规则，你可以：

• 自由获取任何网站的内容
• 打造个性化的阅读体验
• 享受无广告、高质量的阅读环境

现在就开始你的书源编写之旅吧！从简单的网站开始，逐步挑战更复杂的结构，你会发现，原来获取阅读资源可以如此简单有趣！

记住：每个成功的书源都是从第一个不完美的尝试开始的。勇敢迈出第一步，你离打造专属阅读宝库就更近了一步！📖✨

【免费下载链接】legadoLegado 3.0 Book Reader with powerful controls & full functions❤️阅读3.0, 阅读是一款可以自定义来源阅读网络内容的工具，为广大网络文学爱好者提供一种方便、快捷舒适的试读体验。项目地址: https://gitcode.com/gh_mirrors/le/legado