瀏覽代碼

Put the steps for existing translations first, this will be the most used case.
Simplified the wording of the 'add new language' case.

Mike 3 年之前
父節點
當前提交
4a49669cc5
共有 1 個文件被更改,包括 22 次插入20 次删除
  1. 22 20
      doc/TRANSLATION.md

+ 22 - 20
doc/TRANSLATION.md

@@ -2,28 +2,30 @@
 
 
 You can help Appflowy in supporting various languages by contributing. Follow the steps below sequentially to contribute translations.
 You can help Appflowy in supporting various languages by contributing. Follow the steps below sequentially to contribute translations.
 
 
-**NOTE: Translation files SHOULD be** `json` **files named in the format** `<lang_code>-<country_code>.json` **or just** `<lang_code>.json`**. eg:**`en.json`**,** `en-UK.json`
+## Steps to modify an existing translation
+Translation files are located in : `frontend/app_flowy/assets/translations/`
 
 
-## Steps to add new language support
+1. Modify the specific translation file.
+2. Run `flutter pub run easy_localization:generate -S assets/translations/`
+3. Run `flutter pub run easy_localization:generate -f keys -o locale_keys.g.dart -S assets/translations`
+4. Verify that the translation has changed appropriately by compiling and running the app.
 
 
-1. Add language key-value json file to `frontend/app_flowy/assets/translations/`. Refer `en.json` for format and keys.
-2. Run `flutter pub run easy_localization:generate -S assets/translations/`.
-3. Run `flutter pub run easy_localization:generate -f keys -o locale_keys.g.dart -S assets/translations`.
-4. Add locale of the language (eg: `Locale('en', 'IN')`, `Locale('en')`) in `supportedLocales` list under `EasyLocalization` wrapper for flutter to support it.
-This is located in `frontend/app_flowy/lib/startup/tasks/application_widget.dart` under `AppWidgetTask` class as shown below:
+## Steps to add new language
 
 
-    ```dart
-    runApp(
-      EasyLocalization(
-          supportedLocales: const [ Locale('en') ], // <---- Add locale to this list
-          path: 'assets/translations',
-          fallbackLocale: const Locale('en'),
-          child: app),
-    );
-    ```
+**NOTE: Translation files SHOULD be** `json` **files named in the format** `<lang_code>-<country_code>.json` **or just** `<lang_code>.json`**. eg:**`en.json`**,** `en-UK.json`
 
 
-## Steps to modify translations
+1. Add language key-value json file to `frontend/app_flowy/assets/translations/`. Refer `en.json` for format and keys.
+2. Run `flutter pub run easy_localization:generate -S assets/translations/`
+3. Run `flutter pub run easy_localization:generate -f keys -o locale_keys.g.dart -S assets/translations`
+4. Open the `frontend/app_flowy/lib/startup/tasks/application_widget.dart` file.
+5. In the `AppWidgetTask` class, add the locale of the language you just created (eg: `Locale('en', 'IN')`, `Locale('en')`) to the `supportedLocales` List :
 
 
-1. Modify the specific translation file.
-2. Run `flutter pub run easy_localization:generate -S assets/translations/`.
-3. Run `flutter pub run easy_localization:generate -f keys -o locale_keys.g.dart -S assets/translations`.
+  ```dart
+  runApp(
+    EasyLocalization(
+        supportedLocales: const [Locale('en'), Locale('zh_CN')],  // <---- Add locale to this list
+        path: 'assets/translations',
+        fallbackLocale: const Locale('en'),
+        child: app),
+  );    
+  ```