WackoWiki: Translating

https://wackowiki.org/doc     Version: 232 (04/08/2025 02:02)

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[link1].


Unicode

1. Supported Languages

Encoding: UTF-8

# Language tag User Documentation Localization Locale Maintainer
1 ar العربية العربية[link2] ar_EG
2 bg Български ((!/bg )) bg_BG
3 cs Čeština ((!/cs )) cs_CZ
4 da Dansk Danish[link3] da_DK
5 de Deutsch[link4] Deutsch[link5] de_DE WikiAdmin[link6]
6 el Ελληνικά[link7] Ελληνικά[link8] el_GR Evaggelos Balaskas[link9]
7 en English[link10] English[link11] en_US brianko[link12]
8 es Español[link13] Español es_ES KlePy[link14]
9 et Eesti ((!/et )) et_EE
10 fa فارسی ((!/fa )) fa_IR
11 fi Suomi ((!/fi )) fi_FI
12 fr Français[link15] Français[link16] fr_FR
13 hi हिन्दी[link17] ((!/hi )) hi_IN
14 hu Magyar[link18] ((!/hu )) hu_HU
15 id Bahasa Indonesia Bahasa Indonesia[link19] id_ID
16 it Italiano[link20] ((!/it )) it_IT
17 ja 日本語[link21] ((!/ja )) ja_JP
18 ko 한국어[link22] ((!/ko )) ko_KR
19 nl Nederlands[link23] ((!/nl )) nl_NL
20 no Norsk ((!/no )) no_NO
21 pl Polski[link24] ((!/pl )) pl_PL
22 pt Português[link25] ((!/pt )) pt_PT
23 pt-br Português-Brazil ((!/pt-br )) pt_BR
24 ro Romainiană ((!/ro )) ro_RO
25 ru Русский[link26] ((!/ru )) ru_RU Elar9000[link27]
26 ta தமிழ் தமிழ்[link28] ta_IN தமிழ் நேரம்
27 sv Svenska ((!/sv )) sv_SE
28 uk Українська ((!/uk )) uk_UA
29 zh 简体中文[link29] 简体中文[link30] zh_CN qianmengnet[link31]
30 zh-tw 正體中文[link32] ((!/zh-tw )) zh_TW

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

2. Message sets

WackoWiki supports the fi and pt-br language tag sub-code[link34] 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/[link35]
  1. admin/lang/
  2. js/lang/
  3. lang/
  4. setup/lang/
  5. 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/[link36]
  1. lang/wacko.en.php - default language file
    • default language definition 
      'lang_scheme'	=> [
	'name'		=> 'English',
	'code'		=> 'en',
	'dir'		=> 'ltr',
	'locale'	=> 'en_US',
],

2.2.2. Installer


setup/lang/[link37]
  1. setup/lang/inserts.en.php
  2. setup/lang/installer.en.php – default language file

2.2.3. Admin panel


admin/lang/[link38]
  1. admin/lang/ap.en.php – default language file

2.2.4. JavaScript


js/lang/[link39]
  1. js/lang/wikiedit.en.js – default language file

2.2.5. Theme


theme/[link40]
  1. 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[link33]
  1. you want to start a new translation or continue an existing one and you want to avoid duplicating your work with someone else
  2. you're looking for other people who want to work with you on translating
  3. you're having technical questions about tools, the source tree, the meaning of terms, etc.



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[link42]

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[link33].

4. Documentation


Core pages to translate

# Page Languages Notes
1 Features[link43] de[link44], es[link45], fr[link46], ru[link47], zh[link48]
2 Requirements[link49] de[link50], es[link51], fr[link52], ru[link53], zh[link54]
3 Installation[link55] de[link56], es[link57], fr[link58], ru[link59], zh[link60]
4 Upgrade[link61] de[link62], es[link63], fr[link64], ru[link65], zh[link66]
5 Configuration[link67] de[link68], es[link69], fr[link70], ru[link71]
6 Themes[link72] de[link73], es[link74], fr[link75], ru[link76], zh[link77]
7 Formatting[link78] de[link79], es[link80], fr[link81], ru[link82], zh[link83]
8 Actions[link84] de[link85], es[link86], fr[link87], ru[link88], zh[link89]
9 Access Control[link90] de[link91], es[link92], fr[link93], ru[link94], zh[link95]
10 Admin Panel[link96] de[link97], es[link98], fr[link99], ru[link100], zh[link101]
11 WikiConcept[link102] de[link103], es[link104], ru[link105]
12 Markup[link106] de[link107], es[link108], ru[link109], zh[link110]
13 Wabi-sabi[link111] de[link112], es[link113], fr[link114], ru[link115], zh[link116]
14 File Permissions[link117] de[link118], es[link119], ru[link120], zh[link121]
15 Localizations[link41]

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>.',

usage
<?php

echo Ut::perc_replace(
    $engine->_t('BackupCompleted'), 
    '<code>' . $pack . '</code>', 
    $engine->href('', '', ['mode' => 'db_restore']));

6. Tools

6.1. relang.php

6.2. Machine translation

  1. https://www.deepl.com/translator
  2. https://translate.google.com/
  3. https://translate.yandex.ru/
  4. https://www.bing.com/translator/
  5. https://mozilla.github.io/translate/ - On-device browser translations
  6. Firefox Addon

7. Suggestions

  1. Proposed Specifications For Languages Holding[link124]
  2. Language Links[link125]