JDOC

Page Translation Quickstart Guide/be: Difference between revisions

From Joomla! Documentation

Created page with "Накірункі для хуткага пачатку пераклада"
 
mNo edit summary
 
(92 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<noinclude><languages /></noinclude>
<noinclude><languages /></noinclude>
This page should help get a translator quickly started with documentation translations. For the more detailed version of page translation, see [[S:MyLanguage/JDOC:Page Translation Explained|Page Translation Explained]]. To signup as a translator, please go to [[JDOC:Documentation Translators|Documentation Translators]] add your username.
Гэтая старонка патрэбна для дапамогі тым, хто жадае хутка атрымаць пераклад дакументацыі. Для знаёмства з большымі падрабязнасцямі аб перакладах старонак, вывучайце [[S:MyLanguage/JDOC:Page Translation Explained|раз'ясненні аб тым, як рабіць пераклады]]. Каб зарэгістравацца ў якасці перакладчыка – калі ласка – звярніцеся ў [[JDOC:Documentation Translators|аддзел перакладчыкаў дакументацыі]] і дадайце туды сваё імя.


When your userid is approved you can find documents to translate for your language at [https://docs.joomla.org/index.php?title=Special%3ALanguageStats&x=D&language=en&suppresscomplete=1&group=page-Chunk30%3AHelp+screen+column+header+Search+Term Language Statistics].
<div class="mw-translate-fuzzy">
When you open a document for translation in a new window, you will see a list of pieces to translate. At the top there is a link to the document you are translating. Open this in a new window and you have everything together. You can translate at one screen, and check what you did translate at the other.
Калі Вашае імя будзе падцверджана – Вы зможаце знайсці дакументы для перакладу на Вашу мову там: [https://docs.joomla.org/index.php?title=Special%3ALanguageStats&x=D&language=en&suppresscomplete=1&group=page-Chunk30%3AHelp+screen+column+header+Search+Term Моўная статыстыка].
</div>
Калі Вы адчыніце дакумент для перакладу ў новым акенцы – Вы убачыце спіс частак, якія трэба перакласці. Уверсе будзе спасылка на дакумент, які Вы перакладаеце; адчыніце яе ў новым акенцы – і Вы будзеце бачыць усё разам. Вы зможаце перакладаць на адным экране і правяраць, што Вы пераклалі – на іншым.


If you are already a signed up as a translator, you can play in the [[S:MyLanguage/JDOC:Translation Sandbox|Translation Sandbox]].
Калі Вы ужо увайшлі як перакладчык – Вы можаце таксама правесці некаторы час у [[S:MyLanguage/JDOC:Translation Sandbox|Пясочніцы Перакладаў]].


It is good to know how parts of the documents are marked for translation.
Добра, калі вядома, колькі частак дакумента пазначана для перакладу! Звычайна, гэта робіцца наступным чынам:
In general it is this way
<code><nowiki><translate><T:Нумар>Тэкст для перакладу</translate></nowiki></code> – і калі Вы перакладаеце, то Вы убачыце ''Тэкст для перакладу'', які можна перакладаць. Тэгі <code><nowiki><translate></translate></nowiki></code> ставяцца кімсьці, хто пазначае дакумент на пераклад; тэг <code><nowiki><T:Нумар></nowiki></code> ставіцца сістэмай.
<code><nowiki><translate><T:number>Text to translate</translate></nowiki></code> and when you translate you will see ''Text to translate'', which you can translate. The <code><nowiki><translate></translate></nowiki></code> is put by the person who marks the document for translation, the <code><nowiki><T:number></nowiki></code> is done by the system.


== The Interface ==
== Інтэрфейс ==
If a page is ready to translate you will see (images below) or a variation (based on view of page):
Калі старонка гатовая для перакладу – Вы убачыце тое (наступныя выявы), альбо – варыяцыю (высноўна на тыпу старонкі):


<div class="panel" style="max-width:340px;">
<div class="panel" style="max-width:340px;">
[[File:JDOC-translate-page-notice-en.png|Localised view of link in English]]
[[File:JDOC-translate-page-notice-en.png|Выгляд старонкі на Англійскай мове]]
</div>
</div>


<div class="panel" style="max-width:600px;">
<div class="panel" style="max-width:600px;">
[[File:JDOC-translate-page-notice-nl-en.png|Localised view of link in Dutch]]
[[File:JDOC-translate-page-notice-nl-<div lang="en" dir="ltr" class="mw-content-ltr">
en
</div>.png|Выгляд старонкі, якая перакладзена ў Dutch]]
</div>
</div>


After you click the translation link, you will then see the following interface for translation. Documentation now has a ULS (Universal Language Selector) installed which will automatically set the user interface to their localised language. This is based on the browser (its language setting) and/or geographic location. The language setting may also be overridden manually by selecting the user icon (top right) and from the dropdown click on the language at the very top. You may also go to your user [[Special:Preferences#mw-prefsection-personal-i18n|personal preferences for language]].
Пасля таго як Вы адкрыеце спасылку стварэння пераклада, Вы убачыце наступны інтэрфейс для ажыццяўлення пераклада. Дакументацыя зараз мае універсальны абіральнік мовы, які дапамагае аўтаматычна рабіць інтэрфейс карыстальніка суадказным абранай мове. Гэта аснавана на браўзэре (азначаных у ім наладах мовы) і/ці геаграфічным месцазнаходжанні. Моўныя налады могуць быць таксама зменены праз самастойнае абіранне цераз іконку карыстальніка (уверсе-зправа) і клік па мове ў выпадаючым меню уверсе. Вы таксама можаце перайсці да Вашых карыстальніц налад [[Special:Preferences#mw-prefsection-personal-i18n|асабістага выбару мовы]].
<div class="panel">
<div class="panel">
[[File:JDOC-translator interface-first-view-en.png]]
[[File:JDOC-translator interface-first-view-<div lang="en" dir="ltr" class="mw-content-ltr">
en
</div>.png]]
</div>
</div>


Now you are ready to translate, click any link in the separated message units.
Цяпер – Вы гатовыя да перакладу; абярыце праз клік любую спасылку сярод падзеленых адзінак паведамленняў аб магчымых накірунках перакладаў.
<div class="panel">
<div class="panel">
[[File:JDOC-translator interface-editing-view-en.png]]
[[File:JDOC-translator interface-editing-view-<div lang="en" dir="ltr" class="mw-content-ltr">
en
</div>.png]]
</div>
</div>


You may click the suggested text to add it automatically to the edit window. Then you may edit the text. The suggested text is provided by translation services for free. There is no guarantee there will be suggested text. The suggestion query may time out at the translation services server.  
Вы можаце клікнуць прапановы тэкст каб дадаць яго аўтаматычна ў вакенца рэдагавання. Тады Вы зможаце яго змяніць. Прапанаваны тэкст даецца службай перакладаў забясплатна. Але няма гарантыі, што такі тэкст будзе увогуле прапанаваны. Прапанова ідзе праз чаргу, якую могуць не дачакацца на сервере службы перакладу.  


When you are satisfied with your translation, save it. You can also skip sections if you only want to translate some of the message groups.
Калі Вы будзеце задаволеныя сваім перакладам – захавайце яго. Вы можаце таксама прапусціць часткі, калі Вы жадаеце перакласць толькі некаторыя з паведамленняў.


==Page Titles==
==Назвы старонак==
Page titles '''can and should''' be translated. They are the first message group at the top of the editing interface.
Назвы старонак – '''могуць і павінны''' быць перакладзеныя. Яны – першыя паведамленні, згуртаваныя на вяршыні рэдагавальнага інтэрфейсу.
{{warning|title=Important!|'''Do not translate the namespace!''' This is anything in a title proceeding and including the : (colon).}}
{{warning|title=Важна!|'''Не перакладайце прастранствы імёнаў!''' Гэта – усё, што ідзе ў назве перад двукроп'ем (:) і само двукроп'е.}}


A page name is in a namespace when it looks like this: "'''Prefix:'''Name of page".
Назва старонкі уваходзіць у прастранства імёнаў, калі выглядае наступным чынам: "'''Прэфікс:'''Назва старонкі".


This page name is not in a namespace when it looks like this: "Name of page".
Назва старонкі не уваходзіць у прастранства імёнаў, калі выглядае наступным чынам: "Назва старонкі".


{| class="wikitable"
{| class="wikitable"
! Correct? !! Title Examples
! Ці добра? !! Прыклады назваў
|-
|-
| '''Yes!!!'''
| '''Так!!!'''
|"J2.5:Title of a Page" translated "Título de la página"
|"J2.5:Title of a Page" перакладаецца як "Назва старонкі"


"J2.5:Title of a Page" translated "Titel einer Seite"
"J2.5:Title of a Page" перакладаецца як "Titel einer Seite"
|-
|-
| '''NO!'''
| '''Не!'''
|"J2.5:Title of a Page" translated "J2.5:Título de la página"
|"J2.5:Title of a Page" перакладзенае як "J2.5:Назва старонкі"


"J2.5:Title of a Page" translated "J2.5:Titel einer Seite"
"J2.5:Title of a Page" перакладзенае як "J2.5:Titel einer Seite"
|}
|}


== Links ==
== Спасылкі ==
{{warning|title=Important Information about links|Please review this carefully, linking between pages will affect browsing in any language different than the source language. The objective is to provide links localised in the browsing user's language, linking to the browsing user's language view of a translated page.}}
{{warning|title=Важная інфармацыя аб спасылках|Калі ласка: праглядзіце гэта уважліва. Стварэнне спасылак паміж старонкамі уплывае на агляданне ва ўсіх мовах, якія адрозніваюцца ад ісходнай. Мэта – дадаць спасылкі, лакалізаваныя да мовы, на якой вядзецца агляд, – праз стварэнне спасылак да выгляду, які мае старонка пасля перакладу на мову, якая выкарыстоўваецца ў аглядзе.}}


The information below is a quick overview. For a more detailed explanation, see [[S:MyLanguage/JDOC:Translating_Links|Translating Links]].
Далейшая інфармацыя (унізе) – хуткі агляд. Для больш падрабязнага аб'яснення – глядзіце [[S:MyLanguage/JDOC:Translating_Links|аб перакладах  спасылак]].


===Standard Internal Page Links===
===Стандартныя спасылкі на унутраныя старонкі===
Hyperlinks to another page are easy in the source language, they are page names between <code><nowiki>[[ (brackets) ]]</nowiki></code> or the variations as listed below. Good source page standards for page links will start to include the proper link markup for translated navigation.
Гіпер-спасылкі на іншыя старонкі – простыя для ісходнай мовы; яны з'яўляюцца назвамі старонак, што заключаны ў <code><nowiki>[[ (кавычкі) ]]</nowiki></code> альбо інакш, як паказана ніжэй... Добрыя ісходныя старонкі павінны выконваць стандарт аб спасылках на старонкі: мець добрую разметку для навігацыі па перакладах.


#<code><nowiki>[[JDOC:Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox]]</nowiki></code> будзе [[JDOC:Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translation Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox|Translation Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Пясочніца перакладаў]]</nowiki></code> будзе [[JDOC:Translation Sandbox|Пясочніца перакладаў]]
#<code><nowiki>[[JDOC:Translation Sandbox|Translator Sandbox]]</nowiki></code> becomes [[JDOC:Translation Sandbox|Translator Sandbox]]
#<code><nowiki>[[JDOC:Translation Sandbox|Пясочніца перакладаў]]</nowiki></code> будзе [[JDOC:Translation Sandbox|Пясочніца перакладаў]]


Links from a translated page to a page in the same language must be run through a localisation link processor.
Спасылкі з перакладзенай старонкі на старонку з той жа мовай – павінны быць зроблены праз апрацоўшчык перакладаў старонак.


#<code><nowiki>[[Special:MyLanguage/JDOC:Translation Sandbox]]</nowiki></code> becomes [[Special:MyLanguage/JDOC:Translation Sandbox]]{{-}}This above really isn't a nice looking link, nor is it shown in the reader's language. To improve the user experience, see the Dutch translation example link below.
#<code><nowiki>[[Special:MyLanguage/JDOC:Translation Sandbox]]</nowiki></code> будзе [[Special:MyLanguage/JDOC:Translation Sandbox]]{{-}} Гэты прыклад уверсе – не добрая спасылка, і яна не адлюструецца на мове чытача. Каб палепшыць жыццё карыстальніка, глядзіце прыклад переклада спасылкі на Dutch вышэй.
#<code><nowiki>[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]</nowiki></code> becomes [[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]{{-}}Now a Dutch reader will see the link in their language. Just the same as above, you can name the link anything.
#<code><nowiki>[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]</nowiki></code> будзе [[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]{{-}}Цяпер чытач Dutch убачыць спасылку на сваёй мове. Таксама як у гэтым прыкладзе – Вы можаце назваць спасылку так, як трэба.


There is an alias to the word <code>Special:</code>, so you may also use just the letter <code>S:</code> as a short version of <code>Special:</code>.
Існуе замена для коду <code>Special:</code>: Вы можаце карыстацца проста літарай <code>S:</code> як скарачэннем ад <code>Special:</code>.


====Important Link Tips====
====Важныя парады аб спасылках====
* Always use <pre>[[Special:MyLanguage/<source language pagename>|<the translation>]]</pre>
* Заўсёды выкарыстоўвайце <pre>[[Special:MyLanguage/<Назва старонкі на ісходнай мове>|<Пераклад>]]</pre>
* Or <pre>[[S:MyLanguage/<source language pagename>|<the translation>]]</pre>
* Ці <pre>[[S:MyLanguage/<Назва старонкі на ісходнай мове>|<Пераклад>]]</pre>
An example would be:
Прыклад будзе такі:


<pre>
<pre>
[[JDOC:Translation Sandbox|Translation Sandbox]]  
[[JDOC:Translation Sandbox|Translation Sandbox]]  
   is translated as
   будзе перакладзена як
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
  or
  ці
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
</pre>
</pre>


'''So Remember''': Always add Special:MyLanguage/ in front of the the <nowiki><source page name></nowiki>. The <nowiki><source page name></nowiki> is always untranslated. Always add a | if it is missing and then the translation of <nowiki><source page name></nowiki>.
'''Таму – памятайце''': Заўсёды дадавайце Special:MyLanguage/ перад <nowiki><Назвай старонкі на яе ісходнай мове></nowiki>. <nowiki><Назва старонкі на яе ісходнай мове></nowiki> заўсёды астаўляйце неперакладзенай. Заўсёды дадавайце знак | (калі яго няма) і потым пераклад <nowiki><Назвы старонкі на яе ісходнай мове></nowiki>.
Often this <code><nowiki>Special:MyLanguage/</nowiki></code> is already added in the source document. So when <code><nowiki>Special:MyLanguage/JDOC:Translation Sandbox|<translate>Translation Sandbox</translate></nowiki></code> is in the original document you only have to translate <code><nowiki>Translation Sandbox</nowiki></code> and you don't see the total link.
Часта гэты <code><nowiki>Special:MyLanguage/</nowiki></code> ужо ёсць у ісходным дакуменце. Таму калі <code><nowiki>Special:MyLanguage/JDOC:Translation Sandbox|<translate>Translation Sandbox</translate></nowiki></code> ёсць у ісходным дакуменце, Вам трэба толькі перакласці <code><nowiki>Translation Sandbox</nowiki></code> і Вы не будзеце бачыць усю спасылку.


===External Links===
===Знешнія спасылкі===
External links are easy to translate. They are written like this in the source language.
Знешнія спасылкі проста перакладаць. Яны напісаны як у ісходнай мове.


# <code><nowiki>http://www.php.net</nowiki></code> becomes http://www.php.net
# <code><nowiki>https://www.php.net/</nowiki></code> будзе https://www.php.net/
# <code><nowiki>[http://www.php.net for php information]</nowiki></code> becomes [http://www.php.net for php information]
# <code><nowiki>[https://www.php.net/ or PHP information]</nowiki></code> будзе [https://www.php.net/ or PHP information]


'''What to translate?'''  
'''Што перакладаць?'''  
# This is a standard URL and will not require translating. <code><nowiki>http://www.php.net</nowiki></code> It is a regular hyperlink and must be written as such. No translation required.
# Гэта – звычайнае УРМ (універсальнае рэсурснае месцазнаходжанне) і не патрабуе пераклада: <code><nowiki>https://www.php.net/</nowiki></code> – гэта звычайная гіпер-спасылка і яе і трэба так пісаць. Пераклад не патрэбен.
# This <code><nowiki>[http://www.php.net for php information]</nowiki></code> will only require the translation of '''for php information'''.
# Гэтае <code><nowiki>[https://www.php.net/ for PHP information]</nowiki></code> будзе патрабаваць перакладу толькі для '''for PHP information'''.


== Categories ==
== Катэгорыі ==
{{warning|title=Categories Require a Specific Method!|One thing to be aware of is that when translating a page, any 'category' links in the page should be modified to also include the appropriate language code.}}
{{warning|title=Катэгорыям патрэбны асабісты мэтад!|Адна рэч, пра якую трэба памятаць пры працы па перакладу старонкі: любую катэгорыю (як спасылку на старонке) трэба перакладаць з даданнем у яе адпаведнага моўнага коду.}}


The translation of a category is very easy, just add '''/<language code>''' to the end of the category name.
Пераклад катэгорыі – вельмі просты: дадайце '''/<Код мовы>''' у канец назвы катэгорыі.


===Do This===
===Зрабіце так===
For example, if you translate a page from English to Spanish (language code '''es''') and the page contains the following category:
Напрыклад, калі Вы перакладаеце з English на Spanish (код мовы – '''es''') і старонка мае наступную катэгорыю:
<pre><nowiki>[[Category:Development]]</nowiki></pre>
<pre><nowiki>[[Category:Development]]</nowiki></pre>
You need to add '''/es''' to the end of the category name.
Вам трэба дадаць '''/es''' у канец назвы катэгорыі.
<pre><nowiki>[[Category:Developement/es]]</nowiki></pre>
<pre><nowiki>[[Category:Developement/es]]</nowiki></pre>


Category pages can be translated as well (which should be quick - most are blank except for containing a parent category) and will be part of a special categorisation project when ready.
Старонкі катэгорый могуць быць таксама перакладзены (што павінна рабіцца хутка: большасць такіх старонак – пустыя, за выключэннем звестак пра катэгорыю, у якой знаходзіца дадзеная) і будуць часткай спецыяльнага праекта аб катэгорыях, калі ўсё будзе зроблена.


To be prepared for this we can add '''/nl|Ontwikkeling''' (Dutch language) at the end of the category name
Каб падрыхтавацца да гэтага, мы можам дадаць '''/nl|Ontwikkeling''' (Dutch мова) у канец назвы катэгорыі.
<pre><nowiki>[[Category:Developement/nl|Ontwikkeling]]</nowiki></pre>
<pre><nowiki>[[Category:Developement/nl|Ontwikkeling]]</nowiki></pre>


===Do Not Do This===
===Што не рабіць===
There are a few things you should not do.
А вось некальці рэчаў, якія лепш не рабіць!


'''Please do not do this'''
'''Калі ласка: не рабіце так'''


Translate the word 'Category' or the name of the category.
Пераклад слова 'Category' альбо назвы катэгорыі наступным чынам:
<pre><nowiki>[[Category:Development]] to [[Categorie:Ontwikkeling]]</nowiki></pre>
<pre><nowiki>[[Category:Development]] to [[Categorie:Ontwikkeling]]</nowiki></pre>
{{-}}
{{-}}
'''Or this'''
'''Ці так'''


Translate just the name of the category.
Пераклад толькі назвы катэгорыі наступным чынам:
<pre><nowiki>[[Category:Development]] to [[Category:Ontwikkeling]]</nowiki></pre>
<pre><nowiki>[[Category:Development]] to [[Category:Ontwikkeling]]</nowiki></pre>


== Images ==
== Выявы ==


It is expected translated page will want to show images localised in the language of the page. This is encouraged because it improves the user's experience. Documentation only asks translators to follow a naming pattern of images consistent with the source language of a page.
Чакаецца, што перакладзеныя старонкі будуць адлюстроўваць выявы, лакалізаваныя ў мову старонкі. Гэта добра, бо палягчае жыццё карыстальніку. Дакументацыя толькі запрашае перакладчыкаў суадносіць шаблён назваў выяў з ісходнай мовай старонкі.


===Image Naming===
===Іменаванне выяў===


Using an image used above on this page which is written as:  
Выкарыстуючы выявы, якая выкарыстоўвалася вышэй на гэтай старонке, што азначана як:  
<pre><nowiki>[[File:JDOC-translator_interface-editing-view.png]]</nowiki></pre>
<pre><nowiki>[[File:JDOC-translator_interface-editing-view.png]]</nowiki></pre>


====Do This====
====Рабіце так====


Keep the name of the image and just add the language code to the end:  
Захоўвайце імя выявы і проста дадайце код мовы ў канец:  
<pre>
<pre>
español would be es <nowiki>[[File:JDOC-translator_interface-editing-view-es.png]]</nowiki>
español будзе es <nowiki>[[File:JDOC-translator_interface-editing-view-es.png]]</nowiki>
italiano would be it <nowiki>[[File:JDOC-translator_interface-editing-view-it.png]]</nowiki>
italiano будзе it <nowiki>[[File:JDOC-translator_interface-editing-view-it.png]]</nowiki>
português would be pt <nowiki>[[File:JDOC-translator_interface-editing-view-pt.png]]</nowiki>
português будзе pt <nowiki>[[File:JDOC-translator_interface-editing-view-pt.png]]</nowiki>
</pre>
</pre>
If the file is not a localised file type (e.g Screenshot of an interface) and is a graphic of something universal (e.g. a ball or arrow), you should not have to rename the image. If the image has a caption, you may have to translate the caption.
Калі ж сам файл не лакалізаваны (напрыклад здымак экрана з інтэрфейсам) і зяўляецца выявай чагосьці універсальнага (напрыклад шар ці страла) – Вам не трэба перанайменваць выяву. Калі ж выява мае заглаўе, Вам можа спатрэбіцца пераклад заглаўя.


<pre>
<pre>
<nowiki>[[File:ball.png|caption=This is a ball]]</nowiki>
<nowiki>[[File:ball.png|caption=This is a ball]]</nowiki>
Will become
будзе
<nowiki>[[File:ball.png|caption=<translate this part only>]]</nowiki>
<nowiki>[[File:ball.png|caption=<Перакладайце толькі гэта>]]</nowiki>
</pre>
</pre>


After you finish translating a page with images you will localise. You should view the page in the language you just translated it too and click on the "red" file links. This will allow you to upload the localised version of the file.
Пасля таго, як Вы скончыце пераклад, старонка з выявамі будзе лакалізаваная. Вам трэба будзе аглядзець старонку ў мове, на якую Вы яе пераклалі, і нажымаць "чырвоныя" файлавыя спасылкі. Гэта дазволіць Вам запампаваць лакалізаваную версію файла.


Often the image in the document to translate has already a language ID which is marked for translation: <code><nowiki>[[File:JDOC-translator_interface-editing-view-<translate>en</translate>.png]]</nowiki></code>. So you will have to translate '''en''' into your local language ID (in Dutch '''nl'''). If the image has no localised items you want to translate you can translate '''en''' into '''en''' to keep the original image.
Часта выява ў дакуменце, які перакладаюць, ужо мае ID мовы, з якой трэба перакласць: <code><nowiki>[[File:JDOC-translator_interface-editing-view-<translate>en</translate>.png]]</nowiki></code>. Так што Вы перакладзеце '''en''' у Ваш лакальны ID мовы (у Dutch – '''nl'''). Калі выява не мае лакалізаваных частак, якія Вы жадаеце перакласці – Вы можаце перакласці '''en''' у '''en''', каб пакінуць ісходную выяву.
====Do Not Do This====  
====Не рабіце наступнае====  
If you don't insert your local image (because you don't have time at the moment) it's better not to translate '''en''' into your language, else you will have a "red" file link.  
Калі Вы не ўставіце сваю лакальную выяву (бо няма) – лепш не перакладаць '''en''' ва сваю мову; інакш Вы атрымаеце "чырвоную" файлавую спасылку.  


== Chunks ==  
== Часткі ==  


Chunks are pieces of documentation which can be used at more then one place. There are big chunks, but most of them are small peaces of documentation, sometimes only one line. For example, it is used for the colomnheaders in the helpscreens where the same fields are used in many helpscreens
<div lang="en" dir="ltr" class="mw-content-ltr">
Chunks are pieces of documentation which can be used at more than one place. There are big chunks, but most of them are small pieces of documentation, sometimes only one line. For example, it is used for the column headers in the helpscreens where the same fields are used in many help screens
</div>


===Usage of Chunks===  
<span lang="en" dir="ltr" class="mw-content-ltr">===Usage of Chunks===</span>


Using a chunk in a document is very easy. If we see: https://docs.joomla.org/Chunk30:Help_screen_column_header_Show_Title we can use it in a document with the following code:
<div lang="en" dir="ltr" class="mw-content-ltr">
<pre><nowiki>{{Chunk30:colheader|Show Title/<translate>en</translate>}}</nowiki></pre>
Using a chunk in a document is very easy. If we see: https://docs.joomla.org/Chunk30:Help_screen_Show_Title we can use it in a document with the following code:
<pre><nowiki>{{Chunk30:Help_screen_Show_Title/<translate>en</translate>}}</nowiki></pre>
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
If we use this in a document we see the following:
If we use this in a document we see the following:
{{Chunk30:colheader|Show Title/en}}
</div>
{{Chunk30:Help_screen_Show_Title/<div lang="en" dir="ltr" class="mw-content-ltr">
en
</div>}}
<div lang="en" dir="ltr" class="mw-content-ltr">
So you will have to translate '''en''' into your local language ID (in Dutch '''nl'''). If, after translation, the chunk is not available in your language, you will see a red link. Use the link and open it in a new window. You will see a message that the document does not exist. What you must do now is:
So you will have to translate '''en''' into your local language ID (in Dutch '''nl'''). If, after translation, the chunk is not available in your language, you will see a red link. Use the link and open it in a new window. You will see a message that the document does not exist. What you must do now is:
Remove the language code in the URL, in Dutch /'''nl''', Now you will see the chunk in English. Translate the chunk into your language (only the first line is enough) and the chunk is created in your language and visible in the source document.  
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
Remove the language code in the URL, in Dutch /'''nl''', Now you will see the chunk in English. Translate the chunk into your language (only the first line is enough) and the chunk is created in your language and visible in the source document.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
There is a more sophisticated way of usage of chunks, with parameters. This way you can pass parameters to the chunk in your own language. We do this with the following code:
There is a more sophisticated way of usage of chunks, with parameters. This way you can pass parameters to the chunk in your own language. We do this with the following code:
<pre><nowiki>{{Chunk30:Help_screen_toolbar_icon_Save/<translate>en</translate>|<translate>menu item</translate>}}</nowiki></pre>
<pre><nowiki>{{Chunk30:Help_screen_toolbar_icon_Save/<translate>en</translate>|<translate>menu item</translate>}}</nowiki></pre>
The source of this chunk is:
The source of this chunk is:
<pre><nowiki>*'''Save:''' Saves the {{{1|item}}} and stays in the current screen.</nowiki></pre>
<pre><nowiki>*'''Save'''. Saves the {{{1|item}}} and stays in the current screen.</nowiki></pre>
When we use this in a document the result will be:
When we use this in a document the result will be:
{{Chunk30:Help_screen_toolbar_icon_Save/en|menu item}}
</div>
{{Chunk30:Help_screen_toolbar_icon_Save/<div lang="en" dir="ltr" class="mw-content-ltr">
en
</div>|<div lang="en" dir="ltr" class="mw-content-ltr">
menu item
</div>}}
<div lang="en" dir="ltr" class="mw-content-ltr">
This way the translation of '''en''' will bring us in the language we want and the translation of '''menu item''' will used in the '''item'''.
This way the translation of '''en''' will bring us in the language we want and the translation of '''menu item''' will used in the '''item'''.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
== Templates ==
== Templates ==
Templates are reusable pieces of code which have a predictable result.
Templates are reusable pieces of code which have a predictable result.
</div>


<pre>
<pre>
<div lang="en" dir="ltr" class="mw-content-ltr">
{{tip|title=This is a tip|This is the body content of a tip!}}
{{tip|title=This is a tip|This is the body content of a tip!}}
</div>
</pre>
</pre>


<div lang="en" dir="ltr" class="mw-content-ltr">
Would look like this:
Would look like this:
</div>


{{tip|title=This is a tip|This is the body content of a tip!}}
{{tip|title=<div lang="en" dir="ltr" class="mw-content-ltr">
This is a tip
</div>|<div lang="en" dir="ltr" class="mw-content-ltr">
This is the body content of a tip!
</div>}}


===Do This===
<span lang="en" dir="ltr" class="mw-content-ltr">===Do This===</span>


<div lang="en" dir="ltr" class="mw-content-ltr">
For the above example:
For the above example:
</div>
<pre>
<pre>
<div lang="en" dir="ltr" class="mw-content-ltr">
{{tip|title=This is a tip|This is the body content of a tip!}}
{{tip|title=This is a tip|This is the body content of a tip!}}
</div>
</pre>
</pre>


<div lang="en" dir="ltr" class="mw-content-ltr">
You would have to do the following:
You would have to do the following:
</div>
<pre>
<pre>
<div lang="en" dir="ltr" class="mw-content-ltr">
{{tip|title=<translate the title>|<translate the body content>}}
{{tip|title=<translate the title>|<translate the body content>}}
</div>
</pre>
</pre>


<div lang="en" dir="ltr" class="mw-content-ltr">
===Do Not Do This===
===Do Not Do This===
Here is a list of don't do's.
Here is a list of don't do's.
</div>


<div lang="en" dir="ltr" class="mw-content-ltr">
*Never translate the template's name. The template {{tl|tip}} is called by the word 'tip' following the double set of curly brackets. If you translate the word tip, the translation would call a non-existent template name.
*Never translate the template's name. The template {{tl|tip}} is called by the word 'tip' following the double set of curly brackets. If you translate the word tip, the translation would call a non-existent template name.
</div>
<div lang="en" dir="ltr" class="mw-content-ltr">
*Never translate the variables used in a template, only the value assigned to the variable. In the example of the {{tl|tip}} template, the word 'title' is the variable.
*Never translate the variables used in a template, only the value assigned to the variable. In the example of the {{tl|tip}} template, the word 'title' is the variable.
</div>


<noinclude>
<noinclude>
<div lang="en" dir="ltr" class="mw-content-ltr">
[[Category:Documentation Translation]]
[[Category:Documentation Translation]]
</div>
</noinclude>
</noinclude>

Latest revision as of 08:59, 21 July 2022

Other languages:

Гэтая старонка патрэбна для дапамогі тым, хто жадае хутка атрымаць пераклад дакументацыі. Для знаёмства з большымі падрабязнасцямі аб перакладах старонак, вывучайце раз'ясненні аб тым, як рабіць пераклады. Каб зарэгістравацца ў якасці перакладчыка – калі ласка – звярніцеся ў аддзел перакладчыкаў дакументацыі і дадайце туды сваё імя.

Калі Вашае імя будзе падцверджана – Вы зможаце знайсці дакументы для перакладу на Вашу мову там: Моўная статыстыка.

Калі Вы адчыніце дакумент для перакладу ў новым акенцы – Вы убачыце спіс частак, якія трэба перакласці. Уверсе будзе спасылка на дакумент, які Вы перакладаеце; адчыніце яе ў новым акенцы – і Вы будзеце бачыць усё разам. Вы зможаце перакладаць на адным экране і правяраць, што Вы пераклалі – на іншым.

Калі Вы ужо увайшлі як перакладчык – Вы можаце таксама правесці некаторы час у Пясочніцы Перакладаў.

Добра, калі вядома, колькі частак дакумента пазначана для перакладу! Звычайна, гэта робіцца наступным чынам: <translate><T:Нумар>Тэкст для перакладу</translate> – і калі Вы перакладаеце, то Вы убачыце Тэкст для перакладу, які можна перакладаць. Тэгі <translate></translate> ставяцца кімсьці, хто пазначае дакумент на пераклад; тэг <T:Нумар> ставіцца сістэмай.

Інтэрфейс

Калі старонка гатовая для перакладу – Вы убачыце тое (наступныя выявы), альбо – варыяцыю (высноўна на тыпу старонкі):

Выгляд старонкі на Англійскай мове

[[File:JDOC-translate-page-notice-nl-

en

.png|Выгляд старонкі, якая перакладзена ў Dutch]]

Пасля таго як Вы адкрыеце спасылку стварэння пераклада, Вы убачыце наступны інтэрфейс для ажыццяўлення пераклада. Дакументацыя зараз мае універсальны абіральнік мовы, які дапамагае аўтаматычна рабіць інтэрфейс карыстальніка суадказным абранай мове. Гэта аснавана на браўзэре (азначаных у ім наладах мовы) і/ці геаграфічным месцазнаходжанні. Моўныя налады могуць быць таксама зменены праз самастойнае абіранне цераз іконку карыстальніка (уверсе-зправа) і клік па мове ў выпадаючым меню уверсе. Вы таксама можаце перайсці да Вашых карыстальніц налад асабістага выбару мовы.

[[File:JDOC-translator interface-first-view-

en

.png]]

Цяпер – Вы гатовыя да перакладу; абярыце праз клік любую спасылку сярод падзеленых адзінак паведамленняў аб магчымых накірунках перакладаў.

[[File:JDOC-translator interface-editing-view-

en

.png]]

Вы можаце клікнуць прапановы тэкст каб дадаць яго аўтаматычна ў вакенца рэдагавання. Тады Вы зможаце яго змяніць. Прапанаваны тэкст даецца службай перакладаў забясплатна. Але няма гарантыі, што такі тэкст будзе увогуле прапанаваны. Прапанова ідзе праз чаргу, якую могуць не дачакацца на сервере службы перакладу.

Калі Вы будзеце задаволеныя сваім перакладам – захавайце яго. Вы можаце таксама прапусціць часткі, калі Вы жадаеце перакласць толькі некаторыя з паведамленняў.

Назвы старонак

Назвы старонак – могуць і павінны быць перакладзеныя. Яны – першыя паведамленні, згуртаваныя на вяршыні рэдагавальнага інтэрфейсу.

Важна!

Не перакладайце прастранствы імёнаў! Гэта – усё, што ідзе ў назве перад двукроп'ем (:) і само двукроп'е.


Назва старонкі уваходзіць у прастранства імёнаў, калі выглядае наступным чынам: "Прэфікс:Назва старонкі".

Назва старонкі не уваходзіць у прастранства імёнаў, калі выглядае наступным чынам: "Назва старонкі".

Ці добра? Прыклады назваў
Так!!! "J2.5:Title of a Page" перакладаецца як "Назва старонкі"

"J2.5:Title of a Page" перакладаецца як "Titel einer Seite"

Не! "J2.5:Title of a Page" перакладзенае як "J2.5:Назва старонкі"

"J2.5:Title of a Page" перакладзенае як "J2.5:Titel einer Seite"

Спасылкі

Важная інфармацыя аб спасылках

Калі ласка: праглядзіце гэта уважліва. Стварэнне спасылак паміж старонкамі уплывае на агляданне ва ўсіх мовах, якія адрозніваюцца ад ісходнай. Мэта – дадаць спасылкі, лакалізаваныя да мовы, на якой вядзецца агляд, – праз стварэнне спасылак да выгляду, які мае старонка пасля перакладу на мову, якая выкарыстоўваецца ў аглядзе.


Далейшая інфармацыя (унізе) – хуткі агляд. Для больш падрабязнага аб'яснення – глядзіце аб перакладах спасылак.

Стандартныя спасылкі на унутраныя старонкі

Гіпер-спасылкі на іншыя старонкі – простыя для ісходнай мовы; яны з'яўляюцца назвамі старонак, што заключаны ў [[ (кавычкі) ]] альбо інакш, як паказана ніжэй... Добрыя ісходныя старонкі павінны выконваць стандарт аб спасылках на старонкі: мець добрую разметку для навігацыі па перакладах.

  1. [[JDOC:Translation Sandbox]] будзе JDOC:Translation Sandbox
  2. [[JDOC:Translation Sandbox|Пясочніца перакладаў]] будзе Пясочніца перакладаў
  3. [[JDOC:Translation Sandbox|Пясочніца перакладаў]] будзе Пясочніца перакладаў

Спасылкі з перакладзенай старонкі на старонку з той жа мовай – павінны быць зроблены праз апрацоўшчык перакладаў старонак.

  1. [[Special:MyLanguage/JDOC:Translation Sandbox]] будзе Special:MyLanguage/JDOC:Translation Sandbox
    Гэты прыклад уверсе – не добрая спасылка, і яна не адлюструецца на мове чытача. Каб палепшыць жыццё карыстальніка, глядзіце прыклад переклада спасылкі на Dutch вышэй.
  2. [[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]] будзе Vertaling Sandbox
    Цяпер чытач Dutch убачыць спасылку на сваёй мове. Таксама як у гэтым прыкладзе – Вы можаце назваць спасылку так, як трэба.

Існуе замена для коду Special:: Вы можаце карыстацца проста літарай S: як скарачэннем ад Special:.

Важныя парады аб спасылках

  • Заўсёды выкарыстоўвайце 
    [[Special:MyLanguage/<Назва старонкі на ісходнай мове>|<Пераклад>]]
  • Ці 
    [[S:MyLanguage/<Назва старонкі на ісходнай мове>|<Пераклад>]]

Прыклад будзе такі: 

[[JDOC:Translation Sandbox|Translation Sandbox]] 
  будзе перакладзена як
[[Special:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]
 ці
[[S:MyLanguage/JDOC:Translation Sandbox|Vertaling Sandbox]]

Таму – памятайце: Заўсёды дадавайце Special:MyLanguage/ перад <Назвай старонкі на яе ісходнай мове>. <Назва старонкі на яе ісходнай мове> заўсёды астаўляйце неперакладзенай. Заўсёды дадавайце знак | (калі яго няма) і потым пераклад <Назвы старонкі на яе ісходнай мове>. Часта гэты Special:MyLanguage/ ужо ёсць у ісходным дакуменце. Таму калі Special:MyLanguage/JDOC:Translation Sandbox|<translate>Translation Sandbox</translate> ёсць у ісходным дакуменце, Вам трэба толькі перакласці Translation Sandbox і Вы не будзеце бачыць усю спасылку.

Знешнія спасылкі

Знешнія спасылкі проста перакладаць. Яны напісаны як у ісходнай мове.

  1. https://www.php.net/ будзе https://www.php.net/
  2. [https://www.php.net/ or PHP information] будзе or PHP information

Што перакладаць?

  1. Гэта – звычайнае УРМ (універсальнае рэсурснае месцазнаходжанне) і не патрабуе пераклада: https://www.php.net/ – гэта звычайная гіпер-спасылка і яе і трэба так пісаць. Пераклад не патрэбен.
  2. Гэтае [https://www.php.net/ for PHP information] будзе патрабаваць перакладу толькі для for PHP information.

Катэгорыі

Катэгорыям патрэбны асабісты мэтад!

Адна рэч, пра якую трэба памятаць пры працы па перакладу старонкі: любую катэгорыю (як спасылку на старонке) трэба перакладаць з даданнем у яе адпаведнага моўнага коду.


Пераклад катэгорыі – вельмі просты: дадайце /<Код мовы> у канец назвы катэгорыі.

Зрабіце так

Напрыклад, калі Вы перакладаеце з English на Spanish (код мовы – es) і старонка мае наступную катэгорыю: 

[[Category:Development]]

Вам трэба дадаць /es у канец назвы катэгорыі. 

[[Category:Developement/es]]

Старонкі катэгорый могуць быць таксама перакладзены (што павінна рабіцца хутка: большасць такіх старонак – пустыя, за выключэннем звестак пра катэгорыю, у якой знаходзіца дадзеная) і будуць часткай спецыяльнага праекта аб катэгорыях, калі ўсё будзе зроблена.

Каб падрыхтавацца да гэтага, мы можам дадаць /nl|Ontwikkeling (Dutch мова) у канец назвы катэгорыі. 

[[Category:Developement/nl|Ontwikkeling]]

Што не рабіць

А вось некальці рэчаў, якія лепш не рабіць!

Калі ласка: не рабіце так

Пераклад слова 'Category' альбо назвы катэгорыі наступным чынам: 

[[Category:Development]] to [[Categorie:Ontwikkeling]]

Ці так

Пераклад толькі назвы катэгорыі наступным чынам: 

[[Category:Development]] to [[Category:Ontwikkeling]]

Выявы

Чакаецца, што перакладзеныя старонкі будуць адлюстроўваць выявы, лакалізаваныя ў мову старонкі. Гэта добра, бо палягчае жыццё карыстальніку. Дакументацыя толькі запрашае перакладчыкаў суадносіць шаблён назваў выяў з ісходнай мовай старонкі.

Іменаванне выяў

Выкарыстуючы выявы, якая выкарыстоўвалася вышэй на гэтай старонке, што азначана як: 

[[File:JDOC-translator_interface-editing-view.png]]

Рабіце так

Захоўвайце імя выявы і проста дадайце код мовы ў канец: 

español будзе es [[File:JDOC-translator_interface-editing-view-es.png]]
italiano будзе it [[File:JDOC-translator_interface-editing-view-it.png]]
português будзе pt [[File:JDOC-translator_interface-editing-view-pt.png]]

Калі ж сам файл не лакалізаваны (напрыклад здымак экрана з інтэрфейсам) і зяўляецца выявай чагосьці універсальнага (напрыклад шар ці страла) – Вам не трэба перанайменваць выяву. Калі ж выява мае заглаўе, Вам можа спатрэбіцца пераклад заглаўя. 

[[File:ball.png|caption=This is a ball]]
будзе
[[File:ball.png|caption=<Перакладайце толькі гэта>]]

Пасля таго, як Вы скончыце пераклад, старонка з выявамі будзе лакалізаваная. Вам трэба будзе аглядзець старонку ў мове, на якую Вы яе пераклалі, і нажымаць "чырвоныя" файлавыя спасылкі. Гэта дазволіць Вам запампаваць лакалізаваную версію файла.

Часта выява ў дакуменце, які перакладаюць, ужо мае ID мовы, з якой трэба перакласць: [[File:JDOC-translator_interface-editing-view-<translate>en</translate>.png]]. Так што Вы перакладзеце en у Ваш лакальны ID мовы (у Dutch – nl). Калі выява не мае лакалізаваных частак, якія Вы жадаеце перакласці – Вы можаце перакласці en у en, каб пакінуць ісходную выяву.

Не рабіце наступнае

Калі Вы не ўставіце сваю лакальную выяву (бо няма) – лепш не перакладаць en ва сваю мову; інакш Вы атрымаеце "чырвоную" файлавую спасылку.

Часткі

Chunks are pieces of documentation which can be used at more than one place. There are big chunks, but most of them are small pieces of documentation, sometimes only one line. For example, it is used for the column headers in the helpscreens where the same fields are used in many help screens

===Usage of Chunks===

Using a chunk in a document is very easy. If we see: https://docs.joomla.org/Chunk30:Help_screen_Show_Title we can use it in a document with the following code: 

{{Chunk30:Help_screen_Show_Title/<translate>en</translate>}}

If we use this in a document we see the following:

{{Chunk30:Help_screen_Show_Title/

en

}}

So you will have to translate en into your local language ID (in Dutch nl). If, after translation, the chunk is not available in your language, you will see a red link. Use the link and open it in a new window. You will see a message that the document does not exist. What you must do now is:

Remove the language code in the URL, in Dutch /nl, Now you will see the chunk in English. Translate the chunk into your language (only the first line is enough) and the chunk is created in your language and visible in the source document.

There is a more sophisticated way of usage of chunks, with parameters. This way you can pass parameters to the chunk in your own language. We do this with the following code: 

{{Chunk30:Help_screen_toolbar_icon_Save/<translate>en</translate>|<translate>menu item</translate>}}

The source of this chunk is: 

*'''Save'''. Saves the {{{1|item}}} and stays in the current screen.

When we use this in a document the result will be:

{{Chunk30:Help_screen_toolbar_icon_Save/

en

|

menu item

}}

This way the translation of en will bring us in the language we want and the translation of menu item will used in the item.

Templates

Templates are reusable pieces of code which have a predictable result. 

<div lang="en" dir="ltr" class="mw-content-ltr">
{{tip|title=This is a tip|This is the body content of a tip!}}
</div>

Would look like this:

This is a tip

===Do This===

For the above example: 

<div lang="en" dir="ltr" class="mw-content-ltr">
{{tip|title=This is a tip|This is the body content of a tip!}}
</div>

You would have to do the following: 

<div lang="en" dir="ltr" class="mw-content-ltr">
{{tip|title=<translate the title>|<translate the body content>}}
</div>

Do Not Do This

Here is a list of don't do's.

  • Never translate the template's name. The template {{tip}} is called by the word 'tip' following the double set of curly brackets. If you translate the word tip, the translation would call a non-existent template name.
  • Never translate the variables used in a template, only the value assigned to the variable. In the example of the {{tip}} template, the word 'title' is the variable.


Retrieved from "https://docs.sandbox.joomla.org/index.php?title=JDOC:Page_Translation_Quickstart_Guide/be&oldid=939799"