Manual:uppercaseTitlesForUnicodeTransition.php
From Linux Web Expert
<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>">
<translate> ≥</translate> 1.34
| <translate> MediaWiki version:</translate> |
| MediaWiki file: uppercaseTitlesForUnicodeTransition.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.41.1 • 1.40.3 • 1.39.7 |
| 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 | <translate> Required</translate> | |
| --user | System user to use to do the renames. | <translate> Optional</translate> | User:Maintenance script |
| --steal | If the username specified by --user exists, specify this to force conversion to a system user. | <translate> Optional</translate> | |
| --run | If not specified, the script will not actually perform any moves (i.e. it will dry-run). | <translate> Optional</translate> | |
| --prefix | When the new title already exists, add this prefix. | <translate> Optional</translate> | |
| --suffix | When the new title already exists, add this suffix | <translate> Optional</translate> | |
| --reason | Reason to use when moving pages. | <translate> Optional</translate> | |
| --tag | Change tag to apply when moving pages. | <translate> Optional</translate> | |
| --tables | Comma-separated list of database tables to process. | <translate> Optional</translate> | |
| --userlist | Filename to which to output usernames needing rename. This file can then be used directly by renameInvalidUsernames.php maintenance script |
<translate> Optional</translate> |
Usage
php maintenance/uppercaseTitlesForUnicodeTransition.php --charmap charmapfile [ --user| --steal| --run| --prefix| --suffix| --reason| --tag| --tables| --userlist ]
First generate the upper character table through generateUpperCharTable.php
Terminal
$ php maintenance/language/generateUpperCharTable.php --outfile upperCaseMap.json
Now pass created file as --charmap in uppercaseTitlesForUnicodeTransition.php
Terminal
$ php maintenance/uppercaseTitlesForUnicodeTransition.php --charmap upperCaseMap.json
