Ġabra 马耳他语词典新增了 MDX 版本，可以导入手机和电脑上的兼容阅读器；Mac 用户仍可安装原生词典，使用系统“查询”功能。

前一篇文章 介绍的是 macOS 版本。这次项目从 gabra-maltese-macos-dictionary 更名为 gabra-maltese-dictionary，增加 MDX 文件和跨平台构建工具。想在手机上查词，现在可以下载现成词库，不必先在 Mac 上转换。

下载前，先选适合自己的格式

发布页仍使用 v1.0 这个版本号，现在同时提供 MDX ZIP 和 macOS DMG。两个下载包的用途不同，检索范围也有区别。

MDX 的主词条数较少，是因为同一词头下可以收录多条记录。项目的验证记录确认保留了 21,083 条源记录，不能只看主词条数量就判断内容少了一批。

约 450 万词形检索则属于 macOS 原生版。MDX 以主词条查询为主，没有原生版的同等词形索引。如果经常在阅读时查询变位、复数等形式，在 Mac 上继续用原生版更合适；手机上的 MDX 方便随手查词，但不能把两版的命中范围当成完全一样。

Mac 上仍可使用系统词典

在发布页下载 GabraMalteseDict_v1.0.dmg，打开后把 Gabra.dictionary 复制到 ~/Library/Dictionaries。如果找不到这个目录，可以在 Finder 按 Shift-Command-G，输入路径后前往。

随后打开“词典”，在 词典 → 设置中勾选 Ġabra Maltese Dictionary，再输入一个马耳他语词检查结果。原生版仍在系统词典中显示释义，以及词条里已有的词性、发音和词根信息（见图 1）。

图 1：macOS 原生版中的马耳他语词条。手机和其他平台使用下文的 MDX 版本。

在支持的 App 中，还可以使用右键“查询”、三指轻点或 Force Click。手势可以在 系统设置 → 触控板 → 光标与点按 → 查询与数据检测器中选择。Spotlight 是否显示词典结果，取决于自己的 macOS 配置；先在“词典”App 中确认安装，再检查其他查询入口。

已经在用原生版的人，可以继续保留它。新增 MDX 主要让同一套词条更容易带到其他设备上，不要求先卸载 Mac 版。

在手机或其他电脑导入 MDX

下载 GabraMalteseDict_MDX_v1.0.zip，解压后可以看到：

1
2

Gabra.mdx
Gabra.css

把两个文件放在同一文件夹。Gabra.mdx 是词库，Gabra.css 控制词条样式。只传 MDX 可能让阅读器使用自己的默认样式，因此复制或同步词库时，也把 CSS 一起带上。

MDX 需要另装兼容阅读器。仓库提供的是词典文件，下载 ZIP 不会同时安装这些 App。项目 README 列出的选择包括：

打开阅读器，用它的“导入词典”或“添加词典目录”功能选择文件。手机和平板要把两个文件传到阅读器能访问的词典存储位置，不能只让它们留在另一个 App 无权访问的位置。各阅读器的入口不同，以所选 App 的操作方式为准。

导入完成后，先查询一个主词条，检查释义和样式是否正常。MDX 词条可以包含已有的词性、发音与词根；具体字段取决于原记录。样式表可跟随阅读器的浅色或深色主题，需要自定义外观时可以编辑 Gabra.css。不同阅读器的显示可能有差异，先用几条词目确认效果。

导入后查不到词，先检查什么

先看阅读器的词典列表里有没有 Ġabra，以及它是否已经启用。如果没有出现在列表中，回到导入步骤，确认选中的是解压后的 Gabra.mdx，而不是下载的 ZIP。桌面阅读器如果按目录扫描词库，还要确认添加的目录确实包含这个文件。

词典已经出现，却查不到某个词时，可以先在词典内打开一个已知主词条，再试输入搜索。这样可以分清是词库没有载入，还是这次输入没有匹配到词头。遇到从句子里复制出来的变位或复数形式，试着改查对应的词典形式。原生 Mac 版的词形检索范围更大，MDX 没有相同索引，换阅读器也不会自动补出这部分数据。

能显示释义但排版不对时，检查 Gabra.css 是否与 MDX 一起传入。文件名保留原样；如果把两者拆到不同目录，先重新放在一起，再按阅读器要求刷新或重新导入。深色模式下也可以打开几条词目，检查文字和背景是否容易辨认。

准备在没有网络的地方使用前，可以先断开网络，再打开阅读器查一个词。这能确认设备上已经保存了词库，也便于提前发现文件仍在云盘、尚未下载到本机的情况。

想自己生成词库，构建入口也变了

只使用词典的话，下载上面的成品即可。想调整样式或重新生成 MDX，可以从新仓库根目录执行：

1
2
3
4

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
python scripts/convert_to_mdx.py sources/gabra/Body.data

构建需要 Python 3.10 或更新版本，可以在 macOS、Windows 或 Linux 上进行。Windows 激活虚拟环境时使用 .venv\Scripts\activate。输出放在 dictionaries/mdx/，包含 Gabra.mdx 和 Gabra.css；要修改生成时使用的样式，先编辑 assets/mdx/Gabra.css。

仓库里的 Body.data 是从已有 macOS 词典提取的词条正文快照。用它重新构建 MDX，不会下载较新的上游数据，也不会重新生成 macOS 的词形索引。因此，生成时间变了，不代表词库内容也变新了。

macOS 原生版另走 BSON 构建流程，需要 macOS 和 Apple Dictionary Development Kit。先把一个包含 gabra/lexemes.bson 与 gabra/wordforms.bson 的上游 .tar.gz 放进 data/，再运行：

1

bash scripts/update_macos.sh

结果是 macos/objects/Gabra.dictionary。需要同时安装时使用 bash scripts/update_macos.sh --install，脚本会先在 build/ 下备份已有的已安装词典。这个入口要求自己准备上游数据包，不会自动替你下载最新 BSON。

数据来源与后续更新

词典数据来自马耳他大学的 Ġabra / MLRS，按 CC BY 3.0 使用；项目代码按 GNU GPL v3 发布。转载、分发或继续制作词库时，需要分别查看数据与代码的许可，出处见归属说明。

这次新增的是 MDX 分发和相应构建方式。Mac 上需要系统集成和词形检索，选原生版；想在手机或其他电脑查主词条，选 MDX，并把 CSS 一起导入。最新下载入口与构建要求都在新仓库 README。