View source for Help:Extension:Translate/Move translatable page

<languages/>
{{Extension-Translate}}
{{Info|1=<translate><!--T:1--> Recommended prior reading:</translate> {{ll|Help:Moving_a_page}} }}

<translate><!--T:2--> When moving a source page that has been translated to other languages using the Translate extension, along with the source page the translation pages also have to be moved.</translate>
<translate><!--T:3--> Translation pages exist as subpages of the source page.</translate>
<translate><!--T:4--> For example, if we have a source page with the name <tvar name=1>''FooBar''</tvar>, and the page has been translated to French, and Spanish, then the translation pages will exist at <tvar name=2>''FooBar/fr''</tvar> and <tvar name=3>''FooBar/es''</tvar></translate>

<translate><!--T:5--> The process to move a translated source page is the same as a normal page.</translate>
<translate><!--T:6--> The difference is in the way the subpages are moved.</translate>

[[File:Translate-move-page-with-leave-redirect.jpg|thumb|]]

<translate><!--T:7--> In the image, we are moving a translatable source page.</translate>
<translate><!--T:8--> There are a few sections to note here,</translate>

# '''<translate><!--T:9--> Translation page</translate>''' - <translate><!--T:10--> These are the languages to which the source page has been translated to.</translate> <translate><!--T:11--> This will be moved.</translate>
# '''<translate><!--T:12--> Translation unit pages</translate>''' - <translate><!--T:13--> These are the smallest individually tracked component of translatable pages: the page is divided into paragraph-sized translation units and each unit is a message.</translate> <translate><!--T:14--> All of these will also be moved.</translate>
# '''<translate><!--T:15--> Subpage marked for translation</translate>''' - <translate><!--T:16--> These are other translatable source pages that exist as subpages under the source page that is being moved.</translate> <translate><!--T:17--> These cannot be moved as part of the current move operation but has to be moved separately.</translate>
# '''<translate><!--T:18--> Other subpage</translate>''' - <translate><!--T:19--> These are normal subpages under the source translatable page that is being moved.</translate> <translate><!--T:20--> The user can choose to move this by selecting the ''Move all subpages'' option on the screen.</translate>

<translate><!--T:39--> '''Talk pages''' if present are also moved.</translate> 
<translate><!--T:40--> Pages that have talk pages are denoted with a ''(Has talk page)'' suffix.</translate>
<translate><!--T:41--> Similar to subpages marked for translation, translatable talk pages have to be moved separately.</translate>

<translate><!--T:21--> Once the user initiates the move process, the actual moving will be done via background jobs.</translate>
<translate><!--T:22--> The status of the "move job" can be tracked via the Page translation log.</translate>

<translate><!--T:42--> '''Leaving a redirect:''' we provide a checkbox option that adds redirects for everything except translation unit pages and translation pages (translatable page, talk pages, regular subpages and their talk pages) once a page is moved.</translate>

{{info|1=<translate><!--T:24--> From the user interface, by default, a maximum of 500 pages can be moved. This can be changed by modifying the config <tvar name=1>{{phpi|$wgTranslatePageMoveLimit}}</tvar>.</translate> <translate><!--T:36--> We recommend using the <tvar name=1><code>moveTranslatableBundle.php</code></tvar> to move a large number of pages.</translate>}}

<translate>
==  Moving a large number of pages == <!--T:25-->

<!--T:26-->
To move a large number of pages, we recommend using the script <tvar name=1><code>moveTranslatableBundle.php</code></tvar> as it can be slightly unreliable to do so via the UI that uses the <code>JobQueue</code> to move the pages.

<!--T:27-->
While moving the page, the script will perform the necessary validations, display what will be moved, and then take confirmation from the user before performing the move.

<!--T:28-->
The script takes the following parameters:
</translate>

{| class="wikitable"
| <code>current-page</code> || {{required}} || <translate><!--T:29--> Current page name</translate>
|-
| <code>new-page</code> || {{required}} || <translate><!--T:30--> New page name</translate>
|-
| <code>user</code> || {{required}} || <translate><!--T:31--> User performing the move</translate>
|-
| <code>reason</code> || {{optional}} || <translate><!--T:32--> Reason for performing the move</translate>
|-
| <code>skip-subpages</code> || {{optional}} || <translate><!--T:33--> Skip moving subpages under the current page</translate>
|-
| <code>skip-talkpages</code> || {{optional}} || <translate><!--T:37--> Skip moving talkpages under the current page</translate>
|-
| <code>skip-redirect</code> || {{optional}} || <translate><!--T:43--> Skip leaving a redirect behind for translatable bundle, subpages and related talk pages</translate>
|}

<translate><!--T:34--> Example usage:</translate> 
<pre>
# Here "Main Page 60" is being renamed to "Main Page 70" by "Admin"
php extensions/Translate/scripts/moveTranslatableBundle.php "Main Page 60" "Main Page 70" Admin --reason "Just an example" --skip-redirect
</pre>

<translate>
== References == <!--T:38-->
</translate>
<references />