快速入门

本指南将帮助您快速高效地学习。

\n 需要帮助？\n \n\n```\n\n文本内容会被翻译，而 HTML 结构和标签保持不变。\n\n### 属性处理\n\n```html\n $\"欢迎横幅\"$ \n\n\n```\n\n可翻译的属性如 `alt`、`title`、`placeholder` 和 `aria-label` 会被本地化。\n\n### 语义保留\n\n```html\n

文章标题

\n 2024年1月15日\n

文章内容在此处...

\n```\n\n语义 HTML5 元素及其结构会被保留。\n\n## 高级功能\n\n### 脚本和样式保护\n\n```html\n\n\n\n```\n\nJavaScript 和 CSS 内容保持不变。\n\n### 数据属性\n\n```html\n

\n 可见内容会被翻译\n

\n```\n\n带有可翻译内容的数据属性会被智能处理。\n\n## 高级配置\n\n### 多个 HTML 目录\n\n```json\n\"html\": {\n \"include\": [\n \"content/[locale]/*.html\",\n \"pages/[locale]/**/*.html\"\n ]\n}\n```\n\n### 锁定技术属性\n\n```json\n\"html\": {\n \"include\": [\"content/[locale]/*.html\"],\n \"lockedKeys\": [\"id\", \"class\", \"data-id\", \"href\"]\n}\n```\n","content","\n**Lingo.dev CLI** 可在翻译 HTML 文件时保留标记结构、属性和语义元素，适用于网站和文档。CLI 保持所有 HTML 标记和嵌套结构完整，仅智能处理可翻译的属性，保护 JavaScript 和 CSS 不被翻译，正确处理 HTML5 语义元素，并保证输出的 HTML 是有效的。\n\n## 快速设置\n\n为基于语言环境的 HTML 文件组织进行配置：\n\n```json\n{\n \"locale\": {\n \"source\": \"en\",\n \"targets\": [\"es\", \"fr\", \"de\"]\n },\n \"buckets\": {\n \"html\": {\n \"include\": [\"content/[locale]/*.html\"]\n }\n }\n}\n```\n\n**提醒**：`[locale]` 是一个占位符，在 CLI 运行时会被实际的语言环境替换，因此应在配置中保持原样。\n\n## 翻译 HTML 文件\n\n```bash\nnpx lingo.dev@latest i18n\n```\n\n在保留 HTML 结构、标签、属性和语义标记的同时翻译文本内容。\n\n## 智能 HTML 处理\n\n### 内容翻译\n\n```html\n\n\n \n 欢迎来到我们的平台\n \n \n \n