CINXE.COM

<!DOCTYPE html> <html lang="en" dir="ltr" class="no-js"> <head> <meta charset="utf-8" /> <title>localization [DokuWiki]</title> <meta name="generator" content="DokuWiki"/> <meta name="theme-color" content="#008800"/> <meta name="robots" content="index,follow"/> <meta name="keywords" content="localization"/> <link rel="search" type="application/opensearchdescription+xml" href="/lib/exe/opensearch.php" title="DokuWiki"/> <link rel="start" href="/"/> <link rel="contents" href="/localization?do=index" title="Sitemap"/> <link rel="manifest" href="/lib/exe/manifest.php"/> <link rel="alternate" type="application/rss+xml" title="Recent Changes" href="/feed.php"/> <link rel="alternate" type="application/rss+xml" title="Current namespace" href="/feed.php?mode=list&ns="/> <link rel="edit" title="Edit this page" href="/localization?do=edit"/> <link rel="alternate" type="text/html" title="Plain HTML" href="/_export/xhtml/localization"/> <link rel="alternate" type="text/plain" title="Wiki Markup" href="/_export/raw/localization"/> <link rel="canonical" href="https://www.dokuwiki.org/localization"/> <link rel="stylesheet" href="/lib/exe/css.php?t=dokuwiki&tseed=f1005bad3d81fc9c803c7f93d32a390e"/> <link rel="alternate" hreflang="cs" href="https://www.dokuwiki.org/cs:localization"/> <link rel="alternate" hreflang="de" href="https://www.dokuwiki.org/de:localization"/> <link rel="alternate" hreflang="eo" href="https://www.dokuwiki.org/eo:localization"/> <link rel="alternate" hreflang="es" href="https://www.dokuwiki.org/es:localization"/> <link rel="alternate" hreflang="fr" href="https://www.dokuwiki.org/fr:localization"/> <link rel="alternate" hreflang="hu" href="https://www.dokuwiki.org/hu:localization"/> <link rel="alternate" hreflang="it" href="https://www.dokuwiki.org/it:localization"/> <link rel="alternate" hreflang="ja" href="https://www.dokuwiki.org/ja:localization"/> <link rel="alternate" hreflang="ko" href="https://www.dokuwiki.org/ko:localization"/> <link rel="alternate" hreflang="nl" href="https://www.dokuwiki.org/nl:localization"/> <link rel="alternate" hreflang="no" href="https://www.dokuwiki.org/no:localization"/> <link rel="alternate" hreflang="pl" href="https://www.dokuwiki.org/pl:localization"/> <link rel="alternate" hreflang="pt-br" href="https://www.dokuwiki.org/pt-br:localization"/> <link rel="alternate" hreflang="ru" href="https://www.dokuwiki.org/ru:localization"/> <link rel="alternate" hreflang="uk" href="https://www.dokuwiki.org/uk:localization"/> <link rel="alternate" hreflang="zh" href="https://www.dokuwiki.org/zh:localization"/> <link rel="alternate" hreflang="zh-tw" href="https://www.dokuwiki.org/zh-tw:localization"/> <link rel="alternate" hreflang="x-default" href="https://www.dokuwiki.org/localization"/> <script >var NS='';var JSINFO = {"plugins":{"edittable":{"default columnwidth":""}},"id":"localization","namespace":"","ACT":"show","useHeadingNavigation":0,"useHeadingContent":0};(function(H){H.className=H.className.replace(/\bno-js\b/,'js')})(document.documentElement);</script> <script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.6.4/jquery.min.js" defer="defer"></script> <script src="https://cdnjs.cloudflare.com/ajax/libs/jqueryui/1.13.2/jquery-ui.min.js" defer="defer"></script> <script src="/lib/exe/js.php?t=dokuwiki&tseed=f1005bad3d81fc9c803c7f93d32a390e&lang=en" defer="defer"></script> <meta name="viewport" content="width=device-width,initial-scale=1" /> <link rel="shortcut icon" href="/lib/tpl/dokuwiki/images/favicon.ico" /> <link rel="apple-touch-icon" href="/lib/tpl/dokuwiki/images/apple-touch-icon.png" /> <meta name="verify-v1" content="OVxl3gsCv2MhZqh1cBQyl0JytWXSwXMjyvwc+4w3WtA=" /> <meta name="google-site-verification" content="YhTVK69hW94ZXUtc2zSLPxTkZKbZIn0zK67mz5WQB-E" />  <script async src="https://www.googletagmanager.com/gtag/js?id=UA-83791-1"></script> <script> window.dataLayer = window.dataLayer || []; function gtag(){dataLayer.push(arguments);} gtag('js', new Date()); gtag('config', 'UA-83791-1', { 'anonymize_ip': true }); </script> </head> <body> <div id="dokuwiki__site"><div id="dokuwiki__top" class="site dokuwiki mode_show tpl_dokuwiki showSidebar hasSidebar">  <header id="dokuwiki__header"><div class="pad group"> <div class="headings group"> <ul class="a11y skip"> <li><a href="#dokuwiki__content">skip to content</a></li> </ul> <h1 class="logo"><a href="/start" accesskey="h" title="Home [h]"><img src="/lib/tpl/dokuwiki/images/logo.png" width="64" height="64" alt="" /><span>DokuWiki</span></a></h1> <p class="claim">It's better when it's simple</p> </div> <div class="tools group">  <div id="dokuwiki__usertools"> <h3 class="a11y">User Tools</h3> <ul> <li class="action login"><a href="/localization?do=login&sectok=" title="Log In" rel="nofollow"><span>Log In</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M10 17.25V14H3v-4h7V6.75L15.25 12 10 17.25M8 2h9a2 2 0 0 1 2 2v16a2 2 0 0 1-2 2H8a2 2 0 0 1-2-2v-4h2v4h9V4H8v4H6V4a2 2 0 0 1 2-2z"/></svg></a></li> </ul> </div>  <div id="dokuwiki__sitetools"> <h3 class="a11y">Site Tools</h3> <form action="/start" method="get" role="search" class="search doku_form" id="dw__search" accept-charset="utf-8"><input type="hidden" name="do" value="search" /><input type="hidden" name="id" value="localization" /><div class="no"><input name="q" type="text" class="edit" title="[F]" accesskey="f" placeholder="Search" autocomplete="on" id="qsearch__in" value="" /><button value="1" type="submit" title="Search">Search</button><div id="qsearch__out" class="ajax_qsearch JSpopup"></div></div></form> <div class="mobileTools"> <form action="/doku.php" method="get" accept-charset="utf-8"><div class="no"><input type="hidden" name="id" value="localization" /><select name="do" class="edit quickselect" title="Tools"><option value="">Tools</option><optgroup label="Page Tools"><option value="edit">Edit this page</option><option value="revisions">Old revisions</option><option value="backlink">Backlinks</option></optgroup><optgroup label="Site Tools"><option value="recent">Recent Changes</option><option value="media">Media Manager</option><option value="index">Sitemap</option></optgroup><optgroup label="User Tools"><option value="login">Log In</option></optgroup></select><button type="submit">></button></div></form> </div> <ul> <li class="action recent"><a href="/localization?do=recent" title="Recent Changes [r]" rel="nofollow" accesskey="r">Recent Changes</a></li><li class="action media"><a href="/localization?do=media&ns=" title="Media Manager" rel="nofollow">Media Manager</a></li><li class="action index"><a href="/localization?do=index" title="Sitemap [x]" rel="nofollow" accesskey="x">Sitemap</a></li> </ul> </div> </div>  <div class="breadcrumbs"> <div class="trace"><span class="bchead">Trace:</span> <span class="bcsep">•</span> <span class="curid"><bdi><a href="/localization" class="breadcrumbs" title="localization">localization</a></bdi></span></div> </div> <hr class="a11y" /> </div></header> <div class="wrapper group">  <nav id="dokuwiki__aside" aria-label="Sidebar"><div class="pad aside include group"> <h3 class="toggle">Sidebar</h3> <div class="content"><div class="group"> <div class="plugin_translation is-dropdown"><span class="title">Translations of this page<sup><a href="/localization" class="wikilink1" title="localization" data-wiki-id="localization">?</a></sup>: </span><ul><li class="span"><span class="wikilink1" title="English">English (en)</span></li><li class="a"><a class="wikilink2" title="|العربية" href="/ar:localization">|العربية (ar)</a></li><li class="a"><a class="wikilink2" title="Català" href="/ca:localization">Català (ca)</a></li><li class="a"><a class="wikilink1" title="Česky" href="/cs:localization">Česky (cs)</a></li><li class="a"><a class="wikilink2" title="Dansk" href="/da:localization">Dansk (da)</a></li><li class="a"><a class="wikilink1" title="Deutsch" href="/de:localization">Deutsch (de)</a></li><li class="a"><a class="wikilink2" title="Ελληνικά" href="/el:localization">Ελληνικά (el)</a></li><li class="a"><a class="wikilink1" title="Esperanto" href="/eo:localization">Esperanto (eo)</a></li><li class="a"><a class="wikilink1" title="Español" href="/es:localization">Español (es)</a></li><li class="a"><a class="wikilink2" title="فارسی" href="/fa:localization">فارسی (fa)</a></li><li class="a"><a class="wikilink1" title="Français" href="/fr:localization">Français (fr)</a></li><li class="a"><a class="wikilink2" title="עברית" href="/he:localization">עברית (he)</a></li><li class="a"><a class="wikilink1" title="Magyar" href="/hu:localization">Magyar (hu)</a></li><li class="a"><a class="wikilink1" title="Italiano" href="/it:localization">Italiano (it)</a></li><li class="a"><a class="wikilink1" title="日本語" href="/ja:localization">日本語 (ja)</a></li><li class="a"><a class="wikilink1" title="한국어" href="/ko:localization">한국어 (ko)</a></li><li class="a"><a class="wikilink2" title="Lietuvių Kalba" href="/lt:localization">Lietuvių Kalba (lt)</a></li><li class="a"><a class="wikilink1" title="Nederlands" href="/nl:localization">Nederlands (nl)</a></li><li class="a"><a class="wikilink1" title="Norsk" href="/no:localization">Norsk (no)</a></li><li class="a"><a class="wikilink1" title="Polski" href="/pl:localization">Polski (pl)</a></li><li class="a"><a class="wikilink1" title="Português" href="/pt-br:localization">Português (pt-br)</a></li><li class="a"><a class="wikilink2" title="Română" href="/ro:localization">Română (ro)</a></li><li class="a"><a class="wikilink1" title="Русский" href="/ru:localization">Русский (ru)</a></li><li class="a"><a class="wikilink2" title="Српски Језик" href="/sr:localization">Српски Језик (sr)</a></li><li class="a"><a class="wikilink2" title="Svenska" href="/sv:localization">Svenska (sv)</a></li><li class="a"><a class="wikilink2" title="ไทย" href="/th:localization">ไทย (th)</a></li><li class="a"><a class="wikilink1" title="Українська" href="/uk:localization">Українська (uk)</a></li><li class="a"><a class="wikilink1" title="中文" href="/zh:localization">中文 (zh)</a></li><li class="a"><a class="wikilink1" title="繁體中文" href="/zh-tw:localization">繁體中文 (zh-tw)</a></li></ul></div> <p> <strong>Learn about DokuWiki</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/features" class="wikilink1" title="features" data-wiki-id="features">Features</a> & <a href="/blogroll" class="wikilink1" title="blogroll" data-wiki-id="blogroll">reviews</a> </div> </li> <li class="level1"><div class="li"> <a href="/install" class="wikilink1" title="install" data-wiki-id="install">Installation guide</a></div> </li> <li class="level1"><div class="li"> <a href="/manual" class="wikilink1" title="manual" data-wiki-id="manual">User manual</a> & <a href="/wiki:syntax" class="wikilink1" title="wiki:syntax" data-wiki-id="wiki:syntax">syntax</a></div> </li> <li class="level1"><div class="li"> <a href="/changes" class="wikilink1" title="changes" data-wiki-id="changes">Release notes</a></div> </li> <li class="level1"><div class="li"> <a href="/faq" class="wikilink1" title="faq" data-wiki-id="faq">FAQ</a></div> </li> </ul> <p> <strong>Advanced Use</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/extensions" class="wikilink1" title="extensions" data-wiki-id="extensions">Extensions</a></div> </li> <li class="level1"><div class="li"> <a href="/development" class="wikilink1" title="development" data-wiki-id="development">Development manual</a></div> </li> </ul> <p> <strong>Corporate Use</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/faq:support" class="wikilink1" title="faq:support" data-wiki-id="faq:support">Get support</a></div> </li> <li class="level1"><div class="li"> <a href="/donate" class="wikilink1" title="donate" data-wiki-id="donate">Donations</a></div> </li> </ul> <p> <strong>Our Community</strong> </p> <ul> <li class="level1"><div class="li"> <a href="/teams:getting_involved" class="wikilink1" title="teams:getting_involved" data-wiki-id="teams:getting_involved">Get involved</a></div> </li> <li class="level1"><div class="li"> <a href="/dokuinstall" class="wikilink1" title="dokuinstall" data-wiki-id="dokuinstall">Users</a></div> </li> <li class="level1"><div class="li"> <a href="http://forum.dokuwiki.org" class="urlextern" title="http://forum.dokuwiki.org">User forum</a></div> </li> <li class="level1"><div class="li"> <a href="/mailinglist" class="wikilink1" title="mailinglist" data-wiki-id="mailinglist">Development mailinglist</a></div> </li> </ul> <hr /> <p> Follow us on <a href="https://phpc.social/@dokuwiki" class="urlextern" title="https://phpc.social/@dokuwiki">Mastodon</a> and other <a href="/social" class="wikilink1" title="social" data-wiki-id="social">social networks</a>. </p> <p> <a href="/privacy" class="wikilink1" title="privacy" data-wiki-id="privacy">Our Privacy Policy</a> </p> </div></div> </div></nav>  <main id="dokuwiki__content"><div class="pad group"> <div class="pageId"><span>localization</span></div> <div class="page group">   <div id="dw__toc" class="dw__toc"> <h3 class="toggle">Table of Contents</h3> <div> <ul class="toc"> <li class="level1"><div class="li"><a href="#localizing_dokuwiki_the_software">Localizing DokuWiki (the Software)</a></div> <ul class="toc"> <li class="level2"><div class="li"><a href="#localizing_dokuwiki_and_its_plugins_and_templates">Localizing DokuWiki and its plugins and templates</a></div> <ul class="toc"> <li class="level3"><div class="li"><a href="#howto_add_a_new_language">Howto add a new language</a></div></li> <li class="level3"><div class="li"><a href="#directions_for_consistent_translations">Directions for consistent translations</a></div></li> <li class="level3"><div class="li"><a href="#plugins">Plugins</a></div></li> </ul> </li> <li class="level2"><div class="li"><a href="#changing_some_localized_texts_and_strings_in_your_installation">Changing some localized texts and strings in your installation</a></div></li> </ul> </li> <li class="level1"><div class="li"><a href="#translating_dokuwikiorg_the_documentation">Translating DokuWiki.org (the documentation)</a></div> <ul class="toc"> <li class="level2"><div class="li"><a href="#translation_guidelines">Translation Guidelines</a></div></li> <li class="level2"><div class="li"><a href="#disabling_translation_feature_for_certain_pages">Disabling translation feature for certain pages</a></div></li> </ul> </li> <li class="level1"><div class="li"><a href="#see_also">See also</a></div></li> </ul> </div> </div>  <h1 class="sectionedit1" id="localizing_dokuwiki_the_software">Localizing DokuWiki (the Software)</h1> <div class="level1"> <p> <a href="/dokuwiki" class="wikilink1" title="dokuwiki" data-wiki-id="dokuwiki">DokuWiki</a>'s user interface can be configured to use any language by setting the appropriate option in the <a href="/config:lang" class="wikilink1" title="config:lang" data-wiki-id="config:lang">config</a>. </p> <p> You can help translating DokuWiki to your language by visiting the <a href="https://translate.dokuwiki.org/" class="urlextern" title="https://translate.dokuwiki.org/">DokuWiki Localization Hub</a>. We recommend to join the <a href="/mailinglist#i18n_mailing_list" class="wikilink1" title="mailinglist" data-wiki-id="mailinglist">I18N Mailing List</a> to be informed when new strings are added and need to be translated. </p> </div> <div class="secedit editbutton_section editbutton_1"><form class="button btn_secedit" method="post" action="/localization"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1702322102" /><input type="hidden" name="summary" value="[Localizing DokuWiki (the Software)] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="localizing_dokuwiki_the_software" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="1-443" /><button type="submit" title="Localizing DokuWiki (the Software)">Edit</button></div></form></div> <h2 class="sectionedit2" id="localizing_dokuwiki_and_its_plugins_and_templates">Localizing DokuWiki and its plugins and templates</h2> <div class="level2"> <p> Most of DokuWiki and its plugins and templates only provide localization for English and some other languages. We encourage you to translate them into your native language. </p> <p> Important things to keep in mind when translating: </p> <ul> <li class="level1"><div class="li"> Please try to <strong>complete your countries main official language</strong> before starting another dialect.</div> </li> <li class="level1"><div class="li"> If you do major translation work it is recommended to check your translations in the <a href="https://download.dokuwiki.org/" class="urlextern" title="https://download.dokuwiki.org/">development snapshot</a>. This gives you the opportunity to correct errors and verify the layout in your language.</div> </li> <li class="level1"><div class="li"> In some languages words and sentences tend to get longer than the original English words. Keep in mind that <strong>your translation needs to work on any screen size</strong> and it often looks better if <strong>words are in line with other items on the page</strong>.</div> </li> <li class="level1"><div class="li"> When translating technical descriptions of external origin like the <abbr title="Application Programming Interface">API</abbr>'s delivered by Github, Twitter, Google etc please <strong>read the external manual first</strong>. This is especially important for translating interfaces. Maybe a localized version of the manual or helppages is already at the external source and you can use all or part of these.</div> </li> <li class="level1"><div class="li"> As DokuWiki wants to be <strong>standards-compliant</strong>, consider learning about these regarding your language first. You can learn about correct spelling and interpunction from dictionaries or webpages maintained by public institutions.</div> </li> <li class="level1"><div class="li"> Always <strong>keep the format strings intact</strong>, i.e. identical. Strings like these <code>%1$d</code> and <code><i>%s</i></code> and <code><strong>Update:</strong></code>. The word <code>Update:</code> should be translated but the word <code><strong></code> <strong>not</strong>.</div> </li> </ul> </div> <div class="secedit editbutton_section editbutton_2"><form class="button btn_secedit" method="post" action="/localization"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1702322102" /><input type="hidden" name="summary" value="[Localizing DokuWiki and its plugins and templates] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="localizing_dokuwiki_and_its_plugins_and_templates" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="444-2143" /><button type="submit" title="Localizing DokuWiki and its plugins and templates">Edit</button></div></form></div> <h3 class="sectionedit3" id="howto_add_a_new_language">Howto add a new language</h3> <div class="level3"> <p> To prevent spam, <a href="https://translate.dokuwiki.org/" class="urlextern" title="https://translate.dokuwiki.org/">https://translate.dokuwiki.org/</a> only has languages which exist in the source code DokuWiki. To initiate a new language you can send a pull request with some translated lines or if you do not program you can open an issue in our Bug tracker. Please use ISO 639-1 (2-letter) and ISO 639-3 (3-letter) language code format, see… When accepted the language becomes available for easier translation via the translation tool. </p> </div> <div class="secedit editbutton_section editbutton_3"><form class="button btn_secedit" method="post" action="/localization"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1702322102" /><input type="hidden" name="summary" value="[Howto add a new language] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="howto_add_a_new_language" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="2144-2617" /><button type="submit" title="Howto add a new language">Edit</button></div></form></div> <h3 class="sectionedit4" id="directions_for_consistent_translations">Directions for consistent translations</h3> <div class="level3"> <p> At the <a href="/teams:i18n:consistenttranslations" class="wikilink1" title="teams:i18n:consistenttranslations" data-wiki-id="teams:i18n:consistenttranslations">consistent translations</a> page you can find: </p> <ul> <li class="level1"><div class="li"> some preferred translations for regularly used words </div> </li> <li class="level1"><div class="li"> and how to handle placeholder order in non-english strings.</div> </li> </ul> </div> <div class="secedit editbutton_section editbutton_4"><form class="button btn_secedit" method="post" action="/localization"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1702322102" /><input type="hidden" name="summary" value="[Directions for consistent translations] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="directions_for_consistent_translations" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="2618-2878" /><button type="submit" title="Directions for consistent translations">Edit</button></div></form></div> <h3 class="sectionedit5" id="plugins">Plugins</h3> <div class="level3"> <p> Plugin authors can register their plugin at <a href="https://translate.dokuwiki.org/" class="urlextern" title="https://translate.dokuwiki.org/">https://translate.dokuwiki.org/</a> where you can easily help to translate the plugin. </p> <p> If a plugin is not translatable via the translation tool you can do it manually: </p> <ul> <li class="level1"><div class="li"> Copy the content of <code>lib/plugins/<pluginname>/lang/en/</code> to<br/> <code>lib/plugins/<pluginname>/lang/<ISO-lang-code>/</code></div> </li> <li class="level1"><div class="li"> Edit the contained <code>.php</code> and <code>.txt</code> files in a <a href="/utf-8" class="wikilink1" title="utf-8" data-wiki-id="utf-8">UTF-8 capable</a> text editor</div> </li> <li class="level1"><div class="li"> Zip up the new language folder and send it to the author for inclusion in future releases</div> </li> </ul> <p> For any further questions or general help you could send a mail to the <a href="/mailinglist#i18n_mailing_list" class="wikilink1" title="mailinglist" data-wiki-id="mailinglist">I18N-Mailinglist</a> or ask for help in the <a href="/irc" class="wikilink1" title="irc" data-wiki-id="irc">IRC-Channel</a>. </p> </div> <div class="secedit editbutton_section editbutton_5"><form class="button btn_secedit" method="post" action="/localization"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1702322102" /><input type="hidden" name="summary" value="[Plugins] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="plugins" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="2879-3583" /><button type="submit" title="Plugins">Edit</button></div></form></div> <h2 class="sectionedit6" id="changing_some_localized_texts_and_strings_in_your_installation">Changing some localized texts and strings in your installation</h2> <div class="level2"> <p> There are many localized texts in DokuWiki like emails that are sent on registration, password forgotten, the text above the edit form, and more. Also the strings used in the buttons and links are translated. You can modify these by creating custom files with your version of the texts. This way your changes aren't overwritten on upgrades. </p> <p> You can change these texts by copying the <code><name>.txt</code> files or copying some strings from <code>lang.php</code>: </p> <ul> <li class="level1"><div class="li"> from <code>inc/lang/<<a href="https://www.loc.gov/standards/iso639-2/php/English_list.php" class="urlextern" title="https://www.loc.gov/standards/iso639-2/php/English_list.php">ISO 639-1</a>-lang-code>/</code></div> </li> <li class="level1"><div class="li"> to <code><strong>conf/lang/</strong><ISO-lang-code>/</code></div> </li> </ul> <p> and editing the copied content. </p> <p> You can do the same thing for plugins and templates by copying <code><name>.txt</code> or some strings from <code>lang.php</code>: </p> <ul> <li class="level1"><div class="li"> from <code>lib/plugins/<plugin>/lang/<ISO-lang-code>/</code></div> </li> <li class="level1"><div class="li"> to <code><strong>conf/plugin_lang/</strong><plugin>/<ISO-lang-code>/</code></div> </li> </ul> <ul> <li class="level1"><div class="li"> from <code>lib/tpl/<template>/lang/<ISO-lang-code>/</code></div> </li> <li class="level1"><div class="li"> to <code><strong>conf/template_lang/</strong><template>/<ISO-lang-code>/</code></div> </li> </ul> <p> Copy only strings from <code>lang.php</code> which you will modify. The remaining strings are read from the original file. </p> </div> <h4 id="example">Example</h4> <div class="level4"> <p> Example of an English <code>lang.php</code> file. This is possible for every language. </p> <dl class="code"> <dt><a href="/_export/code/localization?codeblock=0" title="Download Snippet" class="mediafile mf_php">conf/lang/en/lang.php</a></dt> <dd><pre class="code php"><span class="kw2"><?php</span> <span class="co4">/** * Customization of the english language file * Copy only the strings that needs to be modified */</span>   <span class="re0">$lang</span><span class="br0">[</span><span class="st_h">'btn_admin'</span><span class="br0">]</span> <span class="sy0">=</span> <span class="st_h">'Admin Panel'</span><span class="sy0">;</span></pre> </dd></dl> </div> <div class="secedit editbutton_section editbutton_6"><form class="button btn_secedit" method="post" action="/localization"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1702322102" /><input type="hidden" name="summary" value="[Changing some localized texts and strings in your installation] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="changing_some_localized_texts_and_strings_in_your_installation" /><input type="hidden" name="codeblockOffset" value="0" /><input type="hidden" name="range" value="3584-5049" /><button type="submit" title="Changing some localized texts and strings in your installation">Edit</button></div></form></div> <h1 class="sectionedit7" id="translating_dokuwikiorg_the_documentation">Translating DokuWiki.org (the documentation)</h1> <div class="level1"> <p> Translating the DokuWiki documentation here at dokuwiki.org is encouraged. Translated pages are to be named like their English counterparts and stored in a separate namespace based on their ISO code. To make this easier the <a href="/plugin:translation" class="wikilink1" title="plugin:translation" data-wiki-id="plugin:translation">Translation Plugin</a> adds links to existing and missing translations in the upper left corner of every page. </p> <p> Only languages manually configured by the administrator are shown in the selector. If you want to add translations for a language currently not shown, just manually create the pages in the appropriate language subnamespace and send a mail to the <a href="/mailinglist#i18n_mailing_list" class="wikilink1" title="mailinglist" data-wiki-id="mailinglist">I18N mailing list</a> asking for your language to be added. </p> </div> <div class="secedit editbutton_section editbutton_7"><form class="button btn_secedit" method="post" action="/localization"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1702322102" /><input type="hidden" name="summary" value="[Translating DokuWiki.org (the documentation)] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="translating_dokuwikiorg_the_documentation" /><input type="hidden" name="codeblockOffset" value="1" /><input type="hidden" name="range" value="5050-5801" /><button type="submit" title="Translating DokuWiki.org (the documentation)">Edit</button></div></form></div> <h2 class="sectionedit8" id="translation_guidelines">Translation Guidelines</h2> <div class="level2"> <ul> <li class="level1"><div class="li"> Feel free to create any missing translation</div> </li> <li class="level1"><div class="li"> Only pages in the top namespace should be translated</div> </li> <li class="level1"><div class="li"> Translated pages need to have the same (English) name as the original page</div> </li> <li class="level1"><div class="li"> Translated pages have to be stored in a sub namespace of the root namespace named by the ISO language code</div> </li> <li class="level1"><div class="li"> Please don't add stubs saying the page does not exist, yet.</div> </li> <li class="level1"><div class="li"> Please refrain from cluttering translations with credit lines – if you want to be recognized as translator, log in first</div> </li> <li class="level1"><div class="li"> A good starting point for translations is the <a href="/manual" class="wikilink1" title="manual" data-wiki-id="manual">manual</a></div> </li> <li class="level1"><div class="li"> You may also want to translate the <a href="/aside" class="wikilink1" title="aside" data-wiki-id="aside">sidebar</a> to your language</div> </li> </ul> </div> <div class="secedit editbutton_section editbutton_8"><form class="button btn_secedit" method="post" action="/localization"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1702322102" /><input type="hidden" name="summary" value="[Translation Guidelines] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="translation_guidelines" /><input type="hidden" name="codeblockOffset" value="1" /><input type="hidden" name="range" value="5802-6458" /><button type="submit" title="Translation Guidelines">Edit</button></div></form></div> <h2 class="sectionedit9" id="disabling_translation_feature_for_certain_pages">Disabling translation feature for certain pages</h2> <div class="level2"> <p> Where translation is not sensible the <code>~~NOTRANS~~</code> macro should be inserted into the page. </p> </div> <div class="secedit editbutton_section editbutton_9"><form class="button btn_secedit" method="post" action="/localization"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1702322102" /><input type="hidden" name="summary" value="[Disabling translation feature for certain pages] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="disabling_translation_feature_for_certain_pages" /><input type="hidden" name="codeblockOffset" value="1" /><input type="hidden" name="range" value="6459-6618" /><button type="submit" title="Disabling translation feature for certain pages">Edit</button></div></form></div> <h1 class="sectionedit10" id="see_also">See also</h1> <div class="level1"> <ul> <li class="level1"><div class="li"> <a href="https://translate.dokuwiki.org/" class="urlextern" title="https://translate.dokuwiki.org/">DokuWiki Localization Hub</a></div> </li> <li class="level1"><div class="li"> <a href="/romanization" class="wikilink1" title="romanization" data-wiki-id="romanization">Romanization</a></div> </li> <li class="level1"><div class="li"> <a href="/plugin:translation" class="wikilink1" title="plugin:translation" data-wiki-id="plugin:translation">Translation Plugin</a></div> </li> <li class="level1"><div class="li"> <a href="/devel:localization" class="wikilink1" title="devel:localization" data-wiki-id="devel:localization">Development info about localization</a></div> </li> <li class="level1"><div class="li"> Directions for <a href="/teams:i18n:consistenttranslations" class="wikilink1" title="teams:i18n:consistenttranslations" data-wiki-id="teams:i18n:consistenttranslations">consistent translations</a></div> </li> <li class="level1"><div class="li"> The <a href="/teams:i18n" class="wikilink1" title="teams:i18n" data-wiki-id="teams:i18n">I18N</a> Team (translation team)</div> </li> </ul> </div> <div class="secedit editbutton_section editbutton_10"><form class="button btn_secedit" method="post" action="/localization"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="rev" value="1702322102" /><input type="hidden" name="summary" value="[See also] " /><input type="hidden" name="target" value="section" /><input type="hidden" name="hid" value="see_also" /><input type="hidden" name="codeblockOffset" value="1" /><input type="hidden" name="range" value="6619-" /><button type="submit" title="See also">Edit</button></div></form></div>  </div> <div class="docInfo"><bdi>localization.txt</bdi> · Last modified: <time datetime="2023-12-11T20:15:02+0100">2023-12-11 20:15</time> by <bdi>oiv</bdi></div> <hr class="a11y" /> </div></main>  <nav id="dokuwiki__pagetools" aria-labelledby="dokuwiki__pagetools__heading"> <h3 class="a11y" id="dokuwiki__pagetools__heading">Page Tools</h3> <div class="tools"> <ul> <li class="edit"><a href="/localization?do=edit" title="Edit this page [e]" rel="nofollow" accesskey="e"><span>Edit this page</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M20.71 7.04c.39-.39.39-1.04 0-1.41l-2.34-2.34c-.37-.39-1.02-.39-1.41 0l-1.84 1.83 3.75 3.75M3 17.25V21h3.75L17.81 9.93l-3.75-3.75L3 17.25z"/></svg></a></li><li class="revs"><a href="/localization?do=revisions" title="Old revisions [o]" rel="nofollow" accesskey="o"><span>Old revisions</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M11 7v5.11l4.71 2.79.79-1.28-4-2.37V7m0-5C8.97 2 5.91 3.92 4.27 6.77L2 4.5V11h6.5L5.75 8.25C6.96 5.73 9.5 4 12.5 4a7.5 7.5 0 0 1 7.5 7.5 7.5 7.5 0 0 1-7.5 7.5c-3.27 0-6.03-2.09-7.06-5h-2.1c1.1 4.03 4.77 7 9.16 7 5.24 0 9.5-4.25 9.5-9.5A9.5 9.5 0 0 0 12.5 2z"/></svg></a></li><li class="backlink"><a href="/localization?do=backlink" title="Backlinks" rel="nofollow"><span>Backlinks</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M10.59 13.41c.41.39.41 1.03 0 1.42-.39.39-1.03.39-1.42 0a5.003 5.003 0 0 1 0-7.07l3.54-3.54a5.003 5.003 0 0 1 7.07 0 5.003 5.003 0 0 1 0 7.07l-1.49 1.49c.01-.82-.12-1.64-.4-2.42l.47-.48a2.982 2.982 0 0 0 0-4.24 2.982 2.982 0 0 0-4.24 0l-3.53 3.53a2.982 2.982 0 0 0 0 4.24m2.82-4.24c.39-.39 1.03-.39 1.42 0a5.003 5.003 0 0 1 0 7.07l-3.54 3.54a5.003 5.003 0 0 1-7.07 0 5.003 5.003 0 0 1 0-7.07l1.49-1.49c-.01.82.12 1.64.4 2.43l-.47.47a2.982 2.982 0 0 0 0 4.24 2.982 2.982 0 0 0 4.24 0l3.53-3.53a2.982 2.982 0 0 0 0-4.24.973.973 0 0 1 0-1.42z"/></svg></a></li><li class="top"><a href="#dokuwiki__top" title="Back to top [t]" rel="nofollow" accesskey="t"><span>Back to top</span><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8v12z"/></svg></a></li> </ul> </div> </nav> </div>  <footer id="dokuwiki__footer"><div class="pad"> <div class="license">Except where otherwise noted, content on this wiki is licensed under the following license: <bdi><a href="https://creativecommons.org/licenses/by-sa/4.0/deed.en" rel="license" class="urlextern">CC Attribution-Share Alike 4.0 International</a></bdi></div> <div class="buttons"> <a href="https://creativecommons.org/licenses/by-sa/4.0/deed.en" rel="license"><img src="/lib/images/license/button/cc-by-sa.png" alt="CC Attribution-Share Alike 4.0 International" /></a> <a href="https://www.dokuwiki.org/donate" title="Donate" ><img src="/lib/tpl/dokuwiki/images/button-donate.gif" width="80" height="15" alt="Donate" /></a> <a href="https://php.net" title="Powered by PHP" ><img src="/lib/tpl/dokuwiki/images/button-php.gif" width="80" height="15" alt="Powered by PHP" /></a> <a href="//validator.w3.org/check/referer" title="Valid HTML5" ><img src="/lib/tpl/dokuwiki/images/button-html5.png" width="80" height="15" alt="Valid HTML5" /></a> <a href="//jigsaw.w3.org/css-validator/check/referer?profile=css3" title="Valid CSS" ><img src="/lib/tpl/dokuwiki/images/button-css.png" width="80" height="15" alt="Valid CSS" /></a> <a href="https://dokuwiki.org/" title="Driven by DokuWiki" ><img src="/lib/tpl/dokuwiki/images/button-dw.png" width="80" height="15" alt="Driven by DokuWiki" /></a> </div> <div style="margin-top: 2em; font-size:90%" class="dokuwiki"><div style="float:right"><a href="http://www.splitbrain.org/personal#imprint" style="float:right; text-decoration: none; color:#333">Imprint</a></div></div> <style type="text/css"> @media screen { body { padding-top: 30px; } #global__header { position: absolute; top: 0; left: 0; text-align: left; vertical-align: middle; line-height: 1.5; background-color: #333; box-shadow: 0 0 8px rgba(0,0,0,0.5); width: 100%; margin: 0; padding: 5px 20px; -moz-box-sizing: border-box; -webkit-box-sizing: border-box; box-sizing: border-box; white-space: nowrap; overflow: hidden; } #global__header h2 { position: absolute; left: -99999em; top: 0; overflow: hidden; display: inline; } #global__header ul, #global__header li { margin: 0; padding: 0; list-style: none; display: inline; line-height: 1.5; } #global__header a { color: #bbb; text-decoration: none; margin-right: 20px; font-size: 14px; font-weight: normal; } #global__header a:hover, #global__header a:active, #global__header a:focus { color: #fff; text-decoration: underline; } #global__header form { float: right; margin: 0 0 0 20px; } #global__header input { background-color: #333; background-image: none; border: 1px solid #bbb; color: #fff; box-shadow: none; border-radius: 2px; margin: 0; line-height: normal; padding: 1px 0 1px 0; height: auto; } #global__header input.button { border: none; color: #bbb; } #global__header input.button:hover, #global__header input.button:active, #global__header input.button:focus { color: #fff; text-decoration: underline; } } /* /@media */ @media only screen and (min-width: 601px) { /* changes specific for www.dokuwiki.org */ #dokuwiki__header { padding-top: 3em; } #dokuwiki__usertools { top: 3em; } /* changes specific for bugs.dokuwiki.org */ div#container div#showtask { top: 40px; } } /* /@media */ @media only screen and (max-width: 600px) { body { padding-top: 0; } #global__header { position: static; white-space: normal; overflow: auto; } #global__header form { float: none; display: block; margin: 0 0 .4em; } } /* /@media */ @media print { #global__header { display: none; } } /* /@media */ </style> <div id="global__header"> <h2>Global DokuWiki Links</h2> <form method="get" action="https://search.dokuwiki.org/" target="_top"> <input type="text" name="q" title="Search all DokuWiki sites at once" class="input" /> <input type="submit" title="Search all DokuWiki sites at once" value="Search" class="button" /> </form> <ul> <li><a href="https://download.dokuwiki.org" title="Download the latest release" target="_top">Download</a></li> <li><a href="https://www.dokuwiki.org" title="Read the DokuWiki documentation" target="_top">Wiki</a></li> <li><a href="https://forum.dokuwiki.org" title="Ask questions in the DokuWiki forum" target="_top">Forum</a></li> <li><a href="https://irc.dokuwiki.org" title="Check IRC chat logs or join the chat" target="_top">IRC</a></li> <li><a href="https://github.com/splitbrain/dokuwiki/issues" title="Report and track bugs" target="_top">Bugs</a></li> <li><a href="https://translate.dokuwiki.org/" title="Help translating the DokuWiki interface" target="_top">Translate</a></li> <li><a href="https://github.com/splitbrain/dokuwiki" title="Access the most recent git commits" target="_top">Git</a></li> <li><a href="https://xref.dokuwiki.org/reference/dokuwiki/" title="Cross-Reference of the DokuWiki source code" target="_top">XRef</a></li> <li><a href="https://codesearch.dokuwiki.org/" title="Search through the sources of DokuWiki, plugins and templates" target="_top">Code Search</a></li> </ul> </div>  </div></footer> </div></div> <div class="no"><img src="/lib/exe/taskrunner.php?id=localization&1732819898" width="2" height="1" alt="" /></div> <div id="screen__mode" class="no"></div></body> </html>