Eleventy Notes 项目新增多语言支持功能

Eleventy Notes 项目新增多语言支持功能

Eleventy Notes 是一个基于 Eleventy 的静态站点生成器，专注于笔记和知识管理。在最新发布的 0.26.0 版本中，该项目新增了全面的多语言支持功能，允许用户自定义界面中的所有文本元素。

功能背景

在之前的版本中，Eleventy Notes 的搜索框占位符文本是硬编码的英文内容"Search by title, content and #tags"。这限制了非英语用户的使用体验，也使得想要自定义提示文本的用户需要修改源代码。

解决方案

开发团队在 0.26.0 版本中实现了完整的翻译系统，通过 TypeScript 的类型检查提供良好的开发体验。用户现在可以：

1. 在配置文件中定义翻译文本
2. 覆盖默认的界面文本
3. 支持多种语言切换

实现方式

翻译系统通过 defineTranslations 函数实现，采用键值对的方式存储翻译文本。TypeScript 的类型检查确保了翻译键的自动补全和默认值提示，大大提高了开发效率。

典型的翻译配置如下：

// @ts-check
import { defineTranslations } from "./.app/app-translations.js";

export const translations = defineTranslations({
  lang: "zh", // 设置语言代码
  translations: {
    "search.input.placeholder": "搜索...",
    "search.popover.placeholder": "按标题、内容和#标签搜索",
    // 其他翻译键...
  },
});

技术优势

1. 类型安全：通过 TypeScript 确保翻译键的正确性
2. 易于扩展：可以轻松添加新的翻译键或语言
3. 开发友好：提供自动补全功能，降低配置错误
4. 全面覆盖：支持界面中所有文本元素的自定义

适用场景

这一功能特别适合：

• 需要本地化界面的非英语用户
• 想要自定义界面文本风格的内容创作者
• 在特定领域应用中需要专业术语的场合

Eleventy Notes 的多语言支持功能为项目的国际化奠定了基础，同时也为用户提供了更大的自定义灵活性，是该项目向成熟化迈进的重要一步。