Translations

The WebUI unfortunatly does not support UTF8, so for special character specific to the language like : ¡ í á ó
please refere to : specialcharacters.php and wiki

Language currently supported

English (en) : 100% Here

French (fr) : 72% Here

German (de): 72% Here

Hungarian: (hu) 99% Here

Italian : (it) 72% Here

Spanish : (es) 72% Here

Polish : (pl) 87% Here

Russian: (ru) 87% Here

Ukrainian: (uk) 87% Here

Portuguese-Br: (ptbr) 97% Here

Chinese (simplified) (zh_CN): 99% Here

Chinese (traditional) (zh_TW): 99% Here

Japanese (ja): 99% Here

Turkish: (tr) 97% Here

How to translate

• Translate the right side only if necessary
• Check language.tpl if any update
• Submit Issue or PR with modified file

Note: English is the reference but it can be adjusted if necessary, just add the corresponding reference to the english file.

To add a new language :

The template file is here

• Change lang to the proper local descriptor
• Translate the right side only
• Submit Issue with modified file (do not do PR as another file need to be updated)

Compilation

To be able to generate file from sources you need to install nodejs, gulp and some addons.
1 - Install current nodejs LTS (v10.15.3)
2 - Install gulp-cli globaly npm install --global gulp-cli
3 - Install gulp globaly npm install --global gulp@4.0.0
4 - Install all addons npm install

You should have something like this :

E:\github\ESP3D-WEBUI>node -v
v10.14.0

E:\github\ESP3D-WEBUI>gulp -v
[22:17:03] CLI version 2.0.1
[22:17:03] Local version 4.0.0

E:\github\ESP3D-WEBUI>npm -v
6.4.1

5 - Do the code modification you want, then launch gulp package.

E:\github\ESP3D-WEBUI>gulp package
[15:17:13] Using gulpfile E:\github\ESP3D-WEBUI\gulpfile.js
[15:17:13] Starting 'package'...
[15:17:13] Starting 'clean'...
[15:17:13] Finished 'clean' after 5.6 ms
[15:17:13] Starting 'lint'...
[15:17:13] Finished 'lint' after 144 ms
[15:17:13] Starting 'Copy'...
[15:17:13] Finished 'Copy' after 21 ms
[15:17:13] Starting 'concatApp'...
[15:17:14] Finished 'concatApp' after 53 ms
[15:17:14] Starting 'includehtml'...
[15:17:14] Finished 'includehtml' after 7.91 ms
[15:17:14] Starting 'includehtml'...
[15:17:14] Finished 'includehtml' after 6.18 ms
[15:17:14] Starting 'replaceSVG'...
[15:17:14] Finished 'replaceSVG' after 5.36 ms
[15:17:14] Starting 'minifyApp'...
\style.css: 125691
\style.css: 102958
[15:17:16] Finished 'minifyApp' after 2.2 s
[15:17:16] Starting 'smoosh'...
[15:17:16] Finished 'smoosh' after 117 ms
[15:17:16] Starting 'compress'...
[15:17:16] Finished 'compress' after 26 ms
[15:17:16] Starting 'clean2'...
[15:17:16] Finished 'clean2' after 3.83 ms
[15:17:16] Finished 'package' after 2.61 s

If no issue, a file called index.html.gz will be generated at the root of repository, so you just need to upload it like described in installation page

By default is build a multilanguage file, if file is too big for your flash size you can build with only english and one additional language:

• gulp package --lang en will only build english
• gulp package --lang fr will only build french + english
• gulp package --lang es will only build spanish + english
• gulp package --lang it will only build italian + english
• gulp package --lang de will only build german + english
• etc…