Manual:UppercaseTitlesForUnicodeTransition.php
| 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
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
| 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
php maintenance/run.php uppercaseTitlesForUnicodeTransition --charmap charmapfile [ --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
See also
- Manual:Language.php
- Extension:Renameuser
- Manual:renameInvalidUsernames.php
- Manual:generateUpperCharTable.php