169 lines
6.4 KiB
Bash
169 lines
6.4 KiB
Bash
#!/usr/bin/env bash
|
|
|
|
# --------------------------------------------------------------------------------------------------
|
|
#
|
|
# Create, update and release translation files.
|
|
#
|
|
# Supported locales on FreeCAD <2024-10-14, FreeCADGui.supportedLocales(), total=44>:
|
|
# {'English': 'en', 'Afrikaans': 'af', 'Arabic': 'ar', 'Basque': 'eu', 'Belarusian': 'be',
|
|
# 'Bulgarian': 'bg', 'Catalan': 'ca', 'Chinese Simplified': 'zh-CN',
|
|
# 'Chinese Traditional': 'zh-TW', 'Croatian': 'hr', 'Czech': 'cs', 'Danish': 'da',
|
|
# 'Dutch': 'nl', 'Filipino': 'fil', 'Finnish': 'fi', 'French': 'fr', 'Galician': 'gl',
|
|
# 'Georgian': 'ka', 'German': 'de', 'Greek': 'el', 'Hungarian': 'hu', 'Indonesian': 'id',
|
|
# 'Italian': 'it', 'Japanese': 'ja', 'Kabyle': 'kab', 'Korean': 'ko', 'Lithuanian': 'lt',
|
|
# 'Norwegian': 'no', 'Polish': 'pl', 'Portuguese': 'pt-PT', 'Portuguese, Brazilian': 'pt-BR',
|
|
# 'Romanian': 'ro', 'Russian': 'ru', 'Serbian': 'sr', 'Serbian, Latin': 'sr-CS', 'Slovak': 'sk',
|
|
# 'Slovenian': 'sl', 'Spanish': 'es-ES', 'Spanish, Argentina': 'es-AR', 'Swedish': 'sv-SE',
|
|
# 'Turkish': 'tr', 'Ukrainian': 'uk', 'Valencian': 'val-ES', 'Vietnamese': 'vi'}
|
|
#
|
|
# NOTE: PREPARATION
|
|
# - Install Qt tools
|
|
# Debian-based (e.g., Ubuntu): $ sudo apt-get install qttools5-dev-tools pyqt6-dev-tools
|
|
# Fedora-based: $ sudo dnf install qt6-linguist qt6-devel
|
|
# Arch-based: $ sudo pacman -S qt6-tools python-pyqt6
|
|
# - Make the script executable
|
|
# $ chmod +x update_translation.sh
|
|
# - The script has to be executed within the `translations` directory.
|
|
# Executing the script with no flags invokes the help.
|
|
# $ ./update_translation.sh
|
|
#
|
|
# NOTE: WORKFLOW TRANSLATOR (LOCAL)
|
|
# - Execute the script passing the `-u` flag plus locale code as argument
|
|
# Only update the file(s) you're translating!
|
|
# $ ./update_translation.sh -u es-ES
|
|
# - Do the translation via Qt Linguist and use `File>Release`
|
|
# - If releasing with the script execute it passing the `-r` flag
|
|
# plus locale code as argument
|
|
# $ ./update_translation.sh -r es-ES
|
|
#
|
|
# NOTE: WORKFLOW MAINTAINER (CROWDIN)
|
|
# - Execute the script passing the '-U' flag
|
|
# $ ./update_translation.sh -U
|
|
# - Once done, download the translated files, copy them to `translations`
|
|
# - Upload the updated file to CrowdIn and wait for translators do their thing ;-)
|
|
# and release all the files to update the changes
|
|
# $ ./update_translation.sh -R
|
|
#
|
|
# --------------------------------------------------------------------------------------------------
|
|
|
|
supported_locales=(
|
|
"en" "af" "ar" "eu" "be" "bg" "ca" "zh-CN" "zh-TW" "hr"
|
|
"cs" "da" "nl" "fil" "fi" "fr" "gl" "ka" "de" "el"
|
|
"hu" "id" "it" "ja" "kab" "ko" "lt" "no" "pl" "pt-PT"
|
|
"pt-BR" "ro" "ru" "sr" "sr-CS" "sk" "sl" "es-ES" "es-AR" "sv-SE"
|
|
"tr" "uk" "val-ES" "vi"
|
|
)
|
|
|
|
is_locale_supported() {
|
|
local locale="$1"
|
|
for supported_locale in "${supported_locales[@]}"; do
|
|
[ "$supported_locale" == "$locale" ] && return 0
|
|
done
|
|
return 1
|
|
}
|
|
|
|
update_locale() {
|
|
local locale="$1"
|
|
local u=${locale:+_} # Conditional underscore
|
|
FILES="../*.py ../Resources/ui/*.ui"
|
|
|
|
# NOTE: Execute the right commands depending on:
|
|
# - if it's a locale file or the main, agnostic one
|
|
[ ! -f "${WB}${u}${locale}.ts" ] && action="Creating" || action="Updating"
|
|
echo -e "\033[1;34m\n\t<<< ${action} '${WB}${u}${locale}.ts' file >>>\n\033[m"
|
|
if [ "$u" == "" ]; then
|
|
eval $LUPDATE "$FILES" -ts "${WB}.ts" # locale-agnostic file
|
|
else
|
|
eval $LUPDATE "$FILES" -source-language en_US -target-language "${locale//-/_}" \
|
|
-ts "${WB}_${locale}.ts"
|
|
fi
|
|
}
|
|
|
|
normalize_crowdin_files() {
|
|
# Rename files which locales are different on FreeCAD and delete not supported locales
|
|
crowdin_fixes=(af-ZA ar-SA be-BY bg-BG ca-ES cs-CZ da-DK de-DE el-GR eu-ES fi-FI
|
|
fil-PH fr-FR gl-ES hr-HR hu-HU it-IT ja-JP ka-GE kab-KAB ko-KR lt-LT nl-NL
|
|
no-NO pl-PL ro-RO ru-RU sk-SK sl-SI sr-SP tr-TR uk-UA vi-VN)
|
|
|
|
crowdin_deletes=(az-AZ bn-BD br-FR bs-BA en en-GB en-US eo-UY es-CO es-VE et-EE fa-IR he-IL
|
|
hi-IN hy-AM id-ID kaa lv-LV mk-MK ms-MY sat-IN si-LK ta-IN te-IN th-TH ur-PK xav yo-NG)
|
|
|
|
for pattern in "${crowdin_fixes[@]}"; do
|
|
find . -type f -name "*_${pattern}\.*" | while read -r file; do
|
|
mv -v "$file" "${file//-*./.}"
|
|
done
|
|
done
|
|
|
|
for pattern in "${crowdin_deletes[@]}"; do
|
|
find . -type f -name "*_${pattern}\.*" -delete
|
|
done
|
|
}
|
|
|
|
help() {
|
|
echo -e "\nDescription:"
|
|
echo -e "\tCreate, update and release translation files."
|
|
echo -e "\nUsage:"
|
|
echo -e "\t./update_translation.sh [-R] [-U] [-r <locale>] [-u <locale>]"
|
|
echo -e "\nFlags:"
|
|
echo -e " -R\n\tRelease all translations (qm files)"
|
|
echo -e " -U\n\tUpdate all translations (ts files)"
|
|
echo -e " -r <locale>\n\tRelease the specified locale"
|
|
echo -e " -u <locale>\n\tUpdate strings for the specified locale"
|
|
echo -e " -N\n\tNormalize CrowdIn filenames"
|
|
}
|
|
|
|
# Main function ------------------------------------------------------------------------------------
|
|
|
|
# LUPDATE="C:/Program Files/FreeCAD 1.0/bin/Lib/site-packages/PySide6/lupdate" # from Qt6
|
|
LUPDATE=/usr/lib/qt6/bin/lupdate # from Qt6
|
|
# LUPDATE=lupdate # from Qt5
|
|
# LRELEASE="C:/Program Files/FreeCAD 1.0/bin/Lib/site-packages/PySide6/lrelease" # from Qt6
|
|
LRELEASE=/usr/lib/qt6/bin/lrelease # from Qt6
|
|
# LRELEASE=lrelease # from Qt5
|
|
WB="SearchBar"
|
|
|
|
sed -i '3s/-/_/' ${WB}*.ts # Enforce underscore on locales
|
|
sed -i '3s/\"en\"/\"en_US\"/g' ${WB}*.ts # Use en_US
|
|
|
|
if [ $# -eq 1 ]; then
|
|
if [ "$1" == "-R" ]; then
|
|
find . -type f -name '*_*.ts' | while IFS= read -r file; do
|
|
# Release all locales
|
|
$LRELEASE -nounfinished "$file"
|
|
echo
|
|
done
|
|
elif [ "$1" == "-U" ]; then
|
|
for locale in "${supported_locales[@]}"; do
|
|
update_locale "$locale"
|
|
done
|
|
elif [ "$1" == "-u" ]; then
|
|
update_locale # Update main file (agnostic)
|
|
elif [ "$1" == "-N" ]; then
|
|
normalize_crowdin_files
|
|
else
|
|
help
|
|
fi
|
|
elif [ $# -eq 2 ]; then
|
|
LOCALE="$2"
|
|
if is_locale_supported "$LOCALE"; then
|
|
if [ "$1" == "-r" ]; then
|
|
# Release locale (creation of *.qm file from *.ts file)
|
|
$LRELEASE -nounfinished "${WB}_${LOCALE}.ts"
|
|
elif [ "$1" == "-u" ]; then
|
|
# Update main & locale files
|
|
update_locale
|
|
update_locale "$LOCALE"
|
|
fi
|
|
else
|
|
echo "Verify your language code. Case sensitive."
|
|
echo "If it's correct, ask a maintainer to add support for your language on FreeCAD."
|
|
echo -e "\nSupported locales, '\033[1;34mFreeCADGui.supportedLocales()\033[m': \033[1;33m"
|
|
for locale in $(printf "%s\n" "${supported_locales[@]}" | sort); do
|
|
echo -n "$locale "
|
|
done
|
|
echo
|
|
fi
|
|
else
|
|
help
|
|
fi
|