Help:Extension:Translate/Page translation administration/nl

Wat. De functie voor paginavertaling zorgt voor een gecontroleerde vertaling van wiki-pagina's naar andere talen. De bedoeling is dat vertaalde inhoud per vertaalbericht gelijk is aan de betekenis van de Engelse inhoud. Dit is dus anders dan op bijvoorbeeld op een taalversie van een Wikipedia, die artikelen zijn geen vertalingen maar staan los van elkaar. De aanname is dat een pagina door de vertaler maar naar een taal wordt vertaald, maar dat het voor de vertaler nuttig kan zijn om te zien hoe een vertaalbericht voor een andere taal is vertaald.

Waarom. Zonder hulp is het vertalen van meer dan een paar pagina's erg arbeidsintensief voor een vertaler, in het slechtste geval wordt het een onleesbare woordenbrij. Met deze functie heeft u wat structuur in het vertaalproces. Het kernidee is dat door het op te splitsen in kleinere delen het gemakkelijker is om te vertalen, een vertaalbericht is maar een klein stukje tot een paar regels te vertalen tekst. De wijzigingen staan min of meer los van elkaar, de vertaler hoeft bij een wijziging alleen te kijken naar de gewijzigde en de nieuwe vertaalberichten. In principe zouden vertalers het werk onderling kunnen verdelen, of een artikel in het aantal sessies met een paar alinea's per sessie te doen.

Wie. Deze pagina is gericht op de vertaalhandleiding en dient om meer inzicht te geven in de werking van het systeem. De pagina is bedoeld voor vertaalbeheerders en iedereen die teksten maakt voor vertaalbare pagina's, ook als zij geen toegang hebben tot de administratieve functies voor het goedkeuren van wijzigingen die daarna dan vertaald kunnen worden.

U kunt de rechten van een vertaalbeheerder op MediaWiki.org aanvragen. Voor verzoeken op Meta, zie Meta:Requests. Voor Commons, Commons:Noticeboard.



Levensduur van een vertaalbare pagina
Rollen. Bij het schrijven en vertalen van een wiki-pagina zijn meerdere mensen betrokken: de schrijver die de pagina aanmaakt en vult, mensen die het bewerken en ook spelfouten verbeteren, een vertaalbeheerder die de pagina markeert voor vertaling, vertalers die vertalen, nog meer bewerkers, een vertaalbeheerder die die wijzigingen markeert voor vertaling en vertalers die het weer vertalen. Die rollen kunnen elkaar overlappen, iemand kan meerdere dingen doen. De uiteindelijke verantwoordelijkheid voor probleemloos vertalen ligt bij de vertaalbeheerder. Deze beslist wanneer de pagina voor het eerst vertaald kan worden, kijkt op de opdeling een doel dient en keurt de wijzigingen goed of past de Engelse tekst eventueel aan.

Voorbereiding. Om iets te kunnen vertalen moet het natuurlijk eerst geschreven zijn. Als u al vertaald heeft zonder de extensie Translate te gebruiken, lees dan de sectie over het verplaatsen van vertalingen. Het vertalen gaat sneller als de brontekst goed is. Voordat een pagina voor vertaling gemarkeerd wordt is het handig om het eerst door iemand te laten lezen, eventueel een taaldeskundige die de tekst duidelijker en beknopter kan maken. Het gebruiken van moeilijke woorden en het maken van onbegrijpelijke zinnen maken het voor vrijwilligers lastiger en onaantrekkelijk om de tekst te vertalen. Ook de opmaak kan een probleem voor de vertaler zijn, als vertaalbeheerder kan dit deels voorkomen worden, lees de sectie over het omgaan met de opmaak. Een wijziging in de brontekst zorgt natuurlijk voor wijzigingen van bestaande vertalingen, zorg ervoor dat een pagina/bijwerking pas vertaalbaar wordt gemaakt als de pagina voor de bewerker van de brontaal een stabiele vorm heeft. Er kan altijd een wijziging komen, dat handelt het systeem wel af, lees de sectie over het verwerken van wijzigingen.

Taggen. Als de tekst klaar is voor het laten vertalen, kan iedereen de vertaalbare delen markeren door ze tussen tags te zetten en de  werkbalk toe te voegen aan de pagina. Het laatste voegt een lijst van alle vertalingen van de pagina toe met actuele percentages hoeveel vertaald is. Er is geen andere indicatie dat er vertalingen bestaan. Het taggen. Het systeem zal zien wanneer er tags zijn geplaatst op een vertaalbare pagina, de pagina zal dan een link hebben om het te markeren voor vertaling. Het zal er ook voor zorgen dat er bij het opslaan wordt gecontroleerd op fouten zoals het vergeten van een tag om iets af te sluiten. De vertaalbare pagina zal op de lijst Special:PageTranslation staan als Voorgesteld voor vertaling.

Markeren. Na het taggen, markeert een vertaalbeheerder de pagina voor vertaling. De interface wordt uitgelegd met een voorbeeld van een pagina-vertaling. De verantwoordelijkheid van de vertaalbeheerder is het zeker zijn dat de segmentatie zinnig is en dat het taggen goed is gedaan. De pagina kan opnieuw gemarkeerd worden voor vertaling nadat er een wijziging is gedaan. Zie hieronder hoe u wijzigingen doet zodat de gevolgen minimaal zijn. Door het markeren van een pagina start er op de achtergrond een proces dat de MediaWiki's job queue gebruikt. Dat proces bekijkt elke vertaalpagina en maakt die opnieuw aan: wijzigingen in het sjabloon vertaalpagina worden meegenomen en verouderde vertalingen worden met een andere achtergrond weergegeven. De vertaalinterface wordt daarentegen wel direct bijgewerkt.

Wijzigingen. Gebruikers kunnen te allen tijde de bron van de vertaalbare pagina wijzigen. Deze wijziging is dan direct zichtbaar (soms wat later door de cache) voor de lezer in het Engels, maar de lezers in andere talen moeten wachten tot de vertaler het in die taal heeft vertaald. Dat kan die vertaler pas doen als de pagina voor vertaling is gemarkeerd na de laatste aanpassing van de Engelse versie. De aanduiding dat 100% vertaald is, betekent niet dat de vertaalde tekst vergelijkbaar is met de Engelse versie, mogelijk moet de Engelse pagina nog gemarkeerd worden voor vertaling, of dat zo is, dan is dat bovenin wel zichtbaar.

Niet opnieuw vertalen. Als de vertaalbare pagina is gewijzigd, dan kan de vertaalbeheerder bij het markeren voor vertaling per vertaalbericht opgeven of de gewijzigde tekst betekent dat de vertaling aangepast moet worden: "". Een taalfout herstellen heeft waarschijnlijk geen gevolgen voor de vertalingen. Als het opnieuw vertalen nodig is, dan worden deze vertaalde tekst met een roze achtergrond aangegeven. De vertalers zien in hun interface dan een klok staan bij het vertaalbericht. Al er geen aanpassing van de vertaling nodig is dan zien de lezers van die pagina's niets van die wijziging. De vertalers zien de wijziging pas als ze de tekst bekijken maar het wordt dan niet als 'moet vertaald worden' aangeboden.

Brontaal. Er is ook een vertaalpagina met de taalcode van de brontaal: het bevat geen extra tags of andere opmaak gerelateerd aan de paginavertaling die gebruikt wordt in de vertaalbare brontekst, maar het handig als u een pagina wilt transcluden (typisch voor vertaalbare sjablonen) of het wilt exporteren. Voorbeeld: de huidige weergegeven pagina is zonder opmaak beschikbaar op Help:Extension:Translate/Page translation administration/en.

De brontaal wijzigen. De extensie neemt standaard aan dat de vertaalbare pagina in de standaardtaal van de wiki is. Beheerders kunnen op pagina-niveau een taalinstelling aanpassen, met Special:PageLanguage, zodat een andere taal als brontaal van de vertaling gebruikt kan worden. Details

Taal vertaling. Vertaalde pagina's kunnen tekst in meerdere talen bevatten als de pagina niet volledig is vertaald. Op vertaalde pagina's krijgen onvertaalde vertaalberichten de met de overeenkomende taal en de tekstrichting zodat de CSS-regels goed worden toegepast. Op dit moment ondersteunt MediaWiki echter alleen het instellen op pagina-niveau van de taal. Alle magische woorden en parserfuncties gebruiken de taal van de vertaling ook al is de omringende tekst niet vertaald. Dit kan ongewilde effecten hebben bij bijvoorbeeld de weergave van getallen en datums. Bij enkele magische functies en parsertags kan de uitvoertaal gezet worden, in dat geval het magische woord  gebruikt worden, dat geeft terug de brontaal bij onvertaalde teksten en de vertaaltaal bij vertaalde teksten.

Gesloten vertaalverzoeken. Enkele vertaalbare pagina's zijn maar tijdelijk belangrijk in een bepaalde periode.Bijvoorbeeld aankondigingen en periodieke statuswijzigingen, zoals de Wikimedia maandelijkse highlights. U kunt deze pagina's houden met vertalingen maar in de vertaalinterface verbergen. Dat voorkomt het vertalen niet, maar de kans dat iemand het gaat vertalen wordt een heel stuk kleiner. Het ontmoedigen en het terugdraaien kan via Special:PageTranslation worden gedaan.

Prioriteit voor bepaalde talen aangeven.. U kunt ook een lijst met talen aangeven waarvan u graag vertalingen wilt zien, als u de lijst leeg lijst dan geeft u aan dat het u niet uitmaakt welke vertaling wordt aangemaakt. Voor een niet in de lijst genoemde taal is de pagina dan ontraden pagina bij het vertalen (zie vorige alinea), de vertaler ziet dan een melding. U kunt ook het vertalen naar bepaalde talen voorkomen, omdat bijvoorbeeld de vertaling elders gebruikt wordt waar minder talen beschikbaar zijn.

Groeperen. Het is mogelijk om pagina's die met elkaar gerelateerd zijn te groeperen. Deze groepen werken hetzelfde als de andere berichtgroepen. Deze hebben eigen statistieken en bevatten alle berichten van de subgroepen: in dit geval vertaalbare pagina's. Deze functionaliteit zit nu in Special:AggregateGroups. Deze geaggregeerde berichtgroepen zijn standaard samengevouwen in Special:LanguageStats in de groepsselectie Special:Translate.

Verplaatsen. U kunt vertaalbare pagina's net als andere pagina's verplaatsen. U kunt bij het verplaatsen aangeven of u ook niet vertaalbare subpagina's wilt verplaatsen. Dit gaat via een taak op de achtergrond omdat het veel gerelateerde pagina's kan bevatten. Tijdens het verplaatsen is het vertalen niet mogelijk. Afronding wordt gezien in de logpagina van de vertaling.

Verwijderen. Het verwijderen wordt net aqls het verplaatsen aangeroepen vanaf de normale plaats. U kunt of de hele vertaalbare pagina verwijderen of maar een vertaalbare pagina met de knop verwijderen. Dan worden ook de bijbehorende vertaaleenheden pagina's verwijderd. Net als bij het verplaatsen gebeurd dat in proces op de achtergrond, het resultaat van de verwidjering komt te staan in de log van de pagina. De rechten "delete" en "pagetranslation" zijn verplicht, maar een vertaaleenheid kan altijd worden verwijderd met alleen het recht "delete".

Terugdraaien. Ongewenste bewerkingen kunnen op de gebruikelijke manier worden teruggedraaid. U hoeft alleen het betreffende vertaalbericht te bewerken en de vertaalpagina wordt ook bijgewerkt. Om het vertaalbericht te vinden dat bewerkt moet worden, klik op de link "" voor de editor en kijk tegelijkertijd naar een bewerking.

Beveiligen. Een vertaalbare pagina kan beveiligd worden. De vertaalpagina's kunnen niet beveiligd worden, de beveiliging wordt dus niet doorgegeven door de vertaalbare pagina. Om verdere bewerkingen aan de vertalingen te voorkomen, kunt u de brontaal als enige taal met prioriteit zetten en de vertalingen uit te schakelen, dat prioriteren staat hierboven beschreven. Deze twee acties voorkomen samen het wijzigen van de brontaal en de vertaalde pagina's. Er kan ook een individuele vertaalbericht pagina worden beveiligd, maar dat raden wij niet aan.

Vertaalverzoek verwijderen. Het markeren van een pagina voor een vertaling kan ook ongedaan worden gemaakt. U kunt Special:PageTranslation gebruiken of de link bovenin de vertaalbare pagina om het uit de vertaling te verwijderen. Dit verwijderd elke structuur gerelateerd aan paginavertaling, maar laat alle bestaande pagina's staan, vrij om te bewerken. Deze actie wordt niet aanbevolen.

Transclusie op grond van de taal. Een vertaalbare pagina kan opgenomen worden in een andere pagina als sjabloon (transclude). In zulke gevallen wordt de vertaalbare pagina geladen in de taal van de doelpagina, alsof het in die taal is vertaald. Als de vertaling niet bestaat, dan wordt de brontaal gebruikt. Het gedrag van de vertaalbare pagina kan bestuurd worden met de optie Enable translation aware transclusion for this page bij het voor markeren van de pagina voor vertalen. Een nieuwe vertaalbare pagina heeft standaard deze optie.



Opbouw van een vertaalbare pagina
De vertaling van een vertaalbare pagina zal vele pagina's opleveren, die samen de vertaalbare pagina in de breedste zin van het woord vormen: hun titel wordt bepaald door de titel van de vertaalbare :


 * - de bronpagina
 * - de vertaalpagina's en een kopie van de bronpagina zonder opmaak
 * - alle vertaalberichten pagina's

Daarnaast worden het sjabloon van de vertaalpagina en de bronnen van de vertaalberichten opgehaald uit de bronpagina en opgeslagen in de database. Het systeem houdt bij welke versies van de bronpagina vertaaltags bevatten en welke versies ervan voor vertaling zijn gemarkeerd.

Elke keer als een vertaaleenheidpagina wordt bijgewerkt, zal het systeem ook de bijbehorende vertaalpagina genereren. Dit resulteert in twee bewerkingen. De bewerking van de vertaaleenheidpagina is standaard verborgen in recente wijzigingen en kan worden weergegeven door vertalingen weergeven te kiezen in het vertaalfilter. Elke andere actie dan het bewerken (zoals verwijderen en verplaatsen) van de pagina's van de vertaaleenheid zal niet leiden tot het opnieuw genereren van de bijbehorende vertaalpagina.

Als u de kopie van de bronpagina zonder opmaak nodig hebt, bijvoorbeeld om in een andere wiki zonder Vertalen te plakken,


 * identificeer de taalcode van de bron (voor Engels, en ) en ga naar
 * Klik op de knop "" om een adres zoals dit te bereiken en vervang  door   in de adresbalk, druk op enter
 * de tekst wordt getoond of opgeslagen.

Segmentatie
Algemene principesː


 * 1) Alle tekst die bedoeld is voor vertaling moet worden verpakt in  tags. Er kunnen meerdere paren tags op één pagina staan.
 * 2) Alles buiten deze tags verandert op geen enkele vertaalpagina. Deze statische tekst, samen met de tijdelijke aanduidingen die de plaats markeren waar de vertaling van elke vertaaleenheid zal worden vervangen, wordt het vertaalpaginasjabloon genoemd.
 * 3) Te veel opmaak in de tekst maakt het voor vertalers moeilijk om te vertalen. Gebruik meer -tags wanneer er veel markeringen zijn in een te vertalen tekst, knip de tekst dus op in meer delen.
 * 4) De tekst in  tags wordt gesplitst in vertaaleenheden waar een of meer lege regels tussen staan (twee of meer nieuwe regels).

Beperkingen. De vertaalfunctie stelt wat beperkingen aan de in te voeren tekst. Er mag geen opmaakregel zijn die over vertaaleenheden wordt verdeeld. In een vertaalbericht moet dus die opmaak begonnen en afgesloten worden. Dit wordt nu niet in de software afgedwongen, maar door het niet te doen kan de opbouw van de pagina verkeerd gebeuren, het hangt er dan vanaf of MediaWiki de geproduceerde HTML kan verbeteren of kan laten werken.

Verwerkvolgorde. De tags ̯ werken anders dan andere tags, zij gaan niet door de parser. Dit zal meestal geen problemen veroorzaken, maar wie weet heeft u wel een bijzondere invoer gemaakt. De tags worden eerder verwerkt dan en, behalve voor  dat wordt door de extensie Translate verwerkt.

Tag plaatsen. Probeer indien mogelijk de tags op hun eigen regels te plaatsen, zonder lege lijnen tussen de inhoud en de tags. Soms is dit niet mogelijk, bijvoorbeeld als u bepaalde inhoud wilt vertalen die wordt omringd door de opmaak, maar niet door de opmaak zelf. Dit is ook prima, bijvoorbeeld:

Om dit te laten werken, heeft de extensie een eenvoudige -afhandeling van de witruimte: witruimte blijft behouden, behalve als een opening of sluiting tag  het enige is op een regel. In dat geval wordt de newline na de openingstag of voor de afsluitende tag verwijderd. Dit betekent dat ze geen extra ruimte veroorzaken in de opgebouwde versie van de pagina.

Variabelen. Het is mogelijk om variabelen te gebruiken die vergelijkbaar zijn met sjabloonvariabelen. De syntaxis hiervoor is (aanhalingstekens zijn optioneel als de waarde geen spaties of een waarde van   bevat). Voor vertalers worden deze alleen weergegeven als, en in vertalingen worden pagina's automatisch vervangen door de waarde die is gedefinieerd in de vertaalbare pagina (dus het zijn globale "constanten" op alle vertaalpagina's). Variabelen kunnen worden gebruikt om onvertaalbare inhoud in het midden van een vertaaleenheid te verbergen. Het werkt ook voor zaken als nummers die vaak moeten worden bijgewerkt. U kunt het nummer in alle vertalingen bijwerken door het nummer in de vertaalbare paginabron te wijzigen en de pagina opnieuw te markeren. U hoeft vertalingen niet ongeldig te maken, omdat het nummer geen deel uitmaakt van een vertaaleenheid.

Door komma's gescheiden waarden. Voor inhoud zoals grafiekgegevens, die door de software moet worden verwerkt als door komma's gescheiden waarden, moet u de vertaaleenheden tussen elke komma scheiden, zodat de vertaaleditors geen gelokaliseerde komma's gebruiken die de software in de war brengen.

Platte tekstwaarden. Om elke vorm van wijziging van de vertaalwaarde te voorkomen, gebruikt u het kenmerk  als volgt:. Standaard worden verouderde en onvertaalde waarden aangepast om markering en taaltagging te ondersteunen.



Opmaak voorbeelden
Hieronder staan enkele alternatieven en voorgestelde manieren om verschillende soorten wiki-opmaak te verwerken.

{| class=wikitable
 * - style="visibility:collapse"
 * colspan="3" |
 * - id=categories
 * Categorieën
 * width=40% | Categorieën kunnen op twee manieren worden toegevoegd: met het sjabloon voor de vertaalpagina of in een van de vertaaleenheden.

Als u de categorieën in het sjabloon voor de vertaalpagina hebt, komen alle vertalingen in dezelfde categorie terecht.

Als u categorieën in vertaaleenheden hebt, moet u de gebruikers een naamgevingsschema geven.

Aan de rechterkant tonen we twee mogelijke schema's die onafhankelijk zijn van de technische middelen om ze toe te passen. Vertaling door toevoeging van het taalachtervoegsel: Category:Cars/nl (aanbevolen)


 * Categoriepaginanaam niet vertaald (net als de paginanamen)
 * Een categorie voor elke taal.
 * Paginavertaling zou kunnen worden gebruikt voor de categorie zelf: de categorieën zouden aan elkaar worden gekoppeld en de koppen zouden worden vertaald (maar niet de naam van de categorie in links en dergelijke).

Geen vertaling: Category:Cars


 * Alle vertalingen in dezelfde categorie (goed als er maar weinig talen zijn, slecht als er veel zijn).
 * Categorienaam niet vertaald (kan worden geplaatst zoals in het vertaalsjabloon).
 * Kopregels
 * Koppen kunnen in principe worden gekoppeld aan de volgende alinea, maar het is beter om ze te scheiden met een lege regel. Op deze manier kan iemand snel de inhoudsopgave vertalen voordat hij op de inhoud ingaat.
 * Koppen kunnen in principe worden gekoppeld aan de volgende alinea, maar het is beter om ze te scheiden met een lege regel. Op deze manier kan iemand snel de inhoudsopgave vertalen voordat hij op de inhoud ingaat.

Bij het taggen van koppen is het belangrijk om de kopopmaak in de tags op te nemen en een nieuwe regel in te voegen tussen de openingsvertaaltag en de kopopmaak, anders zal MediaWiki ze niet langer correct identificeren. Het bewerken van secties werkt bijvoorbeeld alleen met de aanbevolen opmaak in het voorbeeld. De opmaak geeft vertalers ook meteen een context: ze vertalen een kop. Bovendien zorgt het ervoor dat er koppelbare ankers worden gegenereerd voor de kop Verkeerdː (geen nieuwe regel na tag, kop buiten vertaal tags) {{#tag:syntaxhighlight|

translateCulture/translate

 * lang="html"}}

Verkeerdː (geen nieuwe regel)

Aanbevolen opdeling: {{#tag:syntaxhighlight| {{^(}}translate{{)^}}

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


 * Afbeeldingen
 * Afbeeldingen die taalspecifieke inhoud zoals tekst bevatten, moeten de volledige syntaxis in een eenheid bevatten. Andere afbeeldingen kunnen de beschrijving alleen taggen met optionele hint in de berichtdocumentatie van de pagina nadat deze is gemarkeerd.
 * Afbeeldingen die taalspecifieke inhoud zoals tekst bevatten, moeten de volledige syntaxis in een eenheid bevatten. Andere afbeeldingen kunnen de beschrijving alleen taggen met optionele hint in de berichtdocumentatie van de pagina nadat deze is gemarkeerd.


 * Links
 * Links kunnen worden opgenomen in de alinea waarin ze zich bevinden. Dit maakt het mogelijk om het linklabel te wijzigen, maar ook om het linkdoel te wijzigen in een gelokaliseerde versie als die bestaat.
 * Links kunnen worden opgenomen in de alinea waarin ze zich bevinden. Dit maakt het mogelijk om het linklabel te wijzigen, maar ook om het linkdoel te wijzigen in een gelokaliseerde versie als die bestaat.

Als de doelpagina ook vertaalbaar is (of zou moeten zijn), moet u ernaar linken door  naar de titel te verplaatsen. Alleen het linklabel hoeft te worden vertaald, omdat dit gebruikers automatisch doorverwijst naar de vertaalpagina in hun eigen interfacetaal, zoals bijvoorbeeld geselecteerd via de UniversalLanguageSelector. Om een constant gedrag te bereiken, moet de syntaxis echter voor alle links worden gebruikt.  Internal links: 

 Links to translatable pages: 

Externe links:

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). To split a list, use -tags for each item without including leading asterisks/hashes/semicolons. Do not insert blank lines as this will break the HTML output.
 * Lijsten
 * Lijsten kunnen lang worden, dan zou je deze in meerdere delen willen splitsen met een item per deel.
 * Lijsten kunnen lang worden, dan zou je deze in meerdere delen willen splitsen met een item per deel.

of


 * Getallen
 * Met getallen en andere niet taalkundige tekens kunt u het het huidige aantal uit de tekst halen en het een variabele maken. Dat heeft als voordelen:
 * Met getallen en andere niet taalkundige tekens kunt u het het huidige aantal uit de tekst halen en het een variabele maken. Dat heeft als voordelen:


 * U kunt het aantal wijzigen zonder dat dan de vertaling aangepast moet worden.
 * Het vertaalgeheugen werkt beter als iets dan variabel is niet van belang is.

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.


 *  Templates 
 * 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.
 *  Attributes 
 * 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:
 *  Translation language 
 * 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
 * }



Brontekst wijzigen
General principles:


 * Avoid changes
 * Make the changes as isolated as possible
 * Do not add translation unit markers yourself

Unit markers. When 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. 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.

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

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

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

Changing unit text. Changing is the most common operation for translation units. You can fix spelling mistakes, correct grammar or do other changes to the unit. When re-marking the page for translation, you will see the difference in the unit text. The same difference is also shown to translators when they update their translations. For simple spelling fixes and other cases where you don't want the existing translations to be highlighted on the translated pages, you can avoid invalidating them: translators will still see the difference if they ever update the translation for any reason.

Adding new text. You can freely add new text inside tags. Make sure that there is one empty line between adjacent units, so that the system will see it as a new unit. You can also add tags around the new text, if it is not inside existing  tags. Again, do not add unit markers yourself, the system will do it.

Deleting text. You can delete whole units. If you do so, also remove the unit marker.

Splitting units. You can split existing units by adding an empty line in the middle of a unit, or by placing tags so that they split the unit. You can either keep the unit marker with the first unit or remove it altogether. In the first case, translators see the old text when updating the old translation. If you removed the unit marker, both units will behave as if no translation ever existed, after the page is re-marked for translation.

Merging units. If you merge units, you have to remove at least all but one unit marker.

Moving units. You can move units around without invalidating translations: just move the unit marker together with the rest of the unit.

Before marking the new version of the page for translation, ensure that the best practices are followed, especially that translators get a new translation unit if the content has changed. Also make sure that there are no unnecessary changes to prevent wasting translators time. If the source page is getting many changes, it may be worthwhile to wait for it to stabilize, and push the work for translators only after that.

Unused unit translations are not deleted automatically, but that should not cause trouble.



Overzetten naar paginavertaling
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 (available to translation administrators only), 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.



Hoe te gebruiken
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.



Beschikbare acties
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).

Probleemoplossing

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