如何构建多语言网站Gentics Mesh多语言支持与Fallback机制实战指南【免费下载链接】meshGentics Mesh - The open source headless CMS for developers项目地址: https://gitcode.com/gh_mirrors/mesh3/meshGentics Mesh 是一款面向开发者的开源 headless CMS内置多语言支持与语言 Fallback 机制让构建多语言网站变得异常简单一条lang查询参数即可按需取回不同语言的内容未翻译的页面还能自动回退到默认语言彻底告别404 或空白页的尴尬。本文将带你快速掌握它的核心概念与实战用法 为什么用 Gentics Mesh 构建多语言网站很多 CMS 的多语言方案是每个语言建一套内容维护成本高、内容容易失同步。而 Gentics Mesh 的设计哲学是一个 Node节点承载所有语言——同一篇内容的中英文版共享同一个 Node ID天然对齐Fallback 自动兜底——某语言缺翻译时自动回退到默认语言用户永远看得到内容headless 架构——通过 REST 和 GraphQL 两种 API 交付内容前端框架任选官方对这一特性的描述在 features.asciidoc 的 Multi-Language 章节核心思想是Gentics Mesh comes with multi-language support out of the box开箱即用的多语言支持。核心概念Node 是语言变体的容器理解 Gentics Mesh 多语言的第一步是理解 Node 的模型Node内容的容器本身不直接存储字段语言变体Language Variant真正存储实际字段的对象每个语言一个变体正如官方文档 building-blocks.asciidoc 所强调的一个 node 只是语言变体的容器。这些语言变体存储实际的字段。你可以通过附加?lang查询参数来查询特定的语言变体。这种容器 变体的设计让这篇文章有哪些语言版本某个语言是否已翻译等问题都有了一致的数据模型基础。最快上手配置 defaultLanguage 默认语言所有 Fallback 机制的基石都是在主配置文件mesh.yml中配置defaultLanguage系统默认值en可通过环境变量MESH_DEFAULT_LANG覆盖# mesh.yml 配置示例 defaultLanguage: en配置项的源码定义位于api/src/main/java/com/gentics/mesh/etc/config/MeshOptions.java其 Javadoc 说明Configure system wide default language. This language is automatically used if no language has been specified within the REST query parameters or GraphQL query arguments. 配置全局默认语言。当 REST 查询参数或 GraphQL 查询参数中未指定语言时将自动使用该语言。配置示例文件可参考doc/src/main/docs/generated/models/mesh-config.example.yml。提示项目创建时默认语言会被自动加入项目的语言列表中见mdm/common/src/main/java/com/gentics/mesh/core/data/dao/PersistingProjectDao.java无需手动操作。实战按语言查询内容lang 参数单个语言在任意 Node 请求上附加?lang参数即可GET {api}/:projectName/nodes/:uuid?langde多个语言逗号分隔的优先级列表这是 Fallback 机制真正的威力所在GET {api}/:projectName/nodes/:uuid?langde,en请求会按顺序尝试语言返回第一个有内容的语言版本——如果de没有翻译就自动回落到en页面永远不会空着 ✅lang参数的完整语义定义在mdm/api/src/main/java/com/gentics/mesh/parameter/impl/NodeParametersImpl.javaFallback handling can be applied by specifying multiple languages in a comma-separated list. The first matching language will be returned. If omitted or the requested language is not available then thedefaultLanguageas configured inmesh.ymlwill be returned.写入与删除语言变体创建/更新请求体中的languageJSON 属性决定要创建或更新哪个语言变体删除DELETE {api}/:projectName/nodes/:nodeUuid/language/:language可删除某个语言的内容发布状态GET {api}/:projectName/nodes/:nodeUuid/language/:language/published可查询指定语言的发布状态各语言可独立发布/下线Fallback 机制内容、导航、面包屑全覆盖Gentics Mesh 的 Fallback 不只是取内容时生效而是贯穿整个内容交付链路场景行为请求省略lang参数自动使用defaultLanguage指定语言无翻译回退到defaultLanguage的内容多语言列表?langde,en按顺序取第一个可用的语言导航Navigation对象同样应用 Fallback 规则面包屑Breadcrumb信息同样应用 Fallback 规则内容链接解析链接自动附加默认语言保证可解析链接解析层面的 Fallback 实现在common/src/main/java/com/gentics/mesh/core/link/WebRootLinkReplacerImpl.java其中的appendDefaultLanguageIfNotContained方法会确保每个链接都携带一个可用的语言标签——找不到指定语言时自动补上默认语言。⚠️重要前提为了让 Fallback 正常工作所有 Node 都必须拥有默认语言defaultLanguage的语言变体。建议把默认语言必须翻译完整写入编辑规范 GraphQL 中的多语言查询Gentics Mesh 的 GraphQL API 同样完整支持多语言而且行为非常符合直觉。官方示例见doc/src/main/hugo/content/docs/examples/graphql/node-multilang-query{ node(path: /yachts/pelorus) { availableLanguages node(lang: de) { language } } }通过availableLanguages字段可以查询某节点支持的全部语言——非常适合在前端动态渲染语言切换器 GraphQL 的 Fallback 行为详见 graphql.asciidoc通过 webroot 路径加载节点时自动匹配路径对应的语言德语路径返回德语内容加载德语节点引用的子节点时优先返回德语版本找不到匹配语言时回退到配置的默认语言连默认语言也没有时才返回null这种尽可能保持语言一致 逐级回退的策略保证了整站内容语言体验的连贯性。JS SDK 中的语言管理如果使用 TypeScript/JavaScript 前端官方 SDKmesh-models提供了类型化的语言接口见js/packages/mesh-models/src/lib/language.tsinterface Language { uuid: string; name: string; nativeName: string; // 如 Deutsch、中文 languageTag: string; // 如 de、zh }nativeName字段可以直接用来渲染语言选择器 UI无需再维护一张语言名称对照表。相关方法文档如查询语言列表、指定语言获取 Node在 SDK 的language.ts、nodes.ts模块中。常见问题速答 Q1Fallback 后返回的内容是什么语言是mesh.yml中配置的defaultLanguage。多语言列表请求?langde,en则返回列表中第一个有内容的语言。Q2可以按浏览器语言自动切换吗可以Mesh 本身提供指定语言列表 回退的能力你只需在前端网关或 BFF 层根据Accept-Language头动态拼接lang参数即可。Q3图片等媒体资源支持多语言描述吗支持。Mesh 中图片、视频、文档也是 Node同样拥有语言变体可以为不同语言写不同的标题和描述默认附带 image、video、audio、document 四种 schema。总结用 Gentics Mesh 构建多语言网站的三步走⚙️ 在mesh.yml配置defaultLanguage如en✍️ 保证每个 Node 至少有默认语言变体Fallback 的前提 请求时按需附加?langde,en或 GraphQLlang参数享受指定语言优先、默认语言兜底的智能内容交付配合内容树结构、独立语言发布状态和完整覆盖导航/面包屑的 Fallback 机制Gentics Mesh 为开发者提供了一套简洁而可靠的多语言网站方案 多语言与 Fallback 官方文档features.asciidocNode 与语言变体模型building-blocks.asciidoc配置项源码MeshOptions.java【免费下载链接】meshGentics Mesh - The open source headless CMS for developers项目地址: https://gitcode.com/gh_mirrors/mesh3/mesh创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考