Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Language support for languages other than DE and EN (L10N)

raspiBackupInstallUI and raspiBackup initially wrote messages in German and English only. But both are able to write messages in any language from a coding point of view (I18N). Anybody who is willing to help to add support for a new language not already supported is welcome to translate raspiBackup messages.

Just add your interest in an issue on GitHub and you will immediate get individual support to add new messages in your native language to raspiBackupInstallUI and raspiBackup.

Right now following languages are supported:

  • ZH - Chinese
  • EN - English
  • FI - Finnish
  • FR - French
  • DE - German

Basic activities to add a new language to raspiBackup

There exist two files which write messages: raspiBackup and raspiBackupInstallUI.

Following steps have to be done to support a new language to raspiBackupInstallUI and raspiBackup:

  1. For every message a new line in the code for the new language has to be added. Example for FI:

    MSG_RUNASROOT=2
MSG_EN[$MSG_RUNASROOT]="RBK0002E: $MYSELF has to be started as root. Try 'sudo %s%s'."
MSG_DE[$MSG_RUNASROOT]="RBK0002E: $MYSELF muss als root gestartet werden. Benutze 'sudo %s%s'."
MSG_FI[$MSG_RUNASROOT]="RBK0002E: $MYSELF tulee käynnistää root-oikeuksin. Suorita 'sudo %s%s'."

    The line starting with MSG_FI was added in order to support Finnish. FI are the first two characters of the variable $LANG on a system which uses FI as system language.

    Example for a German system:

    echo $LANG
de_DE.UTF-8

    and that's why MSG_DE is used.

  2. The help text in raspiBackup may optionally also be translated. For every language a bash function usageLL() may be created which has to follow bash syntax. Just use the existing function usageEN as a template.

  3. Finally to enable the new language the following line in the code has to be updated:

    SUPPORTED_LANGUAGES=("EN" "DE")

    To enable Finnish the line has to be changed changed to

    SUPPORTED_LANGUAGES=("EN" "DE" "FI")

Note

Don't hesiate if you're willing to add a new language to raspiBackup even you don't have any programming experience. You don't have to fiddle with the programmins stuff. That's handled by raspiBackup developers. You have only execute above step 1 for all existing messages and translate them into your native language. You even don't have to create a PR to get the new language into raspiBackup. All this will be handled by raspiBackup developers for you.