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