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].1. Supported Languages
# | Language tag | User Documentation | Localization | Locale | Maintainer |
---|---|---|---|---|---|
1 | bg | Български | ((!/bg )) | bg_BG.UTF-8 | |
2 | da | Danish | Danish[link2] | da_DK.UTF-8 | |
3 | de | Deutsch[link3] | Deutsch[link4] | de_DE.UTF-8 | WikiAdmin[link5] |
4 | el | Ελληνικά[link6] | Ελληνικά[link7] | el_GR.UTF-8 | Evaggelos Balaskas[link8] |
5 | en | English[link9] | English[link10] | en.UTF-8 | brianko[link11] |
6 | es | Español[link12] | Español | es_ES.UTF-8 | KlePy[link13] |
7 | et | Eesti | ((!/et )) | et_EE.UTF-8 | |
8 | fa | Persian | ((!/fa )) | fa_IR.UTF-8 | |
9 | fr | Français[link14] | Français[link15] | fr_FR.UTF-8 | |
10 | hi | हिन्दी[link16] | ((!/hi )) | hi_IN.UTF-8 | |
11 | hu | Magyar[link17] | ((!/hu )) | hu_HU.UTF-8 | |
12 | it | Italiano[link18] | ((!/it )) | it_IT.UTF-8 | |
13 | ja | 日本語[link19] | ((!/ja )) | ja_JP.UTF-8 | |
14 | ko | 한국어[link20] | ((!/ko )) | ko_KR.UTF-8 | |
15 | nl | Nederlands[link21] | ((!/nl )) | nl_NL.UTF-8 | |
16 | pl | Polski[link22] | ((!/pl )) | pl_PL.UTF-8 | |
17 | pt | Português[link23] | ((!/pt )) | pt_PT.UTF-8 | |
18 | ru | Русский[link24] | ((!/ru )) | ru_RU.UTF-8 | Elar9000[link25] |
19 | zh | 简体中文[link26] | 简体中文[link27] | zh_CN.UTF-8 | qianmengnet[link28] |
20 | zh-tw | 正體中文[link29] | ((!/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[link30].
2. Message sets
WackoWiki supports thefi
and pt-br
language tag sub-code[link31] 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/[link32]
-
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/[link33]-
lang/wacko.en.php
- default language file- default language definition
'lang_scheme' => [ 'name' => 'English', 'code' => 'en', 'dir' => 'ltr', 'locale' => 'en_US.UTF-8', ],
- default language definition
2.2.2. Installer
setup/lang/[link34]
-
setup/lang/inserts.en.php
-
setup/lang/installer.en.php
– default language file
2.2.3. Admin panel
admin/lang/[link35]
-
admin/lang/ap.en.php
– default language file
2.2.4. JavaScript
js/lang/[link36]
-
js/lang/wikiedit.en.js
– default language file
2.2.5. Theme
theme/[link37]
-
theme/yourtheme/lang/
– default language file
3. Help to improve translation
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[link30]
- 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[link38]
Send us your translations or corrections via E-Mail, Bugtracker, Pullreqest or add them at Crowdin.
3.1. Online Translation
Register and login at Crowdin[link39]
- 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[link30].
4. Documentation
Core pages to translate
# | Page | Languages | Notes |
---|---|---|---|
1 | Features[link40] | de[link41], es[link42], fr[link43], ru[link44], zh[link45] | |
2 | Requirements[link46] | de[link47], es[link48], fr[link49], ru[link50], zh[link51] | |
3 | Installation[link52] | de[link53], es[link54], fr[link55], ru[link56], zh[link57] | |
4 | Upgrade[link58] | de[link59], es[link60], fr[link61], ru[link62], zh[link63] | |
5 | Configuration[link64] | de[link65], es[link66], fr[link67], ru[link68] | |
6 | Themes[link69] | de[link70], es[link71], fr[link72], ru[link73], zh[link74] | |
7 | Formatting[link75] | de[link76], es[link77], fr[link78], ru[link79], zh[link80] | |
8 | Actions[link81] | de[link82], es[link83], fr[link84], ru[link85], zh[link86] | |
9 | Access Control[link87] | de[link88], es[link89], fr[link90], ru[link91], zh[link92] | |
10 | Admin Panel[link93] | de[link94], es[link95], fr[link96], ru[link97], zh[link98] | |
11 | WikiConcept[link99] | de[link100], es[link101], ru[link102] | |
12 | Markup[link103] | de[link104], es[link105], ru[link106], zh[link107] | |
13 | Wabi-sabi[link108] | de[link109], es[link110], fr[link111], ru[link112], zh[link113] | |
14 | File Permissions[link114] | de[link115], ru[link116], zh[link117] | |
15 |
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
$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
Ut::perc_replace( $engine->_t('BackupCompleted'), '<code>' . $pack . '</code>', $engine->href('', '', ['mode' => 'db_restore']))
6. Tools
6.1. relang.php
- Relang[link118] - sync message sets in all language files based on default file (en)
6.2. Machine translation
- https://www.deepl.com/translator
- https://translate.google.com/
- https://translate.yandex.ru/
- https://www.bing.com/translator/
- https://mozilla.github.io/translate/ - On-device browser translations
- Firefox Addon
7. Suggestions
- Proposed Specifications For Languages Holding[link120]
- Language Links[link121]
- [link1] https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
- [link2] https://wackowiki.org/doc/Dev/Translations/da
- [link3] https://wackowiki.org/doc/Doc/Deutsch
- [link4] https://wackowiki.org/doc/Dev/Translations/de
- [link5] https://wackowiki.org/doc/Users?profile=WikiAdmin
- [link6] https://wackowiki.org/doc/Doc/Ελληνικά
- [link7] https://wackowiki.org/doc/Dev/Translations/el
- [link8] https://wackowiki.org/doc/Users?profile=EvaggelosBalaskas
- [link9] https://wackowiki.org/doc/Doc/English
- [link10] https://wackowiki.org/doc/Dev/Translations/en
- [link11] https://wackowiki.org/doc/Users?profile=brianko
- [link12] https://wackowiki.org/doc/Doc/Español
- [link13] https://wackowiki.org/doc/Users?profile=KlePy
- [link14] https://wackowiki.org/doc/Doc/Français
- [link15] https://wackowiki.org/doc/Dev/Translations/fr
- [link16] https://wackowiki.org/doc/Doc/हिन्दी
- [link17] https://wackowiki.org/doc/Doc/Magyar
- [link18] https://wackowiki.org/doc/Doc/Italiano
- [link19] https://wackowiki.org/doc/Doc/日本語
- [link20] https://wackowiki.org/doc/Doc/한국어
- [link21] https://wackowiki.org/doc/Doc/Nederlands
- [link22] https://wackowiki.org/doc/Doc/Polski
- [link23] https://wackowiki.org/doc/Doc/Português
- [link24] https://wackowiki.org/doc/Doc/Русский
- [link25] https://wackowiki.org/doc/Users?profile=Elar9000
- [link26] https://wackowiki.org/doc/Doc/简体中文
- [link27] https://wackowiki.org/doc/Dev/Translations/zh
- [link28] https://wackowiki.org/doc/Users?profile=qianmengnet
- [link29] https://wackowiki.org/doc/Doc/正體中文
- [link30] https://wackowiki.org/doc/Forum/Development/Translation
- [link31] https://en.wikipedia.org/wiki/Language_localisation#Language_tags_and_codes
- [link32] https://bitbucket.org/wackowiki/wackowiki/src/master/src/
- [link33] https://bitbucket.org/wackowiki/wackowiki/src/master/src/lang/
- [link34] https://bitbucket.org/wackowiki/wackowiki/src/master/src/setup/lang/
- [link35] https://bitbucket.org/wackowiki/wackowiki/src/master/src/admin/lang/
- [link36] https://bitbucket.org/wackowiki/wackowiki/src/master/src/js/lang/
- [link37] https://bitbucket.org/wackowiki/wackowiki/src/master/src/theme/
- [link38] https://wackowiki.org/doc/Doc/English/Localizations
- [link39] https://crowdin.com/project/wackowiki
- [link40] https://wackowiki.org/doc/Doc/English/Features
- [link41] https://wackowiki.org/doc/Doc/Deutsch/Funktionen
- [link42] https://wackowiki.org/doc/Doc/Español/Características
- [link43] https://wackowiki.org/doc/Doc/Français/Fonctionnalités
- [link44] https://wackowiki.org/doc/Doc/Русский/Особенности
- [link45] https://wackowiki.org/doc/Doc/简体中文/软件特色
- [link46] https://wackowiki.org/doc/Doc/English/Requirements
- [link47] https://wackowiki.org/doc/Doc/Deutsch/Voraussetzungen
- [link48] https://wackowiki.org/doc/Doc/Español/Requisitos
- [link49] https://wackowiki.org/doc/Doc/Français/Prérequis
- [link50] https://wackowiki.org/doc/Doc/Русский/Требования
- [link51] https://wackowiki.org/doc/Doc/简体中文/系统要求
- [link52] https://wackowiki.org/doc/Doc/English/Installation
- [link53] https://wackowiki.org/doc/Doc/Deutsch/Installation
- [link54] https://wackowiki.org/doc/Doc/Español/Instalación
- [link55] https://wackowiki.org/doc/Doc/Français/Installation
- [link56] https://wackowiki.org/doc/Doc/Русский/Инсталляция
- [link57] https://wackowiki.org/doc/Doc/简体中文/安装指南
- [link58] https://wackowiki.org/doc/Doc/English/Upgrade
- [link59] https://wackowiki.org/doc/Doc/Deutsch/Upgrade
- [link60] https://wackowiki.org/doc/Doc/Español/Actualizar
- [link61] https://wackowiki.org/doc/Doc/Français/MiseAJour
- [link62] https://wackowiki.org/doc/Doc/Русский/Обновление
- [link63] https://wackowiki.org/doc/Doc/简体中文/升级
- [link64] https://wackowiki.org/doc/Doc/English/Configuration
- [link65] https://wackowiki.org/doc/Doc/Deutsch/Konfiguration
- [link66] https://wackowiki.org/doc/Doc/Español/Configuración
- [link67] https://wackowiki.org/doc/Doc/Français/Configuration
- [link68] https://wackowiki.org/doc/Doc/Русский/ФайлКонфигурации
- [link69] https://wackowiki.org/doc/Doc/English/Themes
- [link70] https://wackowiki.org/doc/Doc/Deutsch/Layouts
- [link71] https://wackowiki.org/doc/Doc/Español/Temas
- [link72] https://wackowiki.org/doc/Doc/Français/Themes
- [link73] https://wackowiki.org/doc/Doc/Русский/Темы
- [link74] https://wackowiki.org/doc/Doc/简体中文/主题
- [link75] https://wackowiki.org/doc/Doc/English/Formatting
- [link76] https://wackowiki.org/doc/Doc/Deutsch/Formatierung
- [link77] https://wackowiki.org/doc/Doc/Español/ReglasFormato
- [link78] https://wackowiki.org/doc/Doc/Français/MiseEnForme
- [link79] https://wackowiki.org/doc/Doc/Русский/WackoСинтаксис
- [link80] https://wackowiki.org/doc/Doc/简体中文/格式化
- [link81] https://wackowiki.org/doc/Doc/English/Actions
- [link82] https://wackowiki.org/doc/Doc/Deutsch/Aktionen
- [link83] https://wackowiki.org/doc/Doc/Español/Acciones
- [link84] https://wackowiki.org/doc/Doc/Français/Fonctions
- [link85] https://wackowiki.org/doc/Doc/Русский/Действия
- [link86] https://wackowiki.org/doc/Doc/简体中文/Actions组件
- [link87] https://wackowiki.org/doc/Doc/English/AccessControl
- [link88] https://wackowiki.org/doc/Doc/Deutsch/Zugriffssteuerung
- [link89] https://wackowiki.org/doc/Doc/Español/ControlAcceso
- [link90] https://wackowiki.org/doc/Doc/Français/GestionDesDroits
- [link91] https://wackowiki.org/doc/Doc/Русский/ПраваДоступа
- [link92] https://wackowiki.org/doc/Doc/简体中文/访问控制表
- [link93] https://wackowiki.org/doc/Doc/English/AdminPanel
- [link94] https://wackowiki.org/doc/Doc/Deutsch/AdminPanel
- [link95] https://wackowiki.org/doc/Doc/Español/AdminPanel
- [link96] https://wackowiki.org/doc/Doc/Français/AdminPanel
- [link97] https://wackowiki.org/doc/Doc/Русский/АдминПанель
- [link98] https://wackowiki.org/doc/Doc/简体中文/管理面板
- [link99] https://wackowiki.org/doc/Doc/English/WikiConcept
- [link100] https://wackowiki.org/doc/Doc/Deutsch/WikiKonzeption
- [link101] https://wackowiki.org/doc/Doc/Español/ConceptoWiki
- [link102] https://wackowiki.org/doc/Doc/Русский/WikiКонцепции
- [link103] https://wackowiki.org/doc/Doc/English/Markup
- [link104] https://wackowiki.org/doc/Doc/Deutsch/Markup
- [link105] https://wackowiki.org/doc/Doc/Español/Markup
- [link106] https://wackowiki.org/doc/Doc/Русский/Разметка
- [link107] https://wackowiki.org/doc/Doc/简体中文/Markup
- [link108] https://wackowiki.org/doc/Doc/English/WabiSabi
- [link109] https://wackowiki.org/doc/Doc/Deutsch/WabiSabi
- [link110] https://wackowiki.org/doc/Doc/Español/WabiSabi
- [link111] https://wackowiki.org/doc/Doc/Français/WabiSabi
- [link112] https://wackowiki.org/doc/Doc/Русский/ВабиCаби
- [link113] https://wackowiki.org/doc/Doc/简体中文/侘寂
- [link114] https://wackowiki.org/doc/Doc/English/FilePermissions
- [link115] https://wackowiki.org/doc/Doc/Deutsch/Dateiberechtigungen
- [link116] https://wackowiki.org/doc/Doc/Русский/ФайловыеРазрешения
- [link117] https://wackowiki.org/doc/Doc/简体中文/文件系统权限
- [link118] https://wackowiki.org/doc/Dev/Translations/Relang
- [link119] https://addons.mozilla.org/en-US/firefox/addon/dictcc-translation/
- [link120] https://wackowiki.org/doc/Users/DidierSpaier/ProposedSpecificationsForLanguagesHolding
- [link121] https://wackowiki.org/doc/Dev/NewFeatures/LanguageLinks