Language

Menu Project – Language.

This lets a visualization run in several languages. Switching over is done later with the control element Language switch.

Procedure

1. First create the visualization as usual in the original language.
2. Under Project – Language add the required languages with the button +. Language and Code are entered (e.g. German / DE). The original language gets an entry as well – its CSV of course does not have to be translated.
3. Select a language and write the CSV file with Export. It contains all the texts that occur in the visualization.
4. Translate the CSV.
5. Select the language again and read the translated file in with Import.

With Delete a language is removed again.

All languages in one file

With All next to the Import and Export buttons all languages are written to or read from one CSV file at once. This allows editing the translations side by side.

• Export All: The first column holds the text from the visualization, followed by one column per language. The column heading is the language code (e.g. de, en). Texts that are still missing in a language are initially filled with the original text.
• Import All: The language columns of the file are read. Existing languages are replaced, languages that do not exist yet are created – a confirmation with the list appears first. The column headings must not be changed for this. An empty field counts as not translated: the original text stays there. A file that contains only one language is not read here – select the language and use Import instead.

The import of a single language also reads a file with several languages: it takes the column of the selected language. Files from the previous export of a single language can still be read in unchanged.

The CSV file

The first line is the column heading and stays unchanged. After that the first column holds the text from the visualization, the translation goes into the second column. File format UTF-8, line ending LF.

If the visualization is changed later, the export appends the new texts at the end of the existing file – so only the additions have to be translated.

System texts

The CSV only contains those texts that were entered in the visualization itself. The system texts of the software are not included; they only exist in German and English, that is in the languages available in the Studio under Extras – Language.

System texts can however be entered into the CSV by hand. If for example the control element System settings contains the texts “Brightness”, “Volume” and “Language”, these are simply appended as further lines and translated. After the import and after switching the language they appear translated as well.

Tip: The text has to be written exactly as it appears in the dialog – otherwise the switch does not find it.