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 ((WikiPedia:List_of_ISO_639-1_codes ISO language code)).
{{toc numerate=1}}
file:/unicode.svg?right&100
===Supported Languages===
#|
*| # | Language tag | User Documentation | Localization | Locale | Maintainer |*
|| 1 | bg | Български | ((!/bg )) | bg_BG.UTF-8 | ||
|| 2 | da | ((~/Doc/Danish Danish)) | ((!/da Danish)) | da_DK.UTF-8 | ||
|| 3 | de | ((/Doc/Deutsch Deutsch)) | ((!/de Deutsch)) | de_DE.UTF-8 | ((user:WikiAdmin WikiAdmin))||
|| 4 | el | ((/Doc/Ελληνικά Ελληνικά)) | ((!/el Ελληνικά)) | el_GR.UTF-8 | ((user:EvaggelosBalaskas Evaggelos Balaskas)) ||
|| 5 | en | ((/Doc/English English)) | ((!/en English)) | en.UTF-8 | ((user:brianko brianko)) ||
|| 6 | es | ((/Doc/Español Español)) | ((!/es Español)) | es_ES.UTF-8 | ((user:KlePy KlePy)) ||
|| 7 | et | Eesti | ((!/et )) | et_EE.UTF-8 | ||
|| 8 | fa | فارسی | ((!/fa )) | fa_IR.UTF-8 | ||
|| 9 | fr | ((/Doc/Français Français)) | ((!/fr Français)) | fr_FR.UTF-8 | ||
|| 10 | hi | ((/Doc/हिन्दी हिन्दी)) | ((!/hi )) | hi_IN.UTF-8 | ||
|| 11 | hu | ((/Doc/Magyar Magyar)) | ((!/hu )) | hu_HU.UTF-8 | ||
|| 12 | it | ((/Doc/Italiano Italiano)) | ((!/it )) | it_IT.UTF-8 | ||
|| 13 | ja | ((/Doc/日本語 日本語)) | ((!/ja )) | ja_JP.UTF-8 | ||
|| 14 | ko | ((/Doc/한국어 한국어)) | ((!/ko )) | ko_KR.UTF-8 | ||
|| 15 | nl | ((/Doc/Nederlands Nederlands)) | ((!/nl )) | nl_NL.UTF-8 | ||
|| 16 | pl | ((/Doc/Polski Polski)) | ((!/pl )) | pl_PL.UTF-8 | ||
|| 17 | pt | ((/Doc/Português Português)) | ((!/pt )) | pt_PT.UTF-8 | ||
|| 18 | ru | ((/Doc/Русский Русский)) | ((!/ru )) | ru_RU.UTF-8 | ((user:Elar9000 Elar9000)) ||
|| 19 | ta | ((/Doc/தமிழ் தமிழ்)) | ((!/ta தமிழ்)) | ta_IN.UTF-8 | தமிழ் நேரம் ||
|| 20 | zh | ((/Doc/简体中文 简体中文)) | ((!/zh 简体中文)) | zh_CN.UTF-8 | ((user:qianmengnet qianmengnet)) ||
|| 21 | zh-tw | ((/Doc/正體中文 正體中文)) | ((!/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 ((/Forum/Development/Translation contact us)).
===Message sets===
WackoWiki supports the ##fi## and ##pt-br## ((WikiPedia:Language_localisation#Language_tags_and_codes language tag sub-code)) scheme in the language file name, only lower case characters are allowed.
====Locations====
Message sets can be found under the following locations:
Repo: ~https://bitbucket.org/wackowiki/wackowiki/
((source:master/src/ wacko/))
1. ##admin/lang/##
1. ##js/lang/##
1. ##lang/##
1. ##setup/lang/##
1. ##theme/yourtheme/lang/##
====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.
=====Main=====
((source:master/src/lang/ lang/))
1. ##lang/wacko.en.php## - default language file
* default language definition %%
'lang_scheme' => [
'name' => 'English',
'code' => 'en',
'dir' => 'ltr',
'locale' => 'en_US.UTF-8',
],
%%
=====Installer=====
((source:master/src/setup/lang/ setup/lang/))
1. ##setup/lang/inserts.en.php##
1. ##setup/lang/installer.en.php## – default language file
=====Admin panel=====
((source:master/src/admin/lang/ admin/lang/))
1. ##admin/lang/ap.en.php## – default language file
=====JavaScript=====
((source:master/src/js/lang/ js/lang/))
1. ##js/lang/wikiedit.en.js## – default language file
=====Theme=====
((source:master/src/theme/ theme/))
1. ##theme/yourtheme/lang/## – default language file
===Help to improve translation===
file:/translate_language.png?right&500&caption
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/Development/Translation Forum: Translation))**
1. you want to start a new translation or continue an existing one and you want to avoid duplicating your work with someone else
1. you're looking for other people who want to work with you on translating
1. you're having technical questions about tools, the source tree, the meaning of terms, etc.
* ((/Doc/English/Localizations Localizations))
Send us your translations or corrections via E-Mail, Bugtracker, Pullreqest or add them at Crowdin.
====Online Translation====
file:/translate_phrase.png?right&500&caption
**((https://crowdin.com/project/wackowiki 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 ((/Forum/Development/Translation open a new issue here)).
===Documentation===
Core pages to translate
#|
*| # | Page | Languages | Notes |*
|| 1 | ((/Doc/English/Features Features)) | ((/Doc/Deutsch/Funktionen de)), ((/Doc/Español/Características es)), ((/Doc/Français/Fonctionnalités fr)), ((/Doc/Русский/Особенности ru)), ((/Doc/简体中文/软件特色 zh)) | ||
|| 2 | ((/Doc/English/Requirements Requirements)) | ((/Doc/Deutsch/Voraussetzungen de)), ((/Doc/Español/Requisitos es)), ((/Doc/Français/Prérequis fr)), ((/Doc/Русский/Требования ru)), ((/Doc/简体中文/系统要求 zh)) | ||
|| 3 | ((/Doc/English/Installation Installation)) | ((/Doc/Deutsch/Installation de)), ((/Doc/Español/Instalación es)), ((/Doc/Français/Installation fr)), ((/Doc/Русский/Инсталляция ru)), ((/Doc/简体中文/安装指南 zh)) | ||
|| 4 | ((/Doc/English/Upgrade Upgrade)) | ((/Doc/Deutsch/Upgrade de)), ((/Doc/Español/Actualizar es)), ((/Doc/Français/MiseAJour fr)), ((/Doc/Русский/Обновление ru)), ((/Doc/简体中文/升级 zh)) | ||
|| 5 | ((/Doc/English/Configuration Configuration)) | ((/Doc/Deutsch/Konfiguration de)), ((/Doc/Español/Configuración es)), ((/Doc/Français/Configuration fr)), ((/Doc/Русский/ФайлКонфигурации ru)) | ||
|| 6 | ((/Doc/English/Themes Themes)) | ((/Doc/Deutsch/Layouts de)), ((/Doc/Español/Temas es)), ((/Doc/Français/Themes fr)), ((/Doc/Русский/Темы ru)), ((/Doc/简体中文/主题 zh)) | ||
|| 7 | ((/Doc/English/Formatting Formatting)) | ((/Doc/Deutsch/Formatierung de)), ((/Doc/Español/ReglasFormato es)), ((/Doc/Français/MiseEnForme fr)), ((/Doc/Русский/WackoСинтаксис ru)), ((/Doc/简体中文/格式化 zh)) | ||
|| 8 | ((/Doc/English/Actions Actions)) | ((/Doc/Deutsch/Aktionen de)), ((/Doc/Español/Acciones es)), ((/Doc/Français/Fonctions fr)), ((/Doc/Русский/Действия ru)), ((/Doc/简体中文/Actions组件 zh)) | ||
|| 9 | ((/Doc/English/AccessControl Access Control)) | ((/Doc/Deutsch/Zugriffssteuerung de)), ((/Doc/Español/ControlAcceso es)), ((/Doc/Français/GestionDesDroits fr)), ((/Doc/Русский/ПраваДоступа ru)), ((/Doc/简体中文/访问控制表 zh)) | ||
|| 10 | ((/Doc/English/AdminPanel Admin Panel)) | ((/Doc/Deutsch/AdminPanel de)), ((/Doc/Español/AdminPanel es)), ((/Doc/Français/AdminPanel fr)), ((/Doc/Русский/АдминПанель ru)), ((/Doc/简体中文/管理面板 zh)) | ||
|| 11 | ((/Doc/English/WikiConcept WikiConcept)) | ((/Doc/Deutsch/WikiKonzeption de)), ((/Doc/Español/ConceptoWiki es)), ((/Doc/Русский/WikiКонцепции ru)) | ||
|| 12 | ((/Doc/English/Markup Markup)) | ((/Doc/Deutsch/Markup de)), ((/Doc/Español//Markup es)), ((/Doc/Русский/Разметка ru)), ((/Doc/简体中文/Markup zh)) | ||
|| 13 | ((/Doc/English/WabiSabi Wabi-sabi)) | ((/Doc/Deutsch/WabiSabi de)), ((/Doc/Español/WabiSabi es)), ((/Doc/Français/WabiSabi fr)), ((/Doc/Русский/ВабиCаби ru)), ((/Doc/简体中文/侘寂 zh)) | ||
|| 14 | ((/Doc/English/FilePermissions File Permissions)) | ((/Doc/Deutsch/Dateiberechtigungen de)), ((/Doc/Español/PermisosDeArchivos es)), ((/Doc/Русский/ФайловыеРазрешения ru)), ((/Doc/简体中文/文件系统权限 zh)) | ||
|| 15 | ((/Doc/English/Localizations Localizations)) | | ||
|#
It is desirable to have all essential pages available at least in Chinese, German, English, French, Russian and Spanish.
===Localize your action, handler or module===
====Action and Handler====
lang/wacko.en.php
%%'UserName' => 'User name', %%
usage
%%(php)
<?php
echo $this->_t('UserName');
%%
====Template====
pull in templates
%% [ ' _t: UserName ' ] %%
====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)
<?php
echo Ut::perc_replace(
$engine->_t('BackupCompleted'),
'<code>' . $pack . '</code>',
$engine->href('', '', ['mode' => 'db_restore'])); %%
===Tools===
====relang.php====
* ((!/Relang Relang)) - sync message sets in all language files based on default file (en)
====Machine translation====
1. **https://www.deepl.com/translator**
1. https://translate.google.com/
1. https://translate.yandex.ru/
1. https://www.bing.com/translator/
1. https://mozilla.github.io/translate/ - On-device browser translations
1. Firefox Addon
* https://addons.mozilla.org/en-US/firefox/addon/dictcc-translation/
===Suggestions===
1. ((/Users/DidierSpaier/ProposedSpecificationsForLanguagesHolding Proposed Specifications For Languages Holding))
2. ((/Dev/NewFeatures/LanguageLinks Language Links))