Internationalization
Caution
Not all plugins include language packs. We will specify this in the documentation for each feature.
mergeLocales Method
mergeLocales Method is used to merge multiple plugin or preset language packs into a complete language pack object. You can use it as follows:
TypeScript
import { mergeLocales } from '@univerjs/presets'// You can pass multiple language pack objects to mergeconst locales = mergeLocales( plugin1Locales, plugin2Locales, presetLocales,)// You can also pass an array of language pack objectsconst locales = mergeLocales([ plugin1Locales, plugin2Locales, presetLocales,])TypeScript
import { mergeLocales } from '@univerjs/core'// You can pass multiple language pack objects to mergeconst locales = mergeLocales( plugin1Locales, plugin2Locales, presetLocales,)// You can also pass an array of language pack objectsconst locales = mergeLocales([ plugin1Locales, plugin2Locales, presetLocales,])Custom Language Packs
Univer also supports custom language packs. You can assemble a language pack object as needed and pass it to the Univer instance. The preset language packs are generally stored in the <rootDir>/packages/<PLUGIN_NAME>/locale directory.
TypeScript
const univer = new Univer({ locale: 'ja-JP', locales: { 'ja-JP': { ui: { shortcut: { undo: '元に戻す', redo: 'やり直す', }, }, }, },})Contributing Translations
Univer currently provides the following built-in language packs:
zh-CN: Simplified Chineseen-US: Englishzh-TW: Traditional Chinesezh-HK: Traditional Chinese (Hong Kong)ru-RU: Russianvi-VN: Vietnamesefa-IR: Persianfr-FR: Frenchja-JP: Japaneseko-KR: Koreanes-ES: Spanishca-ES: Catalansk-SK: Slovakianar-SA: Arabicde-DE: Germanid-ID: Indonesianit-IT: Italianpl-PL: Polishpt-BR: Portuguese (Brazilian)
Univer is an open source project full of inclusiveness, and we welcome developers from all over the world to add or improve locales for Univer.
How is this guide?