Skip to content

Latest commit

 

History

History

i18n

README.md

Adding a language

Thank you for considering adding an additional translation to Video Hub App!

Translations take seconds using the Google Translation API and the translate-json-object library, but it does require a Google Cloud API key (please use your own).

Simply cd i18n, edit the translate.js file there to include your key and the target language abbreviation (e.g. en), and run (node translate.js).

For abbreviations please choose a 2-letter abbreviation that is on both lists:

After generating the json you may open a pull request or first integrate it into the app.

Integrating the language into the app

You're welcome to open a Pull Request as is (with just the new .json file) and I'll implement the language into the app. Alternatively, you can edit just a few more files and you'll be ready! It's rather easy -- just follow the patterns! Just edit these three files:

app-state.ts

Add the two-letter abbreviation to the type, e.g.

export type SupportedLanguage = 'en' | 'ru' | 'fr';

settings.component.html

Add the language to the dropdown in settings.component.html, e.g.

<option value="en" [selected]="appState.language == 'en'">English</option>
<option value="ru" [selected]="appState.language == 'ru'">Русский</option>
<option value="fr" [selected]="appState.language == 'fr'">Française</option>

languages.ts

Import the file into languages.ts with the other imports, e.g.

const English    = require('../../../i18n/en.json');
const Russian    = require('../../../i18n/ru.json');
const French     = require('../../../i18n/fr.json');

Update the languageLookup method, e.g.

  'en': English,
  'fr': French,
  'ru': Russian,

Updating all language files

The update.js script will translate and add any new key-value pairs found in en.json into any of the translation files. It will also remove any key-value pairs that are not found in en.json from the translated file.