Translating Kunena

From Kunena

Jump to: navigation, search

Contents

Where to find Kunena translations

Our official language pack can be found in our download page. Please read also K 1.7 Language Support.
Review the available translations at the kunena.com web site, currently
http://www.kunena.com/forum/107-translations
Or you can find new translations in the KED
http://www.kunena.com/ked/translations

Kunena 1.7

Translating Kunena

Use Transifex

Kunena project uses Transifex to maintain all available translations. Transifex provides easy to use online tools, which can be used to update translations easily and without any technical knowledge. Alternatively Transifex allows you to download the current translation and update it with your favorite tool. It also allows anyone to download the most current version of any translated file.

Downloaded files can be manually installed to your Joomla site. Please read Where is the language file? for more information.

Having your language in Transifex is the only way to get it into Kunena distribution. For information how to use transifex read the wiki article about Transifex.

There are some bugs in Transifex Joomla support, so please check these:

  • NEVER use double quotes (") in your translation; use single quotes instead (also in HTML tags)
  • If you edit files by hand, make sure that it uses Unix encoding (\n), not Windows (\r\n) or Mac (\r) before uploading the files back to Transifex

Create language pack for your language (Joomla! 1.7 & 2.5)

Please read Creating language packs for extensions in Joomla 1.6/1.7 on how to create installation package for the new versions of Joomla.

Replace the old manifest file with the new one (see above link). Otherwise the steps are the same as in Joomla 1.5 below.

WARNING Do not use existing Joomla! 1.5 manifest file (xx-XX.com_kunena.xml) in Joomla! 1.7 & 2.5 sites. Doing so has some unfortunate effects, like removing Kunena language removes the language from the whole site.

Create language pack for your language (Joomla! 1.5)

To create installable language file, you just have to follow these steps:

  • Get the latest core language files from Transifex if you don't have them
  • Download latest Kunena language pack
  • Take your language from the language pack (language/com_kunena.xx-XX_site_v1.7.x.zip & language/com_kunena.xx-XX_admin_v1.7.x.zip)
  • Extract the language files to separate folders (you can call them admin & site)
  • Copy updated files to the above folders and rename them to replace the original files
  • Create ZIP archive from both admin & site (please use the same name as we did)
  • Install both ZIP files with the Joomla! installer and make sure that your translation works
  • Publish your translation. There are 3 ways:

What is allowed in .ini files

Comments are made by a leading ";"

With a leading "#" the language file won't work in Joomla! 1.7. Please note that all your comments will disappear when file is uploaded to Transifex.

The translated string has to be encosed by double quotes
COM_KUNENA_A_TEMPLATE_MANAGER_COULD_NOT_WRITABLE="Could not make the template parameter file writable"
Do not split translations into multiple lines (only first line will show up)
COM_KUNENA_A_TEMPLATE_MANAGER_COULD_NOT_WRITABLE="Could not make the
template parameter file writable"
If you want a new line, write
<br />

for example 

COM_KUNENA_A_TEMPLATE_MANAGER_COULD_NOT_WRITABLE="Could not make the <br /> template parameter file writable"
Make your translations to be valid XHTML 1.0 
 Not <br>, not <br/> - only <br /> is valid

If unsure, please use the same markup as we do.

Files must be saved in UTF-8
Please do not use Double Quotes (") in your translation, it will break the translation.
Retrieved from "http://docs.kunena.org/index.php/Translating_Kunena"