@cogita/plugin-i18n 提供主题无关的界面文案契约。翻译内容不放入 Core,官方主题和第三方主题都可以消费同一个运行时模块。
插件先匹配完整 locale,再匹配语言前缀,最后使用配置的回退语言。缺少 key 时使用主题传入的回退文案,因此翻译不完整时站点仍可用。
主题从 virtual-cogita-i18n-text 导入 t,并使用 knowledge.home.search、lucid.search.title 这类稳定的命名空间 key。回退文案应使用英文,让新站点在没有消息文件时仍然英文优先。
Rspress 已经拥有 virtual-i18n-text;Cogita 使用自己的命名空间模块,避免运行时模块冲突。
插件只翻译界面文案。文章标题、Markdown 和用户提供的元数据属于内容,不会被重写。未来的内容本地化流程可以建立在这个契约之上,而不改变主题运行时行为。