Files
lobehub/docs/development/internationalization/add-new-locale.mdx
Arvin Xu 7496511917 📝 docs: improve self-hosting documents (#11994)
* update document

* update documents

* update auth

* move

* update database

* move auth

* move auth

* update
2026-01-30 20:50:05 +08:00

66 lines
2.3 KiB
Plaintext

---
title: New Locale Guide
description: Learn how to add Vietnamese language support in LobeHub using lobe-i18n.
tags:
- LobeHub
- i18n
- language support
- Vietnamese
- localization
---
# New Locale Guide
LobeHub uses [lobe-i18n](https://github.com/lobehub/lobe-cli-toolbox/tree/master/packages/lobe-i18n) as the i18n solution, which allows for quick addition of new language support in the application.
## Adding New Language Support
To add new language internationalization support in LobeHub (for example, adding Vietnamese `vi-VN`), please follow the steps below:
### Step 1: Update the Internationalization Configuration File
1. Open the `.i18nrc.js` file. You can find this file in the project's root directory.
2. Add the new language code to the configuration file. For example, to add Vietnamese, you need to add `'vi-VN'` to the configuration file.
```js
module.exports = {
// ... Other configurations
outputLocales: [
'zh-TW',
'en-US',
'ru-RU',
'ja-JP',
// ...Other languages
'vi-VN', // Add 'vi-VN' to the array
],
};
```
### Step 2: Automatically Translate Language Files
LobeHub uses the `lobe-i18n` tool to automatically translate language files, so manual updating of i18n files is not required.
Run the following command to automatically translate and generate the Vietnamese language files:
```bash
npm run i18n
```
This will utilize the `lobe-i18n` tool to process the language files.
### Step 3: Submit and Review Your Changes
Once you have completed the above steps, you need to submit your changes and create a Pull Request.
Ensure that you follow LobeHub's contribution guidelines and provide a necessary description to explain your changes. For example, refer to a similar previous Pull Request [#759](https://github.com/lobehub/lobehub/pull/759).
### Additional Information
- After submitting your Pull Request, please patiently wait for the project maintainers to review it.
- If you encounter any issues, you can reach out to the LobeHub community for assistance.
- For more accurate results, ensure that your Pull Request is based on the latest main branch and stays in sync with the main branch.
By following the above steps, you can successfully add new language support to LobeHub and ensure that the application provides a localized experience for more users.