View source for 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 ((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 |   ||
|| 6 | es | ((/Doc/Español Español)) | ((!/es )) | es_ES.UTF-8 | ((user:KlePy KlePy)) ||
|| 7 | et | Eesti | ((!/et )) | et_EE.UTF-8 |   ||
|| 8 | fr | ((/Doc/Français Français)) | ((!/fr Français)) | fr_FR.UTF-8 |   ||
|| 9 | hu | ((/Doc/Magyar Magyar)) | ((!/hu )) | hu_HU.UTF-8 |   ||
|| 10 | it | Italiano | ((!/it )) | it_IT.UTF-8 |   ||
|| 11 | ja | 日本語 | ((!/ja )) | ja_JP.UTF-8 |  ||
|| 12 | ko | 한국어 | ((!/ko )) | ko_KR.UTF-8 |  ||
|| 13 | nl | ((/Doc/Nederlands Nederlands)) | ((!/nl )) | nl_NL.UTF-8 |   ||
|| 14 | pl | ((/Doc/Polski Polski)) | ((!/pl Polski)) | pl_PL.UTF-8 |   ||
|| 15 | pt | ((/Doc/Português Português)) | ((!/pt )) | pt_PT.UTF-8 |   ||
|| 16 | ru | ((/Doc/Русский Русский)) | ((!/ru )) | ru_RU.UTF-8 | ((user:Elar9000 Elar9000)) ||
|| 17 | zh | 简体中文 | ((!/zh )) | zh_CN.UTF-8 |  ||
|| 18 | 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 ((/Forum/Development/Translation contact us)).

===Message sets===
WackoWiki supports the ##fi## and ##pt-br## ((WikiPedia:Language_localisation#Language_tags_and_codes language tag)) 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/wacko/ 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/wacko/lang/ lang/))
  1. ##lang/lang.en.php## - default language definition file
  1. ##lang/wacko.en.php## - default language file

=====Installer====

((source:master/wacko/setup/lang/ setup/lang/))
  1. ##setup/lang/installer.en.php## – default language file
  1. ##setup/lang/inserts.en.php##

=====Admin panel====

((source:master/wacko/admin/lang/ admin/lang/))
  1. ##admin/lang/ap.en.php## – default language file

=====JavaScript====

((source:master/wacko/js/lang/ js/lang/))
  1. ##js/lang/wikiedit.en.js## – default language file

=====Theme=====

((source:master/wacko/theme/ theme/))
  1. ##theme/yourtheme/lang/## – default language file

===Documentation==

Core pages to translate 

#|
*| #  | Page | Languages | Notes |*
|| 1 | ((/Doc/English/Features Features)) | ((/Doc/Deutsch/Funktionen de)), ((/Doc/Русский/Особенности ru)) | ||
|| 2 | ((/Doc/English/Requirements Requirements)) | ((/Doc/Deutsch/Voraussetzungen de)), ((/Doc/Русский/Требования ru)) | ||
|| 3 | ((/Doc/English/Installation Installation)) | ((/Doc/Deutsch/Installation de)), ((/Doc/Русский/Инсталляция ru)) | ||
|| 4 | ((/Doc/English/Upgrade Upgrade)) | ((/Doc/Deutsch/Upgrade de)), ((/Doc/Русский/Обновление ru)) | ||
|| 5 | ((/Doc/English/Configuration Configuration)) | ((/Doc/Deutsch/Konfiguration de)), ((/Doc/Русский/ФайлКонфигурации ru)) | ||
|| 6 | ((/Doc/English/CSP Content-Security-Policy)) | | ||
|| 7 | ((/Doc/English/Formatting Formatting)) | ((/Doc/Deutsch/Formatierung de)), ((/Doc/Русский/WackoСинтаксис ru)) | ||
|| 8 | ((/Doc/English/Actions Actions)) | ((/Doc/Deutsch/Aktionen de)), ((/Doc/Русский/Действия ru)) | ||
|| 9 | ((/Doc/English/AccessControlLists Access Control Lists)) | ((/Doc/Deutsch/Zugriffssteuerung de)), ((/Doc/Русский/ПраваДоступа ru)) | ||
|| 10 | ((/Doc/English/AdminPanel Admin Panel)) | ((/Doc/Deutsch/AdminPanel de)), ((/Doc/Русский/AdminPanel ru)) | ||
|| 11 | ((/Doc/English/WikiConcept WikiConcept)) | ((/Doc/Deutsch/WikiKonzeption de)), ((/Doc/Русский/WikiКонцепции ru)) | ||
|| 12 | ((/Doc/English/Markup Markup)) | ((/Doc/Deutsch/Markup de)), ((/Doc/Русский/Разметка ru)) | ||
|| 13 | ((/Doc/English/WabiSabi Wabi-sabi)) | ((/Doc/Deutsch/WabiSabi de)), ((/Doc/Русский/ВабиCаби ru)) | ||
|| 14 | ((/Doc/English/FilePermissions File Permissions)) | ((/Doc/Deutsch/Dateiberechtigungen de)), ((/Doc/Русский/ФайловыеРазрешения ru)) | ||
|| 15 | | | ||
|#

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

===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/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 or Pullreqest.

===Localize your action, handler or module===

====Action and Handler====
lang/wacko.en.php
%%'UserName'	=> 'User name', %%
usage
%%$this->_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
%%
Ut::perc_replace(
	$engine->_t('BackupCompleted'), 
	'<code>' . $pack . '</code>', 
	$engine->href('', '', ['mode' => 'db_restore'])) %%

====Template====
pull in templates
%% [ ' _t: CategoryDescription ' ] %%

===Tools===

====relang.php====
  * ((!/Relang Relang)) - sync message sets in all language files based on default file (en) 

==== Machine translation====

  1. https://translate.google.com/
  1. https://translate.yandex.ru/
  1. https://www.bing.com/translator/
  1. **https://www.deepl.com/translator**
  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))