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===

#|
*| # | User Documentation | Localization | Abbr. | Maintainer |*
|| 1 |((/Doc/Deutsch Deutsch)) |((!/de Deutsch)) | de |((user:WikiAdmin WikiAdmin))||
|| 2 |((/Doc/English English)) |((!/en English)) | en |  ||
|| 3 |((/Doc/Español Spanish)) |((!/es )) | es |((user:KlePy KlePy)) ||
|| 4 |((/Doc/Français French)) |((!/fr Français)) | fr |  ||
|| 5 |((/Doc/Polski Polski)) |((!/pl Polski)) | pl |  ||
|| 6 |((/Doc/Português Portugues)) |((!/pt )) | pt |  ||
|| 7 |((/Doc/Русский Russian)) |((!/ru )) | ru | ((user:Elar9000 Elar9000)) ||
|| 8 |((/Doc/Български Български)) |((!/bg Български)) | bg |  ||
|| 9 |Italian |((!/it )) | it |  ||
|| 10 |((~/DocDanish Danish)) |((!/da Danish)) | da |  ||
|| 11 |Estonian|((!/et )) | et |  ||
|| 12 |((/Doc/Magyar Hungarian)) ((http://www.tutorial.hu/wackowiki-bemutato-es-telepitesi-utmutato/ Hungarian))|((!/hu )) | hu |  ||
|| 13 |((/Doc/Nederlands Dutch)) |((!/nl )) | nl |  ||
|| 14 |((/Doc/Ελληνικά Greek)) |((!/el Ελληνικά)) | el  | ((user:EvaggelosBalaskas EvaggelosBalaskas)) ||
|#

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===

====Locations====
Message sets can be found under the following locations:

Repo: ~https://bitbucket.org/wackowiki/wackowiki-dev/

((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/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))