Manual:cleanupTitles.php

MediaWiki version:
1.6


DetailsEdit

cleanupTitles.php is a maintenance script located in the maintenance directory that can be used to clean up broken, unparseable titles. The edits will be attributed to the user called Conversion script. This script is rather useful for cases in which someone has added a new interwiki prefix (e.g. commandos:) to the interwiki table and thereby caused mainspace pages with ambiguous titles (e.g. Commandos: Behind Enemy Lines) to become inaccessible. Likewise, the script can be used to process changes in $wgLegalTitleChars that rendered previously valid page titles inaccessible. Note that namespaceDupes.php is often a preferable option, if the goal is to move pages into their proper namespace.

Also note, this script does not support fixing encoding issues (e.g. Pages that are not UTF-8 NFC) at current time.

Options/ArgumentsEdit

Option Description Required?
--dry-run Perform a dry run Optional
--reporting-interval How often to print status line Optional

UsageEdit

php maintenance/cleanupTitles.php [ --dry-run| --reporting-interval ]


Checking for bad titles with dry-runEdit

Terminal
$ php maintenance/cleanupTitles.php --dry-run

Checking for bad titles...
Processing page...
page 1 (main_Page) doesn't match self.
DRY RUN: would rename 1 (0,'main_Page') to (0,'Broken/Main_Page')
page 2 (saraswati_Maa) doesn't match self.
DRY RUN: would rename 2 (0,'saraswati_Maa') to (0,'Broken/Saraswati_Maa')
page 4 (abc) doesn't match self.
DRY RUN: would rename 4 (0,'abc') to (0,'Broken/Abc')
Finished page... 3 of 11 rows updated

Checking and fixing bad titlesEdit

Terminal
$ php maintenance/cleanupTitles.php

Checking and fixing bad titles...
Processing page...
page 1 (main_Page) doesn't match self.
renaming 1 (0,'main_Page') to (0,'Broken/Main_Page')
page 2 (saraswati_Maa) doesn't match self.
renaming 2 (0,'saraswati_Maa') to (0,'Broken/Saraswati_Maa')
page 4 (abc) doesn't match self.
renaming 4 (0,'abc') to (0,'Broken/Abc')
Finished page... 3 of 11 rows updated

Fixed pages are moved to Broken/<foo> (where <foo> is the cleaned up version of the broken title)

See alsoEdit