Manga Translator UI替换规则与富文本规则：完整指南，YAML、正则与自动套用样式清单

Manga Translator UI替换规则与富文本规则完整指南YAML、正则与自动套用样式清单【免费下载链接】manga-translator-ui基于manga-image-translator 实现的开源漫画AI翻译桌面工具。支持日、韩、英文漫画自动处理集成OpenAl、Gemini等多翻译引擎实现OCR文字检测、原文擦除、AI翻译、图像修复、译文排版完整链路自带可视化编辑器支持自定义文本样式一键部署开箱即用。项目地址: https://gitcode.com/gh_mirrors/man/manga-translator-uiManga Translator UI 是一款基于 manga-image-translator 的开源漫画AI翻译桌面工具支持日、韩、英文漫画的 OCR 检测、原文擦除、AI 翻译与译文排版。本文聚焦其中的替换规则与富文本规则两套规则都以 YAML 文件保存配合正则匹配让标点统一、颜色强调、注音、纵中横等样式自动套用到译文中无需逐条手工编辑。替换规则与富文本规则先弄清执行顺序两套规则在渲染管线中的位置是固定的属性→ 2.文本替换text_replacements.yaml→ 3.断句排版→ 4.富文本规则rich_text_rules.yaml也就是说替换规则先改写译文文字富文本规则再对替换后的译文匹配并追加样式。顺序颠倒例如把改文字的样式写在替换前不会生效这就是很多新手规则不生效的根源。核心实现分别位于 text_replacements.py 与 rich_text.py。一键上手替换规则表格视图 5 步搞定在左侧主导航打开替换规则页副标题会提示执行顺序通用始终执行→ 横排/竖排规则由上到下级联替换。三个分组页签通用、横排、竖排通用common始终执行适合全局标点规范横排horizontal仅当区域按横排渲染时执行竖排vertical仅当区域按竖排渲染时执行。日语竖排漫画中常见的。、、等特殊字形替换适合放在竖排组。下面这张日文原图就包含大量竖排文本框正是竖排分组的典型使用场景规则字段清单表格 5 列对应 5 个字段字段必填说明匹配pattern是要查找的文字开启正则时按 Pythonre语法解析替换replace是替换内容可为空相当于删除正则模式支持\1反向引用正则regex否默认✗字面替换双击切换为✓启用正则启用enabled否✗时整行跳过但保留在文件中随时可恢复备注comment否仅供展示与筛选不参与匹配正则开关与级联执行要点字面替换模式下pattern中的.、(、\等会被自动转义无需手动转义正则模式下支持\d、捕获组与反向引用语法写错只会跳过这一条并记录警告不会让渲染失败同组内规则从上到下级联执行先写A→B、再写B→C最终A会变成C调换顺序结果就不同所以请用↑/↓按钮认真管理顺序。YAML 源码编辑与自动保存机制表格视图和源码编辑编辑的是同一个文件路径为config/text_replacements.yaml不在仓库内首次启动时由 runtime_files.py 自动创建内置默认模板。一份最小规则长这样common: - pattern: replace: ( - pattern: \\s$ replace: regex: true comment: 去掉行尾多余空格 vertical: - pattern: 。 replace: 保存机制对新手很友好任何编辑动作都会触发600ms 防抖自动保存状态栏出现●表示有未保存修改保存成功后显示已自动保存源码编辑模式会先做 YAML 语法校验语法错误时状态栏提示YAML 语法错误修改尚未保存文件保持上次成功写入的内容写成功后会自动清空渲染缓存下一次渲染立即读取新规则恢复默认会弹确认框并覆盖内置模板没有备份点击前请先确认自定义规则不再需要。富文本规则自动套用样式完整清单替换规则只管改字富文本规则负责上样式在文字替换完成后匹配译文只追加尚未设置的样式字段不改动文字本身。规则保存在config/rich_text_rules.yaml页面操作与替换规则页几乎一致三组页签 五列表格 源码编辑。创建一条富文本规则的步骤打开富文本规则页在对应分组点击添加规则在匹配列输入要命中的文字可开正则零宽命中会被忽略点击富文本编辑列的样式按钮打开编辑富文本样式对话框只勾选本条规则需要追加的字段未勾选的字段不会写入确定后自动保存。已有手工样式始终保留不会被自动规则覆盖只补缺、不覆盖。编辑器内的浮动富文本面板与规则页共享同一套样式字段快捷按钮如下样式字段对照清单按钮缩写速查缩写字段缩写字段B加粗C文字颜色I斜体S绝对字号U下划线%字号倍率ST删除线F字体D着重号O / OS描边 / 外描边FA强制推进半格/全格G发光K / PK字后 / 字前间距LK / NK与前一行 / 与后一行间距XY / Rot水平垂直偏移 / 局部旋转R / T注音 / 纵中横注音Ruby命中区间被整段包装为注音节点注音渲染在字符旁注音与纵中横互斥注音优先纵中横TCY竖排中让??、!!这类符号横排显示只在竖排组生效局部旋转常用于竖排中没有专用字形的符号内置示例即rotation: -90。复用预设一次保存处处载入在编辑器浮动富文本面板中选中一段已排好样式的文字点保存样式预设会存入app.saved_rich_text_presets之后在富文本规则页的已保存富文本样式下拉框中选择名称即可一次性载入全部字段再微调。预设与规则是两套独立存储载入预设只是填字段不会自动创建新规则。相关源码见 rich_text_rules.py 与 rich_text_sync.py。常见疑问与注意事项规则为什么不生效先检查顺序替换必须先于样式、enabled是否为✓、方向组是否放对横排规则不会命中竖排区域。为什么手工改的样式没被规则覆盖自动规则是只补缺策略编辑器打字场景更是skip策略命中区间带手工痕迹会整段跳过手工样式永远不会被顶回来。正则写错了会崩吗不会。编译失败的单条规则被跳过并写 warning 日志其余规则照常执行。换行标记会被替换误伤吗不会。[BR]、【BR】、br等标记在替换前被占位保护、替换后恢复。不要把 API Key、用户名、私有路径写进规则备注——规则文件可能出现在日志与调试产物中。相关文件资料速查官方中文 Wiki替换规则表分组、顺序与匹配逻辑、替换规则的 Raw YAML 编辑、正则与保存富文本规则 Wiki富文本规则表、Raw 编辑与匹配逻辑、富文本样式与预设替换引擎源码text_replacements.py富文本渲染源码rich_text.py、rich_text_rules.py运行时文件初始化默认模板创建与升级runtime_files.py界面实现replacements_page.py、rich_text_rules_page.py、rich_text_rules_editor.py掌握先替换、后样式的固定顺序和三组页签再配合这份字段清单你就可以把重复的排版工作一次性沉淀成 YAML 规则让 Manga Translator UI 自动完成。【免费下载链接】manga-translator-ui基于manga-image-translator 实现的开源漫画AI翻译桌面工具。支持日、韩、英文漫画自动处理集成OpenAl、Gemini等多翻译引擎实现OCR文字检测、原文擦除、AI翻译、图像修复、译文排版完整链路自带可视化编辑器支持自定义文本样式一键部署开箱即用。项目地址: https://gitcode.com/gh_mirrors/man/manga-translator-ui创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考