Prusa-Firmware/lang
2021-04-23 20:11:49 +02:00
..
po Update po files 2021-03-01 08:46:16 +01:00
Add_new_language.md Update 2021-03-01 08:33:32 +01:00
config.sh Allow to customize OUTDIR in config.sh 2021-04-23 12:15:48 +02:00
fw-build.sh Move Dutch language parts 2021-03-01 08:28:08 +01:00
fw-clean.sh Move Dutch removing part to correct loaction 2021-03-22 18:33:43 +01:00
iso639-1.txt Lang update, french translation 2018-09-11 03:43:05 +02:00
lang_en_cz.txt Fix MSG_SELFTEST_WIRINGERROR to c=18 2021-04-23 13:29:45 +02:00
lang_en_de.txt Fix typo thanks to @wavexx 2021-04-23 14:20:28 +02:00
lang_en_es.txt Fix MSG_SELFTEST_WIRINGERROR to c=18 2021-04-23 13:29:45 +02:00
lang_en_fr.txt Fix MSG_SELFTEST_WIRINGERROR to c=18 2021-04-23 13:29:45 +02:00
lang_en_it.txt Update Italian translations 2021-04-23 15:47:48 +02:00
lang_en_nl.txt Fix Dutch FINDA translation 2021-04-23 16:19:33 +02:00
lang_en_pl.txt Fix MSG_SELFTEST_WIRINGERROR to c=18 2021-04-23 13:29:45 +02:00
lang_en.txt Fix MSG_SELFTEST_WIRINGERROR to c=18 2021-04-23 13:29:45 +02:00
lang-add.sh Move Dutch language parts 2021-03-01 08:28:08 +01:00
lang-build.sh Merge remote-tracking branch 'upstream/MK3_3.10.0' into PFW-1189 2021-04-22 20:43:54 +02:00
lang-check.py lang-check: handle backslash sequences 2021-04-23 16:15:24 +02:00
lang-check.sh MK3 3 9 0 missing translations (#2646) 2020-05-12 22:23:40 +02:00
lang-clean.sh Move Dutch language parts 2021-03-01 08:28:08 +01:00
lang-community.sh Add template 2021-03-01 08:41:31 +01:00
lang-export.sh Fix indentation 2021-03-01 08:39:26 +01:00
lang-import.sh Move Dutch language parts 2021-03-01 08:28:08 +01:00
progmem.sh Fix shifted languages. Use \n and \x0a 2019-07-26 18:53:08 +03:00
readme.txt New ML support - progmem.sh + readme.txt 2018-05-22 03:33:29 +02:00
textaddr.sh Automate secondary language support build. 2018-11-26 20:24:24 +01:00
translations.md Update workflow 2021-02-25 12:27:30 +01:00
update_lang.sh Automate secondary language support build. 2018-11-26 20:24:24 +01:00

Nova podpora vice jazyku ve firmware


Zmeny oproti stavajicimu frameworku:
1. Deklarace lokalizovanych textu primo v kodu, neni nutne udrzovat tabulky.
2. Zatim dvoj jazycna verze (en_cz, en_de atd). Moznost rozsirit na vicejazycnou (en_cz_de - pro MK2).
3. Moznost vyberu druheho jazyka ulozeneho v SPI flash (nebude zabirat misto v interni flash, pouze MK3).
5. Bash postbuild proces namisto perloveho skriptu + nastroje na spravu slovniku.

Popis:
Novy framework je trochu podobny jako znamy i18n20, ale sity na miru pro AVR atmega s ohledem na maximalni jednoduchost a usporu interni flashe.
Stringy ktere maji byt prelozene se deklaruji pomoci specialnich maker, zbytek obstara postbuild.
Vsechny lokalizovane texty se nachazi ve specialni sekci, v pripade AVR musi byt stringy umisteny v dolnich 64kB flash - tzv 'progmem'.
Po zbuildovani arduinem bude fungovat pouze anglictina, je treba spustit postbuild ktery na zaklade slovniku doplni data sekundarniho jazka a vytvori modifikovany hexfile.
Jedina data ktera je treba udrzovat jsou slovniky pro preklad. Jsou to textove soubory kde je vzdy sparovan anglicky text s prelozenym textem.
Kazdy text ve slovniku je jeden radek, muze obsahovat specialni znaky v hexadecimalni podobe (e.g. '\x0a'). Nasledujici radek je vzdy prelozeny text.
Tento jednoduchy format je zvolen proto aby bylo mozno slovniky a proces prekladu spravovat jen pomoci gitu a nekolika skriptu.

Pokud pridame nebo zmenime nejaky text v kodu, zmeni se po zbuildovani a spusteni nastroje 'update.sh' soubor lang_en_code.txt.
To je generovany soubor ktery obsahuje vsechny lokalizovane texty pouzite v kodu setridene podle abecedy.
V gitu uvidime zmenu kterou rucne preneseme do slovniku lang_en_xx.txt, zaroven vytvorime pozadavek na preklad ci korekturu pozadovaneho textu.
Pokud pridame nebo zmenime nejaky text ve slovnikach, zmeni se po spusteni nastroje 'update.sh' soubor lang_en_dict.txt.
Ten obsahuje vsechny lokalizovane texty ze slovniku (v anglictine), respektive mnozinu jejich sjednoceni.
V idealnim pripade by soubory lang_en_code.txt a lang_en_dict.txt mely byt totozne.
Pokud se zmeni slovnik, je treba znovu vygenerovat binarni soubory lang_en_xx.bin.


Pouziti v kodu, priklady:

1. deklarace lokalizovaneho textu v kodu - makro '_i':
puts_P(_i("Kill all humans!")); //v cz vypise "Zabit vsechny lidi!"

2. deklarace lokalizovaneho textu jako globalni konstanty - makro 'PROGMEM_I1' a 'ISTR':
const char MSG_PREHEAT[] PROGMEM_I1 = ISTR("Preheat"); //deklarace
puts_P(get_translation(MSG_PREHEAT)); //v cz vypise "Predehrev"

3. fukce get_translation - zkratka makro '_T':
puts_P(_T(MSG_PREHEAT)); //v cz vypise "Predehrev"

4. deklarace lokalizovaneho textu jako lokalni promenne - makro '_I':
const char* text = preheat?_I("Preheat"):_I("Cooldown");
puts_P(_T(text)); //v cz vypise "Predehrev" nebo "Zchlazeni"

5. deklarace nelokalizovaneho textu - makro 'PROGMEM_N1' a '_n' nebo '_N':
const char MSG_MK3[] PROGMEM_N1 = "MK3"; //deklarace
const char* text = _n("MK3");
 nebo
const char* text = _N("MK3");