Help:Extension:Translate/Page translation administration/sv

Vad. Sidöversättningsfunktionen tillåter kontrollerad översättning av wikisidor till andra språk. Det betyder att innehållet i varje översättning normalt sett är lika med källsidan. Detta står i motsats till till exempel den olika språkversionen av artiklar i olika Wikipedia-upplagor, som är helt oberoende av varandra. Det antas att sidor översätts från ett primärt språk till andra språk, men översättare kan även utnyttja översättningar på andra språk om de finns.

Varför. Utan hjälp blir översättningen av mer än ett par sidor till andra språk i bästa fall ett slöseri med tid, i värsta fall en ohållbar oreda. Med sidoversättningsfunktionen kan du undvika oreda och få struktur till översättningsförfarandet. Kärnidén är att källtexten är segmenterad i mindre enheter, vilka var och en kommer att översättas individuellt. När källtexten segmenteras i enheter kan alla ändringar isoleras och översättare behöver bara uppdatera översättningarna av enheter som har ändringar i källtexten. Detta gör det också möjligt för översättare att arbeta på enheter av hanterbar storlek och dela arbetet mellan flera översättare eller fortsätta översättningen i senare sessioner, eftersom de inte behöver göra allt på en gång.

Vem. Den här sidan utarbetas på sidvisningsövning genom att ge djupare insikt om hur systemet fungerar och föreslår bästa praxis för en mängd olika fall. Den här sidan är avsedd för sidöversättningsadministratörer och i allmänhet för alla som redigerar källtexten på översättbara sidor, även om de inte har tillgång till administrativa funktioner för godkännande av ändringar för översättning.

För att ansöka om utökade rättigheter som översättningsadministratör, gå till Project:Requests.

En översättbar sidas levnad
Roller. Flera personer är involverade i att skriva och översätta en wikisida: den ursprungliga författaren skapar en sida, någon rättar stavfel, en sidoversättningsadministratör markerar sidan för översättning, översättare översätter, någon gör ändringar till sidan, en sidöversättningsadministratör markerar dessa ändringar för översättningar och översättare uppdaterar översättningar. Dessa roller kan överlappa mer eller mindre, men det yttersta ansvaret för en problemfri översättning lämnas till sidöversättningsadministratören. Administratören bestämmer när sidan först är klar för översättning, säkerställer att segmenteringen tjänar ett syfte och godkänner (eller korrigerar) ändringar.

Förberedelse. För att ha något översatt måste du först skriva det. Om du redan har gjort översättning utan översättningstillägget, se nedan avsnitt om migrering av översättningar. Om du vill ha många översättningar snabbt, är det avgörande att källtexten är i god form. Innan du markerar en sida för översättning, be någon att korrekturläsa och om möjligt fråga en språkspecialist för att göra texten tydligare och mer koncis. Besvärlig vokabulär och svårförståeliga meningar är en showstoppare för många frivilliga översättningar. Markup kan också orsaka problem för översättare, men som översättningsadministratör kan du undvika dessa problem, se avsnittet avsnitt om hanteringsmarkering nedan. Naturligtvis kräver ändringar du gör i källtexten uppdateringar av alla befintliga översättningar, så det är bättre att vänta tills innehållet på sidan har stabiliserats. Å andra sidan sker förändringar, och systemet hanterar sådana bra, så kolla in avsnittet om ändringshantering nedan.

Taggning. När texten är redo för översättning kan någon markera de översättbara delarna genom att bifoga dem i -taggar och lägga till -fältet på sidan. Den senare lägger till en lista över alla översättningar av sidan, med deras slutförda och aktuella procentandelar. Det finns ingen annan indikation på att översättningar finns. Se nedan hur man taggar. Systemet kommer att upptäcka när taggarna placeras på den översättbara sidan, och sidan kommer att ha en länk för att markera den för översättning. Den kommer också att klaga och förhindra att du sparar om du till exempel glömde att lägga till en stängningstagg. Den översättbara sidan kommer också att anges på Special:PageTranslation som "klar för markering".

Markering. Efter taggningen markerar en översättningsadministratör sidan för översättning. Gränssnittet förklaras i sidöversättningsexempel. Översättningsadministratörens ansvar är att se till att segmenteringen är vettig och att märkningen är korrekt. Sidan kan markeras igen om den har ändrats under tiden. Se nedan hur man gör ändringar med minimal störning. Markeringen av sidan startar en bakgrundsprocess som använder MediaWikis jobbkö. Denna process går över varje översättningssida och regenererar den: ändringar i översättningssidans mall kommer att återspeglas och föråldrade översättningar kommer att ersättas tillfälligt med den ursprungliga källtexten. Däremot uppdateras översättningsgränssnittet omedelbart.

Ändringar. Användare kan fortsätta göra ändringar i den översättbara sidkällan. Ändringarna kommer att vara synliga för användare som tittar på sidan i källspråket, men översättningar görs mot översättningsenheterna som extraheras från den senaste versionen av den översättbara sidan som har markerats för översättning: översättningssidorna rapporteras vara 100% upp till datum om alla översättningsenheter har översatts, även om källsidan har nya ändringar. Du kan enkelt se om det finns omarkerade ändringar när du tittar på den översättbara sidan i källspråk: det finns ett meddelande i toppen som säger att du kan översätta den här sidan och även länkar till ändringar om det finns några.

Återställning. Om ändringar görs på den översättbara sidkällan får översättningsadministratören möjligheten "" för varje avsnitt. Om ett avsnitt är återställt, kommer de översatta språken att få en rosa bakgrundsfärg för de här sektionerna, och en klockikon kommer att visas för översättare i översättningsgränssnittet. Om en sektion inte återställs kommer inga ändringar vara synliga för läsare av de översatta sidorna, och översättare måste granska sektionen i översättningsgränssnittet för att se ändringarna.

Källspråk. Det finns också en översättningssida med språkkoden för källspråket: den innehåller inte extra taggar och annan markering relaterad till sidöversättning som används i den översättbara sidkällan. Den här sidan är inte länkad från gränssnittet, men den är användbar exempelvis när du vill inkludera sidan (vanligtvis för översättbara mallar) eller exportera den. Till exempel är denna sida tillgänglig utan markering på Help:Extension:Translate/Page translation administration/en.

Ändra källspråk. Tillgget förutsätter normalt att den översättbara källsidan finns på wikins standardspråk. Administratörer kan ändra språkinställningen för en viss sida med hjälp av sidan Special:PageLanguage, så att den kan användas som en källsida för översättning. Se sidinnehållsspråk för detaljer.

Översättningsspråk. Översättningssidor kan innehålla text på andra språk om de inte är helt översatta. På översättningssidor, kommer översättningsenheter taggas med korrekt språk och textriktning så att CSS-regler tillämpas på rätt sätt. MediaWiki tillåter tyvärr inte för tillfället att sätta parseringspsråk på något annat än sidspråket. Alla magiska ord och parserfunktioneer använder översättningsspråket, även om texten runtomkring inte är översatt. Detta kan skapa oönskade blandningar som till exempel när siffror skrivs ut, eller datum. Vissa magiska funktioner och parsertaggar tillåter att man definierar utmatningsspråket, då kan man använda det magiska ordet  som antingen returnerar källspråket för oöversatta enheter eller målspråket för översatta enheter.

Avslutade översättningsförfrågningar. Vissa översättbara sidor har ett innehåll som bara är intressant under en viss tid. Till exempel meddelanden och regelbundna statusuppdateringar, som Wikimedia månadshöjdpunkter. Du kan hålla sidorna med översättningar, men gömma dem från översättningsgränssnittet. Detta förhindrar inte ytterligare översättningar till sidorna, men det minskar risken för att en användare av misstag börjar översätta sidan. Avskräckande och dess omvändning görs från Special:PageTranslation.

Prioritering av språk. Du kan också definiera en lista över språk som du specifikt vill ha översättningar till; lämnas språklistan tom tolkas det som att alla språk är tillåtna. Sidan kommer att fungera som en avskräckaned sida (se föregående stycke) för de språk som inte finns i prioritetslistan och översättare får ett meddelande när de översätts till dem. Du kan också förhindra översättningen på andra språk, till exempel om översättningar faktiskt används någon annanstans och du inte kommer att kunna använda dem förutom på vissa språk.

Gruppering. Det är möjligt att gruppera relaterade sidor tillsammans. Dessa grupper fungerar som alla andra meddelandegrupper. De har sin egen statistik och innehåller alla meddelanden i undergrupperna: i detta fall översättbara sidor. Denna funktionalitet finns för närvarande i Special:AggregateGroups. Aggregerade meddelandegrupper döljs som standard i Special:LanguageStats i Special:Translate gruppväljare.

Flytta. Du kan flytta översättbara sidor på samma sätt som andra sidor. När du flyttar kan du välja om du vill flytta alla sidor som inte ingår i översättningen. Flytten använder ett jobb i bakgrunden för att flytta alla de relaterade sidorna. Medan flytten pågår är det inte möjligt att översätta sidan. Slutförandet noteras i sidans översättningslogg.

Radering. Liksom flytt nås radering från det normala stället. Du kan radera antingen hela översättbara sidan, eller bara en översättningssida, via raderings-knappen på den. Radering raderar också alla sidor med relaterade översättningsenheter. Som i flyttning kommer en bakgrundsprocess att radera sidorna över tiden och slutförandet noteras i sidans översättningslogg. Radering kräver tillåtelse för "radering" och "sidöversättning", men enskilda översättningsenhetssidor kan alltid raderas med standard "delete".

Gör ogjord. På samma sätt fungerar återställning av felaktiga redigeringar som vanligt (inklusive tillbakarullningsknappen): du behöver bara redigera den berörda översättningsenheten och översättningssidan uppdateras också. För att hitta redigeringen till översättningsenheten från redigeringen till översättningssidan, klicka bara på länken "" för redigeraren och leta efter en ändring vid en liknande tidpunkt.

Skydda. Det är möjligt att skydda den översättbara sidan. Översättningssidor kan inte skyddas, och skyddet för den översättbara sidan omfattar inte heller dem. För att förhindra ytterligare ändringar i översättningar, bör du lägga till källspråk som enda prioriterat språk och inaktivera översättningar till andra språk, se prioritering av språk ovan. Tillsammans förhindrar dessa två åtgärder effektivt ändringar på både källsidan och översättningssidorna med dess översättningsenhetssidor. Det är möjligt att skydda enskilda översättningsenhetssidor, men det är inte tillrådligt.

Borttagning från översättning. Det är också möjligt att avmarkera en sida för översättning. Du kan använda Special:PageTranslation eller följa länken längst upp på översättbar sida för att ta bort den från översättning. Det här tar bort alla strukturer som är relaterade till sidöversättning, men lämnar alla befintliga sidor på plats, fritt redigerbara. Denna åtgärd rekommenderas inte.

Språkmedveten inkludering. Det går att inkludera en översättbar sida på en annan sida som en mall. Då kommer den översättbara sidan laddas in på källsidans språk om sidan har översätts till det språket. Om det inte finns en sådan översättning kommer den översättbara sidan laddas in på källspråket. Detta beteende hos en översättbar sida styrs av alternativet Aktivera översättningsmedveten inkludering för denna sida när man markerar sidan för översättning. Nya översättbara sidor kommer ha det beteendet aktiverat som standard.

Uppbyggnad av en översättbar sida
Översättningen av en översättbar sida kommer att producera många sidor, som alla är komponenter av den översättbara sidan i vidaste bemärkelse: deras titel bestäms av titeln på den översättbara :


 * (källsidan)
 * (översättningssidorna, plus en kopia av källsidan utan markup)
 * (alla översättningsenhetssidor)

Utöver detta finns översättningssidans mall och källorna till översättningsenheter, extraherade från källsidan och lagrade i databasen. Systemet håller reda på vilka versioner av källsidan som innehåller översättningstaggar och vilken version av dem som har markerats för översättning.

Varje gång en översättningsenhetssida uppdateras, kommer systemet också att regenerera motsvarande översättningssida. Detta resulterar i två ändringar. Översättningsenhetssidan är dold som standard i de senaste ändringarna och kan visas genom att välja "Visa översättningar" från översättningsfiltret. Inga andra åtgärder än att redigera (som att ta bort och flytta) översättningsenhetssidorna leder till att regenereringen av motsvarande översättningssida utlöses.

Om du behöver kopian av källsidan utan markering, t.ex. att klistras in i en annan wiki utan Translate,


 * Ange källkodsspråkskoden (för engelska, en ) och besök ;
 * Klicka på ""-knappen för att nå en adress som denna och ersätt  med   i adressfältet, tryck på enter:
 * texten kommer att visas eller sparas.

Segmentering
Övergripande principer:


 * 1) All text som är avsedd för översättning måste omslutas med  -taggar. Det kan finnas flera par taggar på samma sida.
 * 2) Allt utanför dessa taggar ändras inte på någon översättningssida. Denna statiska text, tillsammans med platshållare som markerar den plats där översättningen av varje översättningsenhet kommer att ersättas, kallas översättningssidans mall.
 * 3) För mycket markering i texten gör det svårt för översättare att översätta. Använd mer finkornad placering av -taggar när det finns mycket markup.
 * 4) Texten innanför -taggar delas upp i översättningsenheter när det finns en eller flera tomma rader mellan dem (två eller flera nya rader).

Begränsningar. Sidöversättningsfunktionen lägger en del restriktioner på texten. Det får inte finnas någon markup som spänner över två eller flera översättningsenheter. Med andra ord bör varje stycke vara fristående. Detta verkställs för närvarande inte i programvaran, men överträdelse av det kommer att orsaka ogiltig återgivning av sidan, hur mycket beror på om MediaWiki själv kan fixa den resulterande HTML-utmatningen eller ej.

Parsing order. Beware, the 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 or, with the exception of  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:

To make this work, the extension has a simple whitespace handling: whitespace is preserved, except if an opening or closing  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.

Variables. It is possible to use variables similar to template variables. The syntax for this is. For translators these will show up only as, and in translation pages will automatically be replaced by the value defined in the translatable page (so they are global "constants" across all its translation pages). Variables can be used to hide untranslatable content in the middle of a translation unit. It also works for things like numbers that need to be updated often. You can update the number in all translations by changing the number in the translatable page source and re-marking the page. You do not need to invalidate translations, because the number is not part of the translation unit pages.

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  attribute like this: ....  By default outdated and untranslated values are modified in order to support highlighting and language tagging.

Markeringsexempel
Nedan listas några alternativ och föreslagna sätt att hantera olika sorters wikimarkering.

{| class=wikitable Översättning genom att lägga till språksuffix: Category:Cars/fi (rekommenderas)
 * Kategorier
 * width=40% | Kategorier kan läggas till på två sätt: i översättningssidans mall eller i en av översättningsenheterna. Finns det kategorier i översättningssidans mall kommer alla översättningar också ha samma kategori. Finns det flera kategorier i översättningsenheterna borde du lära dina användare ett namngivningsmönster. Till höger visar vi två olika mönster som är oberoende av de tekniska lösningarna för att tillsätta dem.


 * Kategorisidans namn översätts inte (precis som sidnamn).
 * En kategori för varje språk.
 * Kan kan också översätta själva kategorin: kategorierna skulle länkas samman och rubrikerna skulle översättas (men inte namnet på själva kategorin i länkar och så vidare).

Ingen översättning: Category:Cars

Fel: {{#tag:syntaxhighlight|
 * Alla översättningar i samma kategori (bra om det bara är några få språk, dåligt om det är många).
 * Kategorinamnet översätts inte (kan läggas i översättningsmallen).
 * Rubriker
 * Rubriker kan i princip knytas till följande paragraf, men det är bättre om de separeras med en tom rad. På så sätt kan någon snabbt översätta innehållsförteckningen utan att behöva gå till innehållet. När man taggar rubriker är det viktigt att inkludera rubriksmarkeringen inuti taggarna och lägga in en ny rad mellan den första translate-taggen och rubriksmarkeringen, annars kommer MediaWiki inte identifiera dem korrekt. Till exempel, avsnittsredigering fungerar bara med den rekommenderade markeingen som ges i exemplet. Markeringen gör också så att översättarna omedelbart förstår att det är just en rubrik de översätter, och inte innehåll.
 * Rubriker kan i princip knytas till följande paragraf, men det är bättre om de separeras med en tom rad. På så sätt kan någon snabbt översätta innehållsförteckningen utan att behöva gå till innehållet. När man taggar rubriker är det viktigt att inkludera rubriksmarkeringen inuti taggarna och lägga in en ny rad mellan den första translate-taggen och rubriksmarkeringen, annars kommer MediaWiki inte identifiera dem korrekt. Till exempel, avsnittsredigering fungerar bara med den rekommenderade markeingen som ges i exemplet. Markeringen gör också så att översättarna omedelbart förstår att det är just en rubrik de översätter, och inte innehåll.

translateKultur/translate

 * lang="html"}}

Fel:

Rekommenderad segmentering: {{#tag:syntaxhighlight| {{^(}}translate{{)^}}

Kultur
Lorem ipsum dolor. /translate
 * lang="html"}}


 * Bilder
 * Bilder som innehåller språkspecifikt innehåll, som text, borde inkludera hela bildsyntaxen i en enhet. Andra bilder borde bara tagga beskrivningen med valfri hint i sidans meddelandebeskrivning efter att den markerats.
 * Bilder som innehåller språkspecifikt innehåll, som text, borde inkludera hela bildsyntaxen i en enhet. Andra bilder borde bara tagga beskrivningen med valfri hint i sidans meddelandebeskrivning efter att den markerats.


 * Länkar
 * Links can be included in the paragraph they are inside. This allows changing the link label, but also changing the link target to a localized version if one exists.
 * Links can be included in the paragraph they are inside. This allows changing the link label, but also changing the link target to a localized version if one exists.

If the target page is (or should be) also translatable, you should link to it by prepending  to its title. Only the link label will need to be translated, because this automatically redirects users to the translation page in their own interface language, as selected for instance via the UniversalLanguageSelector. However, to achieve a constant behavior the syntax must be used for all links.

Because headers are translated, you cannot rely on the automatically generated id's for headers. You can add your own anchors. To have them outside of the translation template you need to break up the page into multiple tag pairs around each header you want to have an anchor to. Interna länkar:

Länkar till översättbara sidor:

Externa länkar:

Länkar inom en sida: {{#tag:syntaxhighlight| span id=culture{{^(}}/span{{)^}} {{^(}}translate{{)^}}

Kultur
Lorem ipsum dolor.

...

För mer om mat, läs avsnittet om kultur. /translate
 * lang="html"}}

Do so only if the items are sufficiently independent to be translated separately in all languages: don't create "lego messages". For instance, you must avoid to split a single sentence in multiple units, or to separate logically dependent parts which may affect each other (with regard to punctuation or style of the list, for instance). För att stycka upp en lista, använd -taggar för varje punkt utan asterisker, brädgårdar, semikolon. Do not insert blank lines as this will break the HTML output.
 * Listor
 * Listor kan bli långa, så ni skulle kunna dela upp dem i delar med en punkt i varje enhet.
 * Listor kan bli långa, så ni skulle kunna dela upp dem i delar med en punkt i varje enhet.

or

With numbers and other non-linguistic elements you may want to pull the actual number out of translation and make it a variable. This has multiple benefits:
 * Nummer
 * Nummer


 * You can update the number without invalidating translations.
 * Translation memory can work better when the changing number is ignored.

Note that this prevents the translators from localising the number by doing currency conversion. The  call makes sure the number is formatted correctly in the target language.


 * Mallar
 * Templates have varying functions and purposes, so the best solution depends on what the template is for. If the template is not a part of longer paragraph, it should be left out, unless it has parameters that need to be translated. If the template has no linguistic content itself, you don't need to do anything for the template itself.
 * For an example of templates translated with page translation, see . To use this template, you need to have another template similar to Translatable navigation template, because you cannot include the template by  anymore. This is not yet provided by the Translate extension itself, but that is in the plans.
 * For an example of templates translated with page translation, see . To use this template, you need to have another template similar to Translatable navigation template, because you cannot include the template by  anymore. This is not yet provided by the Translate extension itself, but that is in the plans.

Another way is to use the unstructured element translation to translate the template, but then the language of the template will follow the user's interface language, not the language of the page they are viewing.

In some circumstances the additional markup added by this wrapping is not suitable.
 * Attribut
 * By default the Translate extension may wrap outdated translation units to highlight them and untranslated units to set proper language metadata.
 * By default the Translate extension may wrap outdated translation units to highlight them and untranslated units to set proper language metadata.

can be used to avoid that. 2020-09-15 is The above input may render as:
 * Översättningsspråk
 * When text is using language-dependent formatting methods, a mismatch may appear for untranslated sections.
 * When text is using language-dependent formatting methods, a mismatch may appear for untranslated sections.
 * : 2020-09-15 is Tuesday.
 * : 2020-09-15 on tiistai.

Without the magic word, untranslated text on a Finnish translation page would render as:
 * 2020-09-15 is tiistai
 * }

Ändra källtexten
Allmänna principer:


 * Undvik ändringar
 * Gör ändringarna så isolerade som möjligt
 * Lägg inte till översättningsenheter själv

Enhetsmarkörer. När en sida markeras för översättning, kommer systemet uppdatera den översättbara sidans källa och lägga till unika identifierare för varje översättningsenhet. Se exemplet nedan. Dessa markörer är avgörande för systemet, och används för att spåra ändringar till varje översättningsenhet. Du bör aldrig lägga till enhetsmarkörer själv. Markörer ligger alltid på raden innan enheten; eller, om den börjar med en rubrik, efter den första rubriken på samma rad. Markörernas olika placeringar behövs för att se till att avsnittsredigering fungerar som det ska.

{{#tag:syntaxhighlight| {{^(}}translate>

Birds
!--T:1--> Birds are animals which....

!--T:2--> Birds can fly and... /translate>
 * lang=html}}

Ändra enhetstext. Det vanligast man gör med en översättningsenhet är att ändra den. Du kan fixa stavfel, rätta grammatik eller ändra enheten på annat sätt. När man återmarkerar enheten för översättning, kommer du få se skillnaden i enhetens text. Samma skillnad visas också för översättare när de uppdaterar sina översättningar. För till exempel stavfel och andra tillfällen där man inte vill att den befintliga översättningarna ska uppmärksammas på de översatta sidorna, kan du låta bli att ogiltigförklara dem: översättare kommer fortfarande se skillnaden om de av någon anledning skulle uppdatera översättningen.

Lägga till ny text. Du kan närsomhelst lägga till ny text i -taggar. Se till att det finns en tom rad mellan intilliggande enheter, så att systemet kommer se det som en ny enhet. Du kan också lägga till -taggar runt den nya texten om det inte redan ligger i befintliga -taggar. Än en gång, lägg inte till översättningsmarkörer själv, systemet gör det åt dig.

Radera text. Du kan radera hela enheter. Om du gör så, radera också enhetsmarkören.

Sära på enheter. Du kan sära på befintliga enheter genom att lägga till en tom rad mitt i en enhet, eller genom att lägga -taggar mellan enheterna. Du kan antingen behålla enhetsmarkören i den första enheten eller radera den helt och hållet. I det förstanämnda alternativet kommer översättare se den gamla texten när de uppdaterar den gamla översättningen. Raderar man däremot enhetsmarkören kommer båda enheterna bete sig som de aldrig funnits när sidan åter markeras för översättning.

Slå ihop enheter. Om man slår ihop enheter behöver man ta bort alla enhetsmarkörer förutom en.

Flytta enheter. Man kan flytta runt enheter utan att ogiltigförklara översättningar: flytta bara enhetsmarkören tillsammans med resten av enheten.

Vid markeringen av den nya versionen av sidan för översättning, se till att bästa praxis efterlevs, speciellt så att översättare får en ny översättningsenhet om innehållet ändras. Se också till att att det inte finns några onödiga ändringar för att inte slösa översättarnas tid. Om källsidan kommer omarbetas mycket, kan det vara lönt att vänta på stabilisera sidan och första efter det tillgängliggöra översättning.

Oanvända enhetsöversättningar raderas inte automatiskt men det borde inte orsaka några problem.

Migrera till sidöversättning
If you have been translating pages before using the page translation system, you might want to migrate the pages to the new system, at least the ones you expect to have new translations and want statistics for. You will probably have existing templates for language switching and maybe different page naming conventions.

You can start migration by cleaning up, tagging and marking the source page. You can keep the existing language-switching templates while you migrate the old translations. If your pages follow the language code subpages naming convention, they will be replaced with the source text after marking the source page for translation, but you'll still be able to access translations from history.

This manual task has been partly automated by Special:PageMigration, which shows the source and target units besides each other and allows the user to adjust the units by providing a set of features mentioned later in this page.

How to use?
500px| Screenshot showing an example use of Special:PageMigration for "Help:Special pages" as page name and "fr" as language code.
 * 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 "" button. This will create pages under the Translations namespace of the form  . The old translations have been imported into Translate.
 * 7) Else, if you wish to abort the importing, click on the 'Cancel' button.

Actions available
Each row consisting of source and target unit has a set of action icons. They are used as follows:
 * 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).

Troubleshooting

 * 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 "". 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 "" 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.

Tips

 * 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 headers (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. Note: Please don't translate the namespace, keep it untranslated.