GoldenDict-ng 词典软件中词头显示的统一化探讨

背景介绍

GoldenDict-ng 作为一款开源的词典软件，支持多种词典格式，包括 DSL、StarDict 和 MDX 等。在实际使用过程中，不同格式词典的词头(headword)显示方式存在差异，这给用户带来了一定的困扰。

当前词头显示现状分析

目前 GoldenDict-ng 对不同格式词典的词头处理方式如下：

1. DSL 格式词典
   词头以特定 HTML 结构显示在文章开头：

   <div class="dsl_headwords"><p>appear</p></div>
   

2. StarDict 格式词典
   词头使用 h3 标签显示：

   <h3 class="sdct_headwords">appear</h3>
   

3. MDX 格式词典
   软件默认不添加词头显示，完全依赖词典文件自身的内容。

问题核心

这种不一致性在以下场景中尤为明显：

• 当启用词形变化(morphology)或同义词(synonym)功能时
• 使用某些不包含词头的视觉词典(如图片词典)
• 词典内容本身未明确显示查询词的情况下

技术解决方案探讨

从技术实现角度，可以考虑以下改进方案：

1. 统一添加词头显示
   对所有词典格式，在文章开头统一添加词头显示元素，使用一致的 HTML 结构和 CSS 类名。

2. 智能检测机制
   对于 MDX 格式词典，可先检测内容中是否已包含词头显示，避免重复显示。

3. CSS 控制层
   通过 article-style.css 提供样式控制，允许用户自定义词头显示效果或隐藏不需要的重复词头。

实现建议

具体实现可考虑以下技术要点：

• 新增 mdx_headwords 类用于 MDX 格式词头显示
• 保持现有 DSL 和 StarDict 的词头显示逻辑不变
• 为 MDX 格式添加条件判断，仅在必要时插入词头
• 提供默认 CSS 样式，确保视觉一致性

用户价值

这种改进将带来以下好处：

1. 一致性体验
   所有词典格式获得统一的词头显示方式，降低用户认知负担。

2. 查询明确性
   特别是在使用词形变化功能时，能清晰了解实际匹配的词汇。

3. 可定制性
   通过 CSS 保留足够的自定义空间，满足不同用户的偏好需求。

总结

词典软件中词头显示的标准化是一个值得关注的使用体验优化点。通过合理的技术实现，可以在保持现有功能的同时，为用户提供更一致、更清晰的查询体验。这种改进尤其有利于那些依赖词形变化功能和视觉词典的用户群体。