Creating language file

If you want to create a language file in your native language you have to follow these steps:

• First download the latest english language file out of the git.

• Now you can start your translation. It is possible to type in characters like ä, ü, â, é (umlaut, accent, etc.) but be aware of the charakter ' this has to be escaped. For Example: This is 'IPFire' Version 2.5 has to typed in as: This is /'IPFire/' Version 2.5.

If your are done you may test it in your own IPFire system:

• copy your language file to /var/ipfire/langs/XX.pl (e.g. french: /var/ipfire/langs/fr.pl)
• then open file /var/ipfire/langs/list with your favorit editor and enter your language.

en:English:Englisch
de:German:Deutsch 
fr:French:Französisch

• Now you have to update the langauge cache. Connect via ssh to your IPFire and typ the following command:

perl -e "require '/var/ipfire/lang.pl'; &Lang::BuildCacheLang"

• You have to do this, after any changes your made of your language file to see your inserts on the webinterface, that is pretty annoying - a faste way during testing is to delete the cache files (e.g. cache-lang.pl.en) then IPFire will read everytime directly out of the pl file.

• To change the webinterface to your new language just go to GUI and select your language from the pull-down-menu.

If you have changed the language and you get Internal Server Error when you try to reach the webinterface, then there is something wrong in your language file. With the command:

tail /var/log/httpd/error_log

your are able to read out what is wrong.

To get the webinterface back to work, you may edit the file: /var/ipfire/main/settings there you will find a line starting with LANGUAGE= just get back to english language by entering:

LANGUAGE=en

and all will work fine again.