Translating

This guide is about translating WackoWiki to another language.

WackoWiki‘s userinterface can be configured to use any language by setting the appropriate option. Have a look in the lang/ directory to see which languages are already available. To translate WackoWiki to your own language, copy the lang/en/ directory to a new one named after your two-letter ISO language code.

1. Supported Languages

#	Language tag	User Documentation	Localization	Locale	Maintainer
1	bg	Български	((!/bg ))	bg_BG.UTF-8
2	da	Danish	Danish	da_DK.UTF-8
3	de	Deutsch	Deutsch	de_DE.UTF-8	WikiAdmin
4	el	Ελληνικά	Ελληνικά	el_GR.UTF-8	Evaggelos Balaskas
5	en	English	English	en.UTF-8	brianko
6	es	Español	Español?	es_ES.UTF-8	KlePy
7	et	Eesti	((!/et ))	et_EE.UTF-8
8	fa	فارسی	((!/fa ))	fa_IR.UTF-8
9	fr	Français	Français	fr_FR.UTF-8
10	hi	हिन्दी	((!/hi ))	hi_IN.UTF-8
11	hu	Magyar	((!/hu ))	hu_HU.UTF-8
12	it	Italiano	((!/it ))	it_IT.UTF-8
13	ja	日本語	((!/ja ))	ja_JP.UTF-8
14	ko	한국어	((!/ko ))	ko_KR.UTF-8
15	nl	Nederlands	((!/nl ))	nl_NL.UTF-8
16	pl	Polski	((!/pl ))	pl_PL.UTF-8
17	pt	Português	((!/pt ))	pt_PT.UTF-8
18	ru	Русский	((!/ru ))	ru_RU.UTF-8	Elar9000
19	ta	தமிழ்?	தமிழ்	ta_IN.UTF-8	தமிழ் நேரம்
20	zh	简体中文	简体中文	zh_CN.UTF-8	qianmengnet
21	zh-tw	正體中文	((!/zh-tw ))	zh_TW.UTF-8

Important: Please note that we have not verified those translations. If you believe that a translation is false or misleading, please contact us.

2. Message sets

WackoWiki supports the fi and pt-br language tag sub-code scheme in the language file name, only lower case characters are allowed.

2.1. Locations

Message sets can be found under the following locations:

Repo: https://bitbucket.org/wackowiki/wackowiki/

wacko/

admin/lang/
js/lang/
lang/
setup/lang/
theme/yourtheme/lang/

2.2. To Localize

Please check your language files whether the following message sets have yet to be translated into your language or whether the wording can be improved.

2.2.1. Main

lang/

lang/wacko.en.php - default language file

default language definition

'lang_scheme'	=> [
	'name'		=> 'English',
	'code'		=> 'en',
	'dir'		=> 'ltr',
	'locale'	=> 'en_US.UTF-8',
],

2.2.2. Installer

setup/lang/

setup/lang/inserts.en.php
setup/lang/installer.en.php – default language file

2.2.3. Admin panel

admin/lang/

admin/lang/ap.en.php – default language file

2.2.4. JavaScript

js/lang/

js/lang/wikiedit.en.js – default language file

2.2.5. Theme

theme/

theme/yourtheme/lang/ – default language file

3. Help to improve translation

Translate WackoWiki into your language. — WackoWiki translations progress at Crowdin

Don't see your native language here? Is a translation incomplete or improper?

If your ability in English is sufficient to produce high-quality translations of English texts in a formal style, you can volunteer to translate WackoWiki.

Forum: Translation

you want to start a new translation or continue an existing one and you want to avoid duplicating your work with someone else
you're looking for other people who want to work with you on translating
you're having technical questions about tools, the source tree, the meaning of terms, etc.

Localizations

Send us your translations or corrections via E-Mail, Bugtracker, Pullreqest or add them at Crowdin.

3.1. Online Translation

translate a source string — Computer Assisted Translation

Register and login at Crowdin

translate
proofread

If you'd like a new language to be added to Crowdin, for you to be able to provide translations for, please open a new issue here.

4. Documentation

Core pages to translate

#	Page	Languages
1	Features	de, es, fr, ru, zh
2	Requirements	de, es, fr, ru, zh
3	Installation	de, es, fr, ru, zh
4	Upgrade	de, es, fr, ru, zh
5	Configuration	de, es, fr, ru
6	Themes	de, es, fr, ru, zh
7	Formatting	de, es, fr, ru, zh
8	Actions	de, es, fr, ru, zh
9	Access Control	de, es, fr, ru, zh
10	Admin Panel	de, es, fr, ru, zh
11	WikiConcept	de, es, ru
12	Markup	de, es, ru, zh
13	Wabi-sabi	de, es, fr, ru, zh
14	File Permissions	de, es, ru, zh
15	Localizations

It is desirable to have all essential pages available at least in Chinese, German, English, French, Russian and Spanish.

5. Localize your action, handler or module

5.1. Action and Handler

lang/wacko.en.php

'UserName'	=> 'User name',

usage

<?php

echo $this->_t('UserName');

5.2. Template

pull in templates

 [ ' _t: UserName ' ]

5.3. Admin Panel

admin/lang/ap.en.php

'BackupCompleted'	=> 'Backing up and archiving completed.<br>' .
	'The Backup package files were stored in the sub-directory %1.<br>' .
	'To download it use FTP (maintain the directory structure and file names when copying).<br>' .
	'To restore a backup copy or remove a package, go to <a href="%2">Restore database</a>.',