4v5u09Z5a4Yuc/ReadViewSDK
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: EPUB阅读器搜索、注释、CFI模块及大书远距跳转优化

Browse Source 
- 实现EPUB阅读器搜索功能及选中注释功能
- 优化CFI模块，修复代码审查发现的11个问题
- 实现大书远距目录跳转与后台补全优化方案
- 优化设置面板与章节运行时联动
- 重构及大量改进优化
This commit is contained in:
shenlei
2026-06-22 20:26:34 +08:00
parent f50495ad91
commit c65c190b71
178 changed files with 11380 additions and 6728 deletions
Download Patch File Download Diff File Expand all files Collapse all files
Sources/RDReaderView/EPUBTextRendering/RDPlainTextBookBuilder.swift
+1 -30
View File
@@ -1,16 +1,5 @@
import UIKit
/// 纯文本书籍构建器：将 TXT 文件构建为 RDEPUBTextBook，复用 EPUB 文本渲染和分页管线。
///
/// 本类将纯文本文件（.txt）转换为与 EPUB 相同的分页书籍模型，
/// 使得纯文本阅读器可以复用 EPUBReader 的分页、导航、搜索等全部功能。
///
/// 处理流程：
/// 1. 解码文本文件（UTF-8 → GB18030 → GBK 兼容编码）
/// 2. 按中文章节正则拆分为多个章节
/// 3. 将纯文本包装为 HTML 段落
/// 4. 通过渲染器（DTCoreText）渲染为富文本
/// 5. CoreText 分页 → RDEPUBTextBook
public final class RDPlainTextBookBuilder {
private let renderer: RDEPUBTextRenderer
private let layoutConfig: RDEPUBTextLayoutConfig
@@ -23,13 +12,6 @@ public final class RDPlainTextBookBuilder {
self.layoutConfig = layoutConfig
}
/// 从纯文本文件构建分页书籍。
///
/// - Parameters:
/// - textFileURL: 纯文本文件的本地 URL
/// - pageSize: 页面尺寸
/// - style: 渲染样式（字体、行距、颜色）
/// - Returns: 分页后的书籍模型
public func build(
textFileURL: URL,
pageSize: CGSize,
@@ -109,6 +91,7 @@ public final class RDPlainTextBookBuilder {
title: spec.title ?? "第 \(index + 1) 章",
attributedContent: chapterAttributedContent,
fragmentOffsets: [:],
cfiMap: nil,
pageBreakReasons: pages.map { $0.metadata.breakReason },
pages: pages
)
@@ -119,16 +102,11 @@ public final class RDPlainTextBookBuilder {
return RDEPUBTextBook(chapters: chapters, pages: flatPages)
}
// MARK: - 章节拆分
/// 章节规格：标题 + 内容
private struct ChapterSpec {
let title: String?
let content: String
}
/// 按中文章节正则拆分文本。匹配 "第X章/节/回/卷" 格式，
/// 无匹配时将整篇文本作为一章处理。
private func splitChapters(from text: String) -> [ChapterSpec] {
let pattern = #"^(第[零一二三四五六七八九十百千万\d]+[章节回卷].*)$"#
guard let regex = try? NSRegularExpression(pattern: pattern, options: [.anchorsMatchLines]) else {
@@ -154,25 +132,18 @@ public final class RDPlainTextBookBuilder {
}
}
// 拆分结果为空（所有章节内容为空），整体作为一章
if specs.isEmpty {
return [ChapterSpec(title: nil, content: text)]
}
return specs
}
// MARK: - HTML 包装
/// 将纯文本包装为 HTML 段落：每行一个 `<p>` 标签
private func wrapTextAsHTML(_ text: String) -> String {
let paragraphs = text.components(separatedBy: "\n").filter { !$0.isEmpty }
let body = paragraphs.map { "<p>\($0)</p>" }.joined(separator: "\n")
return "<html><body>\(body)</body></html>"
}
// MARK: - 文本解码
/// 解码文本文件，按优先级尝试 UTF-8 → GB18030 → GBK 编码
private func rd_decodeTextFile(url: URL) -> String {
if let content = try? NSString(contentsOf: url, encoding: String.Encoding.utf8.rawValue) as String {
return content