chore: update babel doc (#17679)

* chore: update babel doc

* update .po file

* update translation workflow

.github/workflows/superset-translations.yml

@@ -54,7 +54,4 @@ jobs:
  pip-upgrade
  pip install -r requirements/base.txt
  - name: Test babel extraction
- run: |
- flask fab babel-extract --target superset/translations \
- --output superset/translations/messages.pot \
- --config superset/translations/babel.cfg -k _,__,t,tn,tct
+ run: ./scripts/babel_update.sh

CONTRIBUTING.md

@@ -1039,22 +1039,15 @@ LANGUAGES = {
 }
 ```
 
-### Extracting new strings for translation
-
-```bash
-pybabel extract -F superset/translations/babel.cfg -o superset/translations/messages.pot -k _ -k __ -k t -k tn -k tct .
-```
-
-This will update the template file `superset/translations/messages.pot` with current application strings. Do not forget to update
-this file with the appropriate license information.
-
 ### Updating language files
 
 ```bash
- pybabel update -i superset/translations/messages.pot -d superset/translations --ignore-obsolete
+./scripts/babel_update.sh
 ```
 
-This will update language files with the new extracted strings.
+This script will
+1. update the template file `superset/translations/messages.pot` with current application strings.
+2. update language files with the new extracted strings.
 
 You can then translate the strings gathered in files located under
 `superset/translation`, where there's one per language. You can use [Poedit](https://poedit.net/features)

scripts/babel_extract.sh → scripts/babel_update.sh

@@ -46,6 +46,12 @@ pybabel extract \
  --copyright-holder=Superset \
  --project=Superset \
  -k _ -k __ -k t -k tn -k tct .
-cat $LICENSE_TMP $ROOT_DIR/superset/translations/messages.pot > messages.pot.tmp \
- && mv messages.pot.tmp $ROOT_DIR/superset/translations/messages.pot \
- && cd $CURRENT_DIR
+cat $LICENSE_TMP superset/translations/messages.pot > messages.pot.tmp \
+ && mv messages.pot.tmp superset/translations/messages.pot
+
+pybabel update \
+ -i superset/translations/messages.pot \
+ -d superset/translations \
+ --ignore-obsolete
+
+cd $CURRENT_DIR