Sanity 文档国际化插件教程
项目介绍
Sanity 文档国际化插件是一个用于 Sanity Studio v3 的插件,旨在帮助开发者创建基于语言的文档唯一翻译版本,并通过共享参考文档进行连接。该插件解决了在 Sanity Studio 中进行国际化的两种流行方法:文档级翻译和字段级翻译。文档级翻译适用于具有唯一语言特定字段且没有跨语言通用内容的文档,而字段级翻译适用于使用可移植文本进行内容翻译的文档。
项目快速启动
安装插件
从 Studio 的同一目录运行以下命令进行安装:
npm install --save @sanity/document-internationalization
或使用 Yarn:
yarn add @sanity/document-internationalization
配置插件
安装完成后,需要进行以下步骤以启用和配置插件:
- 声明可用语言和其他设置
- 在模式上激活国际化
- 自定义桌面结构以过滤到基础语言版本的文档
应用案例和最佳实践
应用案例
假设我们有一个多语言博客平台,需要为每种语言创建唯一的文章版本。使用 Sanity 文档国际化插件,我们可以轻松实现这一点,确保每种语言的文章都有其唯一的字段和内容。
最佳实践
- 数据结构设计:确保每种语言的文档结构一致,便于管理和查询。
- 翻译维护:定期检查和更新翻译内容,确保信息的准确性和时效性。
- GraphQL 支持:利用 GraphQL 查询语言的优势,高效获取多语言数据。
典型生态项目
Sanity Studio
Sanity Studio 是一个强大的内容管理系统,支持灵活的数据结构和实时协作编辑。通过集成文档国际化插件,可以进一步提升其多语言内容管理能力。
Portable Text
Portable Text 是一个用于处理富文本内容的开放标准,广泛应用于 Sanity 生态系统中。结合文档国际化插件,可以实现高效的多语言富文本内容管理。
通过以上模块的介绍和实践,开发者可以快速上手并充分利用 Sanity 文档国际化插件,实现高效的多语言内容管理。