Manual:uppercaseTitlesForUnicodeTransition.php
From mediawiki.org
MediaWiki version:
≥ 1.34
| MediaWiki file: uppercaseTitlesForUnicodeTransition.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.43.1 • 1.42.6 • 1.39.12 |
| Classes: | UppercaseTitlesForUnicodeTransition |
Details
[edit ]uppercaseTitlesForUnicodeTransition.php is a maintenance script that renames titles when changing behavior of Language::ucfirst() . This script skips User and User_talk pages for registered users, as renaming of users is too complex to try to implement here. Use something like Extension:Renameuser to clean those up; this script can provide a list of user names affected.
Options/Arguments
[edit ]| Option | Description | Required? | Default |
|---|---|---|---|
| --charmap | Character map generated by maintenance/language/generateUcfirstOverrides.php | Required | |
| --user | System user to use to do the renames. | Optional | User:Maintenance script |
| --steal | If the username specified by --user exists, specify this to force conversion to a system user. | Optional | |
| --run | If not specified, the script will not actually perform any moves (i.e. it will dry-run). | Optional | |
| --prefix | When the new title already exists, add this prefix. | Optional | |
| --suffix | When the new title already exists, add this suffix | Optional | |
| --reason | Reason to use when moving pages. | Optional | |
| --tag | Change tag to apply when moving pages. | Optional | |
| --tables | Comma-separated list of database tables to process. | Optional | |
| --userlist | Filename to which to output usernames needing rename. This file can then be used directly by renameInvalidUsernames.php maintenance script |
Optional |
Usage
[edit ]phpmaintenance/run.phpuppercaseTitlesForUnicodeTransition--charmapcharmapfile[--user|--steal|--run|--prefix|--suffix|--reason|--tag|--tables|--userlist]
In MediaWiki version 1.39.12 and earlier, you must invoke maintenance scripts using
php maintenance/scriptName.php instead of php maintenance/run.php scriptName.First generate the upper character table through generateUpperCharTable.php:
Terminal
$ php maintenance/run.php language/generateUpperCharTable --outfile upperCaseMap.json
Now pass created file as --charmap in uppercaseTitlesForUnicodeTransition.php:
Terminal
$ php maintenance/run.php uppercaseTitlesForUnicodeTransition --charmap upperCaseMap.json