translate.sh

#!/bin/bash
# api.deepl.com
# Here is where the magic with DeepL happens. We get the JSON response from
# Look at https://www.deepl.com/docs-api/translating-text/request/ for supported languages
bExec=1 # 0: do not translate, only list files, which would be processed, 1: translate
bUpdateAll=0 # 0: update only outdated files, 1:translate all

previousVersionPath="/volume1/syn/sHorst/Dev_Syno/source/autorun1.10.0_0011i" # if set then are the sourceable files not completely, but only changed items are updated

translateSourceable=0
translateWizzard=0
translateHtmlLicense=0
translateHtmlHelp=0
translateHelpToc=1

SCRIPTPATHtranslate="$( cd -- "$(dirname "${BASH_SOURCE[0]}")" >/dev/null 2>&1 ; /bin/pwd -P )"
source "$SCRIPTPATHtranslate/package/ui/modules/parse_hlp.sh" # urlencode, urldecode
cd "$SCRIPTPATHtranslate"

# parse_hlp.sh needs $app_name! otherwise it uses ${scriptpathParent##*/}, which would be wrong here!
if [[ -f "INFO.sh" ]]; then
  file="INFO.sh"
elif [[ -f "INFO" ]]; then
  file="INFO"
fi
if [[ -z "$file" ]]; then
  echo "Error: Could not find INFO.sh or INFO for extraction of the package name!"
  exit 2
fi
line="$(grep -i "^package=" "$file")"
# app_name="$(sed -e 's/\"//g' <<<"${line#*=}")"
app_name="${line#*=}"
app_name="${app_name//\"/}"

source "package/ui/modules/parse_hlp.sh" # urlencode, urldecode

LOG="translation.log"
echo "Translation script started ..." | tee -a "$LOG"
SCRIPTPATHPARENT=${SCRIPTPATHtranslate%/*}
if [[ -f "$SCRIPTPATHPARENT/DeepLApiKey.txt" ]]; then
  apikey=$(cat "$SCRIPTPATHPARENT/DeepLApiKey.txt")
  echo "DeepL Api-Key '$apikey'"
else
  echo "Datei $SCRIPTPATHPARENT/DeepLApiKey.txt mit dem DeepL ApiKey nicht gefunden!" | tee -a "$LOG"
  exit 2
fi
deepl_url="https://api.deepl.com/v2/translate?auth_key=$apikey"
# deepl_url="https://api-free.deepl.com/v2/translate?auth_key=$apikey"

declare -A SYNO2ISO
SYNO2ISO=( ["ger"]="de" ["enu"]="en" ["chs"]="zh" ["csy"]="cs" ["jpn"]="ja" ["krn"]="ko" ["dan"]="da" ["fre"]="fr" ["ita"]="it" ["nld"]="nl" ["plk"]="pl" ["rus"]="ru" ["spn"]="es" ["sve"]="sv" ["hun"]="hu" ["trk"]="tr" ["ptb"]="pt-BR" ["ptg"]="pt-PT" )
# Japan: ja (DeepL acc. FIPS 10 = U.S. Federal Information Processing Standard No. 10), not jp (ISO 3166-1)?

# https://www.laenderdaten.info/laendercodes.php

# Deepl: BG - Bulgarian, , EL - Greek, ET - Estonian, FI - Finnish, ID - Indonesian, LT - Lithuanian, LV - Latvian, RO - Romanian, RO - Romanian, SK - Slovak, SL - Slovenian, UK - Ukrainian
# DeepL-Syno: CS - Czech - csy, DA - Danish - dan, DE - German - ger, EN - English - enu, ES - Spanish - spn, FR - French - fre, HU - Hungarian - hun, IT - Italian - ita, JA - Japanese - jpn, NL - Dutch - nld, PL - Polish - plk, PT-BR - Portuguese Brazilian - ptb,  PT-PT - Portuguese European - ptg, RU - Russian - rus, SV - Swedish - sve, TR - Turkish - trk, ZH - Chinese simplified - chs
#Syno: ["cht"]="" Chinese traditional,  ["krn"]="ko" Korean, NO - Norwegian - nor,  th - Thai - tha


synoLangs="chs csy dan fre ger hun ita jpn nld plk ptb ptg rus spn sve trk"
# synoLangs="chs csy dan fre hun ita jpn nld plk ptb ptg rus spn sve trk"
# synoLangs="enu" # for debugging translate only these languages

sourceSynoLang="enu"
# sourceSynoLang="ger"

echo "Translating from $sourceSynoLang to $synoLangs" | tee -a "$LOG"
errCnt=0
sourceIsoLang="${SYNO2ISO[$sourceSynoLang]}"

# sourcable files: ###
filePath="package/ui/texts"
sourceablefiles=( "$filePath/${sourceSynoLang}/lang.txt" "$filePath/${sourceSynoLang}/strings" )

# json files from Wizzards: ###
wizzardfiles=( "WIZARD_UIFILES/wizard_$sourceSynoLang.json" "WIZARD_UIFILES/uninstall_uifile_$sourceSynoLang" )

# html files: ###
declare -a htmlfiles
if [[ "$translateHtmlLicense" -gt "0" ]]; then
  htmlfiles=( "package/ui/licence_$sourceSynoLang.html" )
fi
if [[ "$translateHtmlHelp" -gt "0" ]]; then
  for file in "package/ui/help/$sourceSynoLang"/*.html; do
    htmlfiles=("${htmlfiles[@]}" "$file")
  done
fi

allfiles=( "${sourceablefiles[@]}" "${wizzardfiles[@]}" "${htmlfiles[@]}" ) # all source files
for sourcefile in "${allfiles[@]}"; do
  if [[ ! -f "$sourcefile" ]]; then
    echo "Sourecfile '$sourcefile' for translation is missing!" | tee -a "$LOG"
    ((errCnt=errCnt+1))
  fi
done
if [[ "$errCnt" -gt "0" ]]; then
  echo "Translation stopped due to some missing source files! errCnt=$errCnt" | tee -a "$LOG"
  exit 2
fi

###################################
if [[ "$translateSourceable" -ne "0" ]];then
  # line by line translation of sourcable files with removed item label like "msg1="
  for sourcefile in "${sourceablefiles[@]}"; do  # e.g. package/ui/texts/enu/lang.txt
    echo -e "\n" | tee -a "$LOG"
    if [[ "$bUpdateAll" -ne "0" ]]; then
      timeStampSource=$(date +%s)
    else
      timeStampSource=$(stat -c %Y "$sourcefile")  
    fi
    timeStampSource=$(stat -c %Y "$sourcefile")
    for synoLang in $synoLangs; do
      targetIsoLang="${SYNO2ISO[$synoLang]}"
      srcLngPath=$(dirname "$sourcefile")
      # echo "srcLngPath=$srcLngPath, ${srcLngPath##*/}" | tee -a "$LOG"
      if [[ "${srcLngPath##*/}" == "$sourceSynoLang" ]]; then # lng in path, seperate folders for each language
        lngPath=${srcLngPath%/*} # parent without e.g. "ger"
        targetFile="$lngPath/${synoLang}/$(basename "$sourcefile")"
        if [[ "$bExec" -ne "0" ]]; then
          if [[ ! -d "$filePath/${synoLang}" ]]; then # not existing, prepare target folder:
            mkdir "$filePath/${synoLang}"
            chmod 777 "$filePath/${synoLang}"
            chown :users "$filePath/${synoLang}" 
          fi
        fi
      else # lng in file name
        # targetFile=$(echo "$sourcefile" | sed "s/_$sourceSynoLang/_$synoLang/")
        targetFile=${sourcefile/_$sourceSynoLang/_$synoLang}
      fi
      echo -e "\nprocessing source='$sourcefile', target='$targetFile'" | tee -a "$LOG"
      uptodateFile=0
      if [[ -f "$targetFile" ]]; then
        timeStampDest=$(stat -c %Y "$targetFile")
        if [[ "$timeStampDest" -gt "$timeStampSource" ]]; then # up to date
          echo "up to date: $targetFile" | tee -a "$LOG"
          uptodateFile=1
        else
          echo "too old: $targetFile" | tee -a "$LOG"
          if [[ "$bExec" -ne "0" ]]; then
            targetFileOld="${targetFile}old"
            mv "$targetFile" "${targetFile}old"
          else
            targetFileOld="${targetFile}"
          fi # bExec
        fi # timeStamp
      else
        echo "not yet existing: $targetFile" | tee -a "$LOG"
      fi # target exists else
      if [[ "$uptodateFile" -eq "0" ]]; then
        echo -e "\ntranslating lines of $targetFile ..." | tee -a "$LOG"
        lineCount=0
        while read -r lineSourceNew; do # read all settings from file
          lineCount=$((lineCount+1))
          if [[ ${lineSourceNew} == "#"* ]] || [[ ${lineSourceNew} == "["* ]]; then # Comment or Section like "[app]"
            if [[ "$bExec" -ne "0" ]]; then
              echo "$lineSourceNew" >> "$targetFile"
              if [[ "$lineCount" -eq "1" ]]; then # add an comment line
                echo "# This file was generated via DeepL machine translation from $sourceIsoLang" >> "$targetFile"
              fi
            fi
          elif [[ ${lineSourceNew} == "" ]]; then # don't produce '=""'
            if [[ "$bExec" -ne "0" ]]; then
              echo "" >> "$targetFile"
            fi
          else
            itemName="${lineSourceNew%%=*}"
            quotedItemVal="${lineSourceNew#*=}"
            if [[ "${quotedItemVal:0:1}" == "'" ]]; then
              quote="'"
              itemVal="$(echo "${quotedItemVal}" | sed -e "s/^'//" -e "s/'$//")" # remove quotes
            else
              quote="\""
              itemVal="$(echo "${quotedItemVal}" | sed -e 's/^"//' -e 's/"$//')" # remove quotes
            fi
            # itemVal="${itemVal@Q}" #  preserve ESC
            uptodateItem=0
            prevVersionFilePathName="${previousVersionPath}/${sourcefile}"
            # echo "prevVersionFilePathName='$prevVersionFilePathName'" | tee -a "$LOG"
            if [[ "$bUpdateAll" -eq "0" ]] && [[ -f "$prevVersionFilePathName" ]]; then # was this item changed?
              lineSourceOld="$(grep -i "$itemName=" "$prevVersionFilePathName")"
              lineTargetOld="$(grep -i "$itemName=" "$targetFileOld")"
              if [[ -z "$lineSourceOld" ]]; then
                echo "not found '$itemName' in $prevVersionFilePathName" | tee -a "$LOG"
              elif [[ "$lineSourceNew" == "$lineSourceOld" ]] && [[ -n "$lineTargetOld" ]]; then
                uptodateItem=1
                echo "Item '$itemName' is unchanged" | tee -a "$LOG"
              else
                echo "oldSource=newSource ($sourceSynoLang), but not in old target ($synoLang): $itemName=\"$itemVal\"" | tee -a "$LOG"
                # in lineSourceOld here still e.g. (\$1) ... (\$2)
                # in itemVal: ESC lost!
              fi
            elif [[ "$bUpdateAll" -eq "0" ]]; then
              echo "not found: $prevVersionFilePathName" | tee -a "$LOG"
            fi # 0: update only outdated files, 1:translate all
            if [[ "$uptodateItem" -eq "0" ]]; then
              param="target_lang=$targetIsoLang&source_lang=$sourceIsoLang"
              # param="target_lang=$targetIsoLang&source_lang=$sourceIsoLang&tag_handling=xml"
              if [[ "$bExec" -ne "0" ]]; then
                translatedraw=$(curl -Gs "$deepl_url" --data-urlencode "text=$itemVal" -d "$param")
                res=$?
                if [ $res -eq 0 ]; then # If the curl above was sucessful
                  echo "translatedraw='$translatedraw'" | tee -a "$LOG"
                  # Get the translated text from the JSON response:
                  translated=$(echo "$translatedraw" | jq --compact-output '.translations[0].text')
                  translated=${translated#\"} # remove quote at string start
                  translated=${translated%\"} # remove quote at string end
                  echo "translated urlcoded='$translated'" | tee -a "$LOG"
                  translated=$(urldecode "$translated")  # ${translated@Q} ???
                  echo "translated decoded='$translated'" | tee -a "$LOG"
                  if [[ ! -v translated ]] || [[ -z "$translated" ]]; then
                    echo "======================================================="
                    echo "DeepL Response Problem: " | tee -a "$LOG"
                    echo "source: '$itemVal'" | tee -a "$LOG"
                    echo "raw: '$translatedraw'" | tee -a "$LOG"
                    echo "translated: '$translated'" | tee -a "$LOG"
                    echo "======================================================="
                    echo "stopped!" | tee -a "$LOG"
                    exit 2
                  fi
                  # tr2="$(echo "$translated" | sed -e 's|\"|\\"|g' -e 's|\$|\\$|g' )" # Führt zu Fehler in lang.txt bei settingNotifyUsers=""!! Daher:
                  tr2="$(echo "$translated" | sed -e 's|\$|\\$|g' )"
                  echo "$synoLang $targetIsoLang: $tr2" | tee -a "$LOG"
                  # echo "$itemName=\"${tr2}\"" >> "$targetFile"
                  printf "%s=%s%s%s\n" "$itemName" "$quote" "$tr2" "$quote"
                else
                  echo "The translation request failed: curl code $res, result:'$translatedraw'" | tee -a "$LOG"
                  # https://really-simple-ssl.com/curl-errors/
                  if [[ "$res" -eq "28" ]]; then
                    echo "28: Connection timed out" | tee -a "$LOG"
                  elif [[ "$res" -eq "60" ]]; then
                    echo "60: unable to get local issuer certificate" | tee -a "$LOG"
                  elif [[ "$res" -eq "60" ]]; then
                    echo "35: SSL connect error" | tee -a "$LOG"
                  fi
                  exit 1
                fi
              else
                echo -e "to translate: '$itemVal'\n" | tee -a "$LOG"
              fi # if [[ "$bExec" -ne "0" ]]else
            else # "$uptodateItem" == "1"
              # echo "unchanged: '$lineSourceNew'" | tee -a "$LOG"
              if [[ "$bExec" -ne "0" ]]; then
                echo "${lineTargetOld}" >> "$targetFile"
              fi
            fi # if [[ "$uptodateItem" -eq "0" ]] else
          fi
        done < "$sourcefile" # while read: Works well even if last line has no \n!
        chmod 777 "$targetFile"
        chown :users "$targetFile"
        echo "... $targetFile done!" | tee -a "$LOG"
        if [[ -f "${targetFile}old" ]]; then
          rm "${targetFile}old"
        fi
      fi # not uptodateFile
    done # for synoLang in $synoLangs; do
  done # for sourcefile in $sourceablefiles; do
fi # translateSourceable

###################################
if [[ "$translateWizzard" -ne "0" ]]; then
  # translation of lines with '"desc":', '"errorText":', '"emptyText":' and '"step_title":' in wizzard files:
  for sourcefile in "${wizzardfiles[@]}"; do
    echo -e "\n" | tee -a "$LOG"
    if [[ "$bUpdateAll" -ne "0" ]]; then
      timeStampSource=$(date +%s)
    else
      timeStampSource=$(stat -c %Y "$sourcefile")
    fi
    for synoLang in $synoLangs; do
      targetIsoLang="${SYNO2ISO[$synoLang]}"
      srcLngPath=$(dirname "$sourcefile")
      # echo "srcLngPath=$srcLngPath, ${srcLngPath##*/}" | tee -a "$LOG"
      if [[ "${srcLngPath##*/}" == "$sourceSynoLang" ]]; then # lng in path, seperate folders for each language
        lngPath=${srcLngPath%/*} # parent without e.g. "ger"
        targetFile="$lngPath/${synoLang}/$(basename "$sourcefile")"
      else # lng in file name
        # targetFile=$(echo "$sourcefile" | sed "s/_$sourceSynoLang/_$synoLang/")
        targetFile=${sourcefile/_$sourceSynoLang/_$synoLang}
      fi
      if [[ ! -d "$filePath/${synoLang}" ]]; then
        mkdir "$filePath/${synoLang}"
        chmod 700 "$filePath/${synoLang}"
        chown :users "$filePath/${synoLang}"
      fi
      echo -e "\nprocessing source='$sourcefile', target='$targetFile'" | tee -a "$LOG"
      uptodateFile=0
      if [[ -f "$targetFile" ]]; then
        timeStampDest=$(stat -c %Y "$targetFile")
        if [[ "$timeStampDest" -gt "$timeStampSource" ]]; then # up to date
          echo "up to date: $targetFile" | tee -a "$LOG"
          uptodateFile=1
        else
          echo "too old: $targetFile" | tee -a "$LOG"
          if [[ "$bExec" -ne "0" ]]; then
            mv "$targetFile" "${targetFile}old"
          fi # bExec
        fi # timeStamp
      else
        echo "not yet existing: $targetFile" | tee -a "$LOG"
      fi # target exists else
      if [[ "$uptodateFile" -eq "0" ]]; then
        echo -e "\ntranslating lines of $targetFile ..." | tee -a "$LOG"
        lineCount=0
        while read -r lineSourceNew; do # read all settings from file
          lineCount=$((lineCount+1))
          val=""
          if [[ ${lineSourceNew} == *"\"step_title\":"* ]] || [[ ${lineSourceNew} == *"\"desc\":"* ]] || [[ ${lineSourceNew} == *"\"errorText\":"* ]]  || [[ ${lineSourceNew} == *"\"emptyText\":"* ]]; then
            prefix=${lineSourceNew%%:*}
            #val=$(echo "${lineSourceNew#*=}" | sed -e 's/^"//' -e 's/"$//')
            val="${lineSourceNew#*:}" # e.g. "Konfiguration",
            echo "raw val='$val'" | tee -a "$LOG"
            postfix="${val##*\"}" # e.g. trailing comma
            val="${val%\"*}"
            val="${val#*\"}"
            echo "postfix='$postfix', remaining='$val'" | tee -a "$LOG"
          elif [[ ${lineSourceNew} == *"\"fn\""*"return" ]]; then # "fn": "{if (/^([0-9]+)$/.test(arguments[0])) return true; return 'Eine positive Zahl eingeben!'; }"
            prefix=${lineSourceNew%return*}
            val=${lineSourceNew##*return }
            postfix=${lineSourceNew##*\'}
            val=$(echo "$val" | sed "s/\$postfix$//")
          fi
          if [[ -n $val ]]; then
            if [[ "$bExec" -ne "0" ]]; then
              preparedsource="$val"
              # echo "$synoLang $targetIsoLang: '$source' '$preparedsource'" | tee -a "$LOG"
              param="target_lang=$targetIsoLang&source_lang=$sourceIsoLang"
              if [[ "${targetFile}" == *"html" ]]; then
                param="$param&tag_handling=html"
              fi
              translatedraw=$(curl -Gs "$deepl_url" --data-urlencode "text=$preparedsource" -d "$param")
              res=$?
              if [ $res -eq 0 ]; then # If the curl above was sucessful
                # Get the translated text from the JSON response:
                translated=$(echo "$translatedraw" | jq --compact-output '.translations[0].text') # in double quotes
                translated=${translated#\"} # remove quote at string start
                translated=${translated%\"} # remove quote at string end
                translated=$(urldecode "$translated")
                if [[ ! -v translated ]] || [[ -z "$translated" ]]; then
                  echo "======================================================="
                  echo "DeepL Response Problem: " | tee -a "$LOG"
                  echo "source: '$preparedsource'" | tee -a "$LOG"
                  echo "raw: '$translatedraw'" | tee -a "$LOG"
                  echo "translated: '$translated'" | tee -a "$LOG"
                  echo "======================================================="
                  echo "stopped!" | tee -a "$LOG"
                  exit 2
                fi
                tr2="$(echo "$translated" | sed -e 's|\"|\\\\"|g' -e 's|\$|\\\\$|g' )"
                echo "$synoLang $targetIsoLang: $tr2" | tee -a "$LOG"
                echo "${prefix}:\"${tr2}\"${postfix}" >> "$targetFile"
              else # If the curl above was NOT sucessful
                echo "The translation request failed: curl code $res, result:'$translatedraw'" | tee -a "$LOG"
                # https://really-simple-ssl.com/curl-errors/
                if [[ "$res" -eq "28" ]]; then
                  echo "28: Connection timed out" | tee -a "$LOG"
                elif [[ "$res" -eq "60" ]]; then
                  echo "60: unable to get local issuer certificate" | tee -a "$LOG"
                elif [[ "$res" -eq "60" ]]; then
                  echo "35: SSL connect error" | tee -a "$LOG"
                fi
                exit 1
              fi # if [ $res -eq 0 ] else
            else # only simulation
              echo "source lineSourceNew: '$lineSourceNew'" | tee -a "$LOG"
              echo "to translate: '$val'" | tee -a "$LOG"
              echo "result line: '${prefix}: \"XXXX\"${postfix}'" | tee -a "$LOG"
            fi # translate or simulate
          else # $val empty: copy lineSourceNew unchanged:
            if [[ "$bExec" -ne "0" ]]; then
              echo "$lineSourceNew" >> "$targetFile"
            fi
          fi
        done < "$sourcefile" # while read: Works well even if last line has no \n!
        chmod 777 "$targetFile"
        chown :users "$targetFile"
        echo "... $targetFile done!" | tee -a "$LOG"
        if [[ -f "${targetFile}old" ]]; then
          rm "${targetFile}old"
        fi
      fi # not uptodateFile
    done # for synoLang in $synoLangs; do
  done # for sourcefile in ${wizzardfiles[@]}; do
fi # translateWizzard

#################################
if [[ "$translateHtmlHelp" -ne "0" ]] || [[ "$translateHtmlLicense" -ne "0" ]]; then
  # translation of html files
  for sourcefile in "${htmlfiles[@]}"; do
    echo ""
    if [[ "$bUpdateAll" -ne "0" ]]; then
      timeStampSource=$(date +%s)
    else
      timeStampSource=$(stat -c %Y "$sourcefile")
    fi  
    for synoLang in $synoLangs; do
      targetIsoLang="${SYNO2ISO[$synoLang]}"
      srcLngPath=$(dirname "$sourcefile")
      # echo "srcLngPath=$srcLngPath, ${srcLngPath##*/}" | tee -a "$LOG"
      if [[ "${srcLngPath##*/}" == "$sourceSynoLang" ]]; then # lng in path, seperate folders for each language
        lngPath=${srcLngPath%/*} # parent without e.g. "ger"
        targetFile="$lngPath/${synoLang}/$(basename "$sourcefile")"
        # echo "Language in Path: $sourcefile ==> $targetFile"
        if [[ "$bExec" -ne "0" ]]; then
          if [[ ! -d "$lngPath/${synoLang}" ]]; then
            mkdir "$lngPath/${synoLang}"
            chmod 777 "$lngPath/${synoLang}"
            chown :users "$lngPath/${synoLang}" 
          fi
        fi
      else # lng in file name
        #targetFile=$(echo "$sourcefile" | sed "s/_$sourceSynoLang/_$synoLang/")
        targetFile=${sourcefile/_$sourceSynoLang/_$synoLang}
        # echo "Language in Name: $sourcefile ==> $targetFile"
      fi
      uptodateFile=0
      if [[ -f "$targetFile" ]]; then
        timeStampDest=$(stat -c %Y "$targetFile")
        if [[ "$timeStampDest" -gt "$timeStampSource" ]]; then # up to date
          echo "up to date: $targetFile" | tee -a "$LOG"
          uptodateFile=1
        else
          echo "too old: $targetFile" | tee -a "$LOG"
          if [[ "$bExec" -ne "0" ]]; then
            rm "$targetFile"
          fi # bExec          
        fi # timeStamp
      else
        echo "not yet existing: $targetFile" | tee -a "$LOG"
      fi # target exists else
      if [[ "uptodateFile" -eq "0" ]]; then
        echo "translating $sourcefile ==> $targetFile ..." | tee -a "$LOG"
        val=$(<"$sourcefile")
        param="target_lang=$targetIsoLang&source_lang=$sourceIsoLang&tag_handling=html"        
        if [[ "$bExec" -ne "0" ]]; then
          translatedraw=$(curl -Gs "$deepl_url" --data-urlencode "text=$val" -d "$param")
          res=$? 
          if [ $res -eq 0 ]; then # If the curl above was sucessful
            # echo "Response from DeepL: $translatedraw" | tee -a "$LOG"
            # Get the translated text from the JSON response:
            translated=$(echo "$translatedraw" | jq --compact-output '.translations[0].text')
            translated=${translated#\"} # remove quote at string start
            translated=${translated%\"} # remove quote at string end
            #printf %s "$translated" > "${targetFile}_extracted"
            # echo "to $synoLang translated $sourcefile:" | tee -a "$LOG"
            translated=$(urldecode "$translated") 
            # echo "$translated"
            if [[ ! -v translated ]] || [[ -z "$translated" ]]; then
              echo "======================================================="
              echo "DeepL Response Problem: " | tee -a "$LOG"
              echo "source: $sourcefile" | tee -a "$LOG"
              echo "DeepL Response: " | tee -a "$LOG"
              echo "$translatedraw" | tee -a "$LOG"
              echo "======================================================="
              echo "stopped!" | tee -a "$LOG"
              exit 2  
            fi
            # tr2="$(echo "$translated" | sed -e 's|\"|\\"|g' -e 's|\$|\\$|g' )"
            
            # In e.g. '<html class="img-no-display" lang="EN">' we need to change the lang="..." to the target
            translated="$(echo -e "$translated" | sed "/<html /s/lang=\"$sourceIsoLang\"/lang=\"$targetIsoLang\"/i")"
              # sed '/<html /s/.../.../' if the line contains "<html " then try to do the substitution

            # translated="$(echo -e "$translated" | sed -z 's/^"//' | sed -z 's/"$//')" # If enclosed with Quotes, remove them!
            # sed -z and anchor $ is not working for last character as no NULL followed!
            translated="${translated#\"}" # If enclosed with Quotes, remove them!
            translated="${translated%\"}"

            echo -e "$translated" | tee -a "$targetFile" | tee -a "$LOG"
            chmod 777 "$targetFile"
            chown :users "$targetFile" 
            sed -i 's/\\"/"/g' "$targetFile" # quotes are escaped, don't know why. Unescape now all quotes!

          else # If the curl above was NOT sucessful
            echo "==== The request failed: $res ====" | tee -a "$LOG"
            exit 1
          fi
        else
          echo "Simulation '$sourcefile' ==> '$targetFile'" | tee -a "$LOG"
        fi # if [[ "$bExec" -ne "0" ]]       
        echo "... $targetFile done!" | tee -a "$LOG"
      fi # not up to date
    done # for synoLang in $synoLangs; do
  done # for sourcefile in $htmlfiles; do
fi # translateHtml

######################################
if [[ "$translateHelpToc" -ne "0" ]]; then
  # translation of lines with '""text":":' in helptoc.xxx files:
  echo -e "\nhelptoc.xxx Translation:" | tee -a "$LOG"
  filePath="package/ui/.helptoc/SYNO.SDS._ThirdParty.App.$app_name"
  sourcefile="$filePath/helptoc.$sourceSynoLang"
  if [[ "$bUpdateAll" -ne "0" ]]; then
    timeStampSource=$(date +%s)
  else
    timeStampSource=$(stat -c %Y "$sourcefile")
  fi
  for synoLang in $synoLangs; do
    targetIsoLang="${SYNO2ISO[$synoLang]}"
    targetFile="$filePath/helptoc.$synoLang"
    echo -e "\nprocessing source='$sourcefile', target='$targetFile'" | tee -a "$LOG"
    uptodateFile=0
    if [[ -f "$targetFile" ]]; then
      timeStampDest=$(stat -c %Y "$targetFile")
      if [[ "$timeStampDest" -gt "$timeStampSource" ]]; then # up to date
        echo "up to date: $targetFile" | tee -a "$LOG"
        uptodateFile=1
      else
        echo "too old: $targetFile" | tee -a "$LOG"
        if [[ "$bExec" -ne "0" ]]; then
          mv "$targetFile" "${targetFile}old"
        fi # bExec
      fi # timeStamp
    else
      echo "not yet existing: $targetFile" | tee -a "$LOG"
    fi # target exists else
    if [[ "$uptodateFile" -eq "0" ]]; then
      echo -e "\ntranslating lines of $targetFile ..." | tee -a "$LOG"
	  source="$(cat "$sourcefile" | sed -z -e 's/\",\"/\"\n,\"/g' -e 's/},{/}\n,{/g')" # insert line breaks
	  mapfile -t lines  < <(printf '%s' "$source")
      lineCount=0
      # while read -r lineSourceNew; do # read all settings from file
	  for lineSourceNew in "${lines[@]}";do
        # echo "lineSourceNew='$lineSourceNew'"
        lineCount=$((lineCount+1))
        val=""
        if [[ ${lineSourceNew} == *"\"text\":"* ]] && [[ ${lineSourceNew} != *"\"Autorun\""* ]]; then
          prefix=${lineSourceNew%%:*} # ',"text"' or '"text"'
          val="${lineSourceNew#*:}" # e.g. "Security",
          echo "raw val='$val'" | tee -a "$LOG"
          postfix="${val##*\"}" # e.g. trailing comma
          val="${val%\"*}"
          val="${val#*\"}"
          echo "postfix='$postfix', remaining='$val'" | tee -a "$LOG"
        fi
        if [[ -n $val ]]; then
          if [[ "$bExec" -ne "0" ]]; then
            preparedsource="$val"
            # echo "$synoLang $targetIsoLang: '$source' '$preparedsource'" | tee -a "$LOG"
            param="target_lang=$targetIsoLang&source_lang=$sourceIsoLang"
            translatedraw=$(curl -Gs "$deepl_url" --data-urlencode "text=$preparedsource" -d "$param")
            res=$?
            if [ $res -eq 0 ]; then # If the curl above was sucessful
              # Get the translated text from the JSON response:
              translated=$(echo "$translatedraw" | jq --compact-output '.translations[0].text') # in double quotes
              translated=${translated#\"} # remove quote at string start
              translated=${translated%\"} # remove quote at string end
              translated=$(urldecode "$translated")
              if [[ ! -v translated ]] || [[ -z "$translated" ]]; then
                echo "======================================================="
                echo "DeepL Response Problem: " | tee -a "$LOG"
                echo "source: '$preparedsource'" | tee -a "$LOG"
                echo "raw: '$translatedraw'" | tee -a "$LOG"
                echo "translated: '$translated'" | tee -a "$LOG"
                echo "======================================================="
                echo "stopped!" | tee -a "$LOG"
                exit 2
              fi
              tr2="$(echo "$translated" | sed -e 's|\"|\\\\"|g' -e 's|\$|\\\\$|g' )"
              echo "$synoLang $targetIsoLang: $tr2" | tee -a "$LOG"
              echo "${prefix}:\"${tr2}\"${postfix}" >> "$targetFile"
            else # If the curl above was NOT sucessful
              echo "The translation request failed: curl code $res, result:'$translatedraw'" | tee -a "$LOG"
              # https://really-simple-ssl.com/curl-errors/
              if [[ "$res" -eq "28" ]]; then
                echo "28: Connection timed out" | tee -a "$LOG"
              elif [[ "$res" -eq "60" ]]; then
                echo "60: unable to get local issuer certificate" | tee -a "$LOG"
              elif [[ "$res" -eq "60" ]]; then
                echo "35: SSL connect error" | tee -a "$LOG"
              fi
              exit 1
            fi # if [ $res -eq 0 ] else
          else # only simulation
            echo "source lineSourceNew: '$lineSourceNew'" | tee -a "$LOG"
            echo "to translate: '$val'" | tee -a "$LOG"
            echo "result line: '${prefix}: \"XXXX\"${postfix}'" | tee -a "$LOG"
          fi # translate or simulate
        else # $val empty: copy lineSourceNew unchanged:
          if [[ "$bExec" -ne "0" ]]; then
            echo "$lineSourceNew" >> "$targetFile"
          fi
        fi
      done # < "$sourcefile" # while read: Works well even if last line has no \n!
      chmod 777 "$targetFile"
      chown :users "$targetFile"
      echo "... $targetFile done!" | tee -a "$LOG"
      if [[ -f "${targetFile}old" ]]; then
        rm "${targetFile}old"
      fi
    fi # not uptodateFile
  done # for synoLang in $synoLangs; do
fi # translateHelpToc


echo "... Translation script done!" | tee -a "$LOG"
echo "Hint: The README.xxx.md there is no translation included in the script!"