Help:Extension:Translate/Page translation administration/fi

Mitä. Sivujen kääntämis -toiminto mahdollistaa wiki-sivujen kääntämisen muille kielille kontrolloidusti. Tämä tarkoittaa sitä, että jokaisen käännöksen sisältö vastaa yleensä alkuperäisen sivun sisältöä. Tämä eroaa esimerkiksi Wikipedia-artikkelien eri kieliversioista, jotka ovat täysin itsenäisiä. Sivuja käännetään oletuksena vain yhdeltä pääkieleltä muille kielille, mutta kääntäjät voivat hyödyntää myös muiden kielien käännöksiä, jos niitä on olemassa.

Miksi. Useampien sivujen kääntäminen muille kielille ilman minkäänlaista apua on parhaimmillaan ajanhukkaa ja pahimmillaan hallitsematon sekasotku. Sivujen kääntämis -toiminnolla voidaan säästyä sotkulta ja tehdä kääntämisprosessista järjestelmällistä. Pääideana on se, että alkuperäinen teksti jaetaan pienemmiksi yksiköiksi, jotka sitten käännetään yksitellen. Kun alkuperäinen teksti jaetaan yksiköiksi, voidaan kaikki muutokset yksilöidä, ja kääntäjien tarvitsee päivittää käännökset vain niissä yksiköissä, joiden alkuperäistä tekstiä on muutettu. Tämä mahdollistaa myös sen, että kääntäjät voivat työstää pienemmän kokoisia yksiköitä, jolloin he voivat joko jakaa käännöstyön useamman kääntäjän kesken tai jatkaa itse käännöksen tekoa myöhemmin, koska käännöstä ei tarvitse tehdä heti kokonaan.

Kuka. Tämä sivu täsmentää sivujen kääntämisohjeita ja antaa syvällisempää tietoa siitä, miten järjestelmä toimii, sekä antaa ehdotuksia erilaisten tapausten käsittelemiseksi. Tämä sivu on tarkoitettu käännösylläpitäjille ja ylipäätään kaikille käännettävien sivujen lähdekoodia muokkaaville, vaikka heillä ei olisi käytettävissään ylläpitotoimintoja, joilla muutokset voidaan hyväksyä käännettäviksi.

Jos haluat pyytää itsellesi käännösylläpitäjän oikeuksia MediaWiki.org-projektissa, katso Project:Requests. Oikeuksia MetaWikissä voi pyytää sivulla Meta:Requests. Commonsissa sivu on Commons:Noticeboard.

Roolit. Wiki-sivun tekemisessä ja kääntämisessä on useita henkilöitä: sivun alkuperäinen kirjoittaja, kielenhuoltaja, käännösylläpitäjä, joka merkitsee sivun käännettäväksi, kääntäjät, joku joka tekee sivuun muutoksia, ja lopulta käännösylläpitäjä merkitsee muutokset käännettäväksi ja kääntäjät päivittävät käännökset. Roolit voivat olla lomittaisia, mutta lopullinen vastuu kääntämisen pitämisestä mutkattomana on käännösylläpitäjällä. Ylläpitäjä päättää, milloin sivu on valmis käännettäväksi ensimmäisen kerran, varmistaa osioiden tarkoituksenmukaisuuden ja hyväksyy (tai korjaa) muutokset.

Valmistelu. Jotta jotain voidaan kääntää, se pitää ensin kirjoittaa. Jos olet jo tehnyt käännöksen käyttämättä Käännös-laajennusta, katso alta osio käännösten migraatiosta. Jos haluat nopeasti useita käännöksiä, on erityisen tärkeää, että alkuperäinen teksti on kunnossa. Kysy jotakuta lukemaan sivun teksti läpi, ennen kuin merkitset sen käännettäväksi, ja jos mahdollista, pyydä kielen asiantuntijaa muokkaamaan teksti selväksi ja ytimekkääksi. Monimutkainen sanasto ja vaikeasti ymmärrettävät virkkeet tyssäävät monen vapaaehtoisen aikeet kääntämisestä. Myös merkinnät voivat aiheuttaa kääntäjille ongelmia, mutta käännösylläpitäjänä voit estää ongelmien syntymisen. Katso alempana osio merkinnöistä. Luonnollisesti sivun alkuperäiseen tekstiin tehdyt muutokst edellyttävät kaikkien olemassa olevien käännösten päivittämistä, joten on suositeltavaa odottaa, kunnes sivun sisältö on vakiintunut. Toisaalta muutoksia aina välillä tapahtuu ja järjestelmä käsittelee ne hyvin, joten katso alempana osio muutosten käsittelystä.

Taggaus. Kun sivu on muuten valmis käännettäväksi, kuka tahansa voi merkitä käännettävät osat laittamalla ne ‎<translate>-tagien sisälle ja lisäämällä sivulle ‎<languages />-palkin. Jälkimmäinen lisää sivulle listan kaikista käännöksistä sekä niiden valmistumis- ja päivitysprosentit. Se on ainoa osoitus siitä, että käännökset ovat olemassa. Katso alempana miten taggaus tehdään. Järjestelmä havaitsee tagien lisäämisen käännettävälle sivulle, ja sivulle tulee linkki, jonka kautta se voidaan merkitä käännettäväksi. Se myös antaa varoituksen ja estää tallennuksen, jos olet esimerkiksi unohtanut lisätä sulkevan tagin. Käännettävä sivu listataan myös sivulla Special:PageTranslation kommentilla valmis merkittäväksi.

Merkkaaminen. Taggauksen jälkeen käännösylläpitäjä merkitsee sivun käännettäväksi. Käyttöliittymä on selitetty esimerkkisivulla. Käännösylläpitäjän vastuulla on varmistaa, että osiot on tehty järkevästi ja taggaus on asianmukainen. Jos sivua on muutettu, se voidaan merkata uudelleen. Katso alempana miten tehdä muutoksia aiheuttamatta isoa häiriötä. Sivun merkkaaminen aloittaa taustaprosessin, joka käyttää MediaWikin työjonoa. Tämä prosessi käy läpi jokaisen käännöksen ja regeneroi ne: vanhentuneet käännökset korostetaan vaaleanpunaisella taustalla. Sen sijaan käännöskäyttöliittymä päivitetään heti.

Muutokset. Käyttäjät voivat jatkaa muutosten tekemistä alkuperäisen sivun lähdekoodiin. Muutokset näkyvät niille käyttäjille, jotka katsovat sivun lähdekoodia, mutta käännökset tehdään käännösyksiköille, jotka ovat peräisin alkuperäisen sivun viimeisimmästä versiosta, joka on merkitty käännettäväksi: käännösten näytetään olevan 100 %:sti valmiita ja päivitettyjä, vaikka alkuperäistä sivua olisi muutettu. Voit helposti nähdä, onko alkuperäisen sivun lähdekoodissa muutoksia: sivun ylälaidassa on ilmoitus siitä, että voit kääntää tämän sivun ja lisäksi siinä on linkit mahdollisiin muutoksiin.

Mitätöinti. Jos alkuperäisen sivun koodiin on tehty muutoksia, käännösylläpitäjä voi kunkin osion kohdalla valita vaihtoehdon "⧼tpt-action-nofuzzy⧽". Jos osio on merkitty vanhentuneeksi eli mitätöity, niin kyseinen osio näkyy käännetyllä sivulla vaaleanpunaisella taustalla, ja käännöskäyttöliittymässä näkyy kelloikoni. Jos osiota ei ole merkitty vanhentuneeksi, niin lukijat eivät näe mitään muutosta käännetyllä sivulla, ja kääntäjien täytyy katsoa käännöskäyttöliittymästä, mitä muutoksia kyseiseen osioon on tehty.

Lähdekieli. Myös alkuperäisen sivun kielellä on olemassa käännössivu: sillä ei ole ylimääräisiä tageja tai muita kääntämiseen liittyviä merkintöjä, jotka ovat näkyvissä alkuperäisen sivun lähdekoodissa. Tätä sivua ei ole linkitetty käyttöliittymästä, mutta se on kätevä silloin, jos haluat esimerkiksi sisällyttää (transclude) sivun (tyypillistä käännettäville mallineille) tai viedä (export) sivun. Esimerkiksi tämä sivu on saatavilla ilman merkintöjä täällä: Help:Extension:Translate/Page translation administration/en.

Käännettävän sivun kieli. Laajennus olettaa, että alkuperäinen sivu on kyseisen wikin oletuskielellä. Ylläpitäjät voivat muuttaa tietyn sivun kieliasetuksia käyttämällä sivua Special:PageLanguage, niin että sitä voidaan käyttää käännöksen alkuperäissivuna. Katso lisätietoja sivulta Page content language. Administrators can change a specific page's language setting, using the Special:PageLanguage page, so that it can be used as a source page for translation. See Page content language for details.

Käännöksen kieli. Käännettävällä sivulla voi olla tekstiä toisella kielellä, jos sivua ei ole kokonaan käännetty. Kääntämättömiin käännösyksiköihin merkitään asianmukainen kieli ja tekstin suunta, jotta CSS-säännöt toimivat oikein. MediaWiki ei kuitenkaan mahdollista kielen jäsentämistä (parsing) muuten kuin sivun tasolla. Kaikki taikasanat ja jäsennystoiminnot käyttävät käännöksen kohdekieltä, vaikka niitä ympäröivää tekstiä ei olisi käännetty. Tämä saattaa aiheuttaa ei-toivottuja poikkeamia esimerkiksi lukujen ja päivämäärien kanssa. Jotkin taikasanatoiminnot ja jäsennystagit mahdollistavat tulostekielen valinnan, eli silloin voit käyttää taikasanaa {{TRANSLATIONLANGUAGE}}, joka palauttaa kääntämättömille yksiköille alkuperäiskielisen ja käännetyille yksiköille käännöskielisen tulosteen.

Closed translation requests. Some translatable pages have a content that is only interesting for a certain period of time. For example announcements and regular status updates, like the Wikimedia monthly highlights. You can keep those pages around with translations, but hide them from the translation interface. This does not prevent further translations to the pages, but it greatly reduces the chance that a user accidentally starts translating the page. Discouraging and its reversion are done from Special:PageTranslation.

Prioritizing languages. You can also define a list of languages that you specifically want translations into; leaving the language list empty is interpreted as all languages allowed. The page will behave like a discouraged page (see previous paragraph) for the languages not in the priority list and, when translating into them, translators will be given a notice. You can also prevent the translation in other languages, say if translations are actually used elsewhere and you won't be able to use them but in some languages.

Grouping. It is possible to group related pages together. These groups work like all the other message groups. They have their own statistics and contain all the messages of the subgroups: in this case translatable pages. This functionality is currently in Special:AggregateGroups. Aggregate message groups are collapsed by default in Special:LanguageStats in the group selector at Special:Translate.

Siirtäminen. Käännettäviä sivuja voidaan siirtää samalla tavalla kuin muitakin sivuja. Sivua siirtäessäsi voit valita, haluatko siirtää myös sen alasivuja, jotka eivät ole käännöksiä. Useiden liittyvien sivujen siirto tehdään käyttämällä tausta-ajoa. Siirron aikana sivua ei ole mahdollista kääntää. Siirron päättyminen merkitään käännöslokiin.

Poistaminen. Kuten siirtäminen, voidaan sivun poistaminen tehdä normaalista paikasta. Voit poistaa joko käännettävän sivun kokonaan tai vain yhden käännössivun siinä olevasta poistonapista. Poistaminen poistaa myös kaikki käännösyksikkösivut. Samoin kuin siirrossa, tausta-ajo poistaa sivut ajan kanssa, ja poiston loppuunsuoritus merkitään sivun k��ännöslokiin. Poistaminen edellyttää sekä "delete" että "pagetranslation"-oikeuksia, mutta yksittäiset käännösyksikkösivut voidaan poistaa tavallisella "delete"-oikeudella.

Reverting. Similarly, reverting incorrect edits works as usual (including the rollback button): you only have to edit the affected translation unit and the translation page will be updated as well. To find the edit to the translation unit from the edit to the translation page, just click the "muokkaukset" link for the editor and look for an edit at a similar time. Within the translation system, you can mark an existing translation as outdated by adding !!FUZZY!! at the start of the translation unit's translated message box.

Suojaaminen. Käännettävä alkuperäinen sivu on mahdollista suojata. Käännöksiä ei voi suojata, eikä alkuperäisen sivun suojaaminen kata niitä. Jos haluat estää käännössivujen muokkaamisen, sinun tulee valita lähdekieli ainoaksi prioriteettikieleksi ja asettaa muiden kielten kääntäminen pois päältä. Katso kielten priorisointi ylempänä. Nämä kaksi toimintoa estävät muutosten tekemisen alkuperäiseen sivuun, sekä käännössivuun ja sen käännösyksikkösivuihin. Yksittäisten käännösyksikkösivujen suojaaminen on mahdollista, mutta sitä ei suositella.

Removal from translation. It is also possible to unmark a page for translation. You can use Special:PageTranslation or follow the link in the top of translatable page to remove it from translation. This will remove any structure related to page translation, but leave all the existing pages in place, freely editable. This action is not recommended.

Language aware transclusion. Käännettävä sivu on mahdollista sisällyttää toiseen sivuun mallineen tavoin. Silloin käännettävä sivu ladataan kohdesivun kielellä, jos se on käännetty kyseiselle kielelle. Jos käännöstä ei ole, käännettävä sivu ladataan alkuperäisellä kielellä. This behavior of a translatable page is controlled by the Enable translation aware transclusion for this page option when marking the page for translation. New translatable pages will have this behavior turned on by default.

• Page - the source page
• Page/<language code> - the translation pages, plus a copy of the source page without markup
• Translations:Page/<translation unit identifier>/<language code> - all the translation unit pages

• the text will be displayed or saved.

Restrictions. The page translation feature places some restrictions on the text. There should not be any markup that spans over two or more translation units. In other words, each paragraph should be self-contained. This is currently not enforced in the software, but violating it will cause invalid rendering of the page, the severity depending on whether MediaWiki itself is able to fix the resulting HTML output or not.

Parsing order. Beware, the ‎<translate> tags work differently from other tags, because they do not go through the parser. This should not cause problems usually, but may if you are trying something fancy. In more detail, they are parsed before any other tags like ‎<pre> or ‎<source>, except for ‎<nowiki> which is recognized by the Translate extension.

Tag placing. If possible, try to put the tags on their own lines, with no empty lines between the content and the tags. Sometimes this is not possible, for example if you want to translate some content surrounded by the markup, but not the markup itself. This is fine too, for example:

{{Template|1=<translate>Some localised parameter</translate>}}

To make this work, the extension has a simple whitespace handling: whitespace is preserved, except if an opening or closing ‎<translate>‎</translate> tag is the only thing on a line. In that case the newline after the opening tag or before the closing tag is eaten. This means that they don't cause extra space in the rendered version of the page.

 Note: You must leave the space between the content and the unit marker (that space is automatically added by the software). Otherwise, the editor will display an error message: "Translation unit markers in unexpected position," and you will not be able to publish. For example:

It is possible to use variables similar to template variables. The syntax for this is ‎<tvar name="name">contents‎</tvar> (quotes are optional if the value contains no spaces or any of " ' ` = < >).  Note: variables must be named, if not it may cause invalid rendering of the page. For translators variables will show up only as $name, and in translation pages will be substituted with the content of the tvar named name. Hence they are global "constants" across all its translation pages). It also works for things like numbers that need to be updated often. You can update the number in all translations by changing the value of the variable in the translatable page source and re-marking the page to apply universally across all language versions. You do not need to invalidate translations, because the number is not part of the translation unit pages.

Note that variables are not shared between different translation units. If you want to use the same variable in more than one unit, you must repeat the code in each unit. You can use the same name. Translation variables can be used to separate and hide non-translatable elements or content, such as link targets and file names, from the translation process or the middle of the translation unit. For example, this can be used to show a link that’s label should be translated, but not the actual URL:

[[Special:MyLanguage/Help:Extension:Translate|Translation extension]]

Comma-separated values. For content such as Graph data, that needs to be parsed by the software as comma-separated values, you should separate the translation units between each comma, so that the translating editors don't use localized commas which will confuse the software.

Plain-text values. To prevent any kind of modification of the translation value, use nowrap attribute like this: <translate nowrap>...</translate>. By default outdated and untranslated values are modified in order to support highlighting and language tagging.

‎<nowiki> handling: Before Translate version 2020.10, ‎<nowiki> was not handled consistently and pages would still appear in Special:PageTranslation. Escapes like "<translate>...</translate>" were used as a workaround.

Previous syntax:

Before Translate version 2021.04, the syntax was <tvar|name>contents</> (T274881).

[...]
</translate>

[[Category:MediaWiki{{#translation:}}]]

== <translate>Kulttuuri</translate> ==

<translate>== Culture ==</translate>

<translate>
== Culture == 

Lorem ipsum dolor.
</translate>

<translate>
[[File:Europe countries map en.png|thumb|Map of Europe with country names]]
</translate>

[[File:Ball.png|50px|<translate>Ball icon</translate>]]

<translate>
Helsinki is capital of [[Finland (country)|Finland]].
</translate>

<translate>
It has marvelous beaches with a lot of [[Special:MyLanguage/Seagull|seagulls]].
</translate>

<translate>
PHP ([http://php.net website]) is a programming language.
</translate>

* <translate>General principles</translate>
* <translate>Headings</translate>
* <translate>Images</translate>
* <translate>Tables</translate>

<translate>
Please visit:
* our main page
* then the FAQ page.
</translate>

<translate>
Income this month <tvar name=income>{{FORMATNUM:3567800}}</tvar> EUR
</translate>

<abbr title="<translate nowrap>Frequently asked questions</translate>"><translate>FAQ</translate></abbr>

2020-09-15 is {{#time:l|2020-09-15|fi}}

{{#if:{{TRANSLATABLEPAGE}}|{{Some template}}|{{Some template/{{int:lang}}}}}}

Unit markers. When a page is marked for translation, the system will update the translatable page source and add unique identifiers, called "unit markers", for each translation unit. See example below. An example of a unit marker is <!--T:1-->. These unit markers are crucial for the system, which uses them to track changes to each translation unit. You should never add unit markers yourself. The unit markers are always on the line before the unit; or, if it starts with a heading, after the first heading on the same line. The different placement for headings is needed to keep section editing working as expected.

<translate>
== Birds == <!--T:1-->
Birds are animals which....

<!--T:2-->
Birds can fly and...
</translate>

<!--T:1-->
Cat purrs. Dog barks.

<!--T:1-->
Cat purrs.

<!--T:2--> (Added after remarking)
Dog barks.

<!--T:2--> (Added after remarking)
Cat purrs.

<!--T:3--> (Added after remarking)
Dog barks.

1. Go to Special:PageMigration
2. Enter the title of the page and the language code. For example, "Help:Special pages" & "fr"
3. The source text which was divided into units by Translate and the imported translations will be shown besides each other with some initial alignment.
4. Use the actions available for each unit to manually do the remaining alignment
5. As translated units are editable, do required manual improvements (for add translation variables, fix links and markup, etc.)
6. Click on the "Tallenna" button. This will create pages under the Translations namespace of the form Translations:Page/<translation unit identifier>/<language code>. The old translations have been imported into Translate.
7. Else, if you wish to abort the importing, click on the 'Cancel' button.

1. Add: Clicking on this action icon adds a new empty unit below the current one. Use this feature if you want to split the current unit and need a unit below.
2. Swap: Clicking on this action icon swaps the content of the current unit with the unit below it. You can use this feature when the units get aligned improperly due to different ordering of sections. Or when you need to drag a unit below or above. In either case, remember it swaps with the unit below and does not create any additional units.
3. Delete: Clicking on this action icon completely removes the corresponding target unit from the page and shifts the remaining target units up by one unit. Use this to remove unwanted content like code or imported translations which are present completely in the source language. Note: this irrevocable action (in the current session).

1. If you mark a page for translation and immediately go to the special page and try to import translations, you may get an error message like "Sivulla <page-name>/<language-name> ei ole vanhoja käännöksiä.". This is because FuzzyBot didn't fuzzy the messages on the old page yet: the tool won't find an edit by FuzzyBot on the translation page. In this case, simply wait for FuzzyBot to do its job. Once an edit is seen, you can proceed with the imports.
2. Please wait for some time after pressing the "Tallenna" button. While the button background remains gray, there is an ongoing process of importing non-empty units. Once the button becomes colored again, the import is completed.
3. Within the translation system, you can mark an existing translation as outdated by adding !!FUZZY!! at the start of the translation unit's translated message box.

1. Migration will be easier if you first (before the mark to translation) check whether existing translations are similar to the original English text, and manually edit the structure of pages: break paragraphs and lists, add the missing headings (even if empty).
2. Will be useful to check the result in the core translation interface - some of the units may be immediately marked as obsolete because of errors markup or if not all of the translation variables was added.
3. Translation of the page title will have to be added manually. If you do not know very well the language of the imported page, you can try to find the translation of the page title among the "links here" or sometimes in redirects.