Manual:CleanupTitles.php
| MediaWiki version: | ≥ 1.6 |
| MediaWiki file: cleanupTitles.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.42.3 • 1.41.4 • 1.39.10 |
| Classes: | TitleCleanup |
Details
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/Arguments
| Option | Description | Required? |
|---|---|---|
| --dry-run | Perform a dry run | Optional |
| --reporting-interval | How often to print status line | Optional |
Usage
php maintenance/cleanupTitles.php [ --dry-run| --reporting-interval ]
Checking for bad titles with dry-run
$ 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 titles
$ 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)