Manual:UpdateCollation.php
| MediaWiki version: | ≥ 1.19 |
| MediaWiki file: updateCollation.php | |
|---|---|
| Location: | maintenance/ |
| Source code: | master • 1.42.3 • 1.41.4 • 1.39.10 |
| Classes: | UpdateCollation |
Details
Dette skriptet oppdaterer sorteringsrekkefølgen i kategorier.
Du må kjøre dette skriptet etter at $wgCategoryCollation har blitt endret.
Det må også kjøres etter at man oppgraderer fra MediaWiki til versjon 1.17 eller nyere fra en versjon som er eldre enn 1.17.
Vanligvis kjøres det som del av update.php.
Hvis sorteringsrekkefølgen i kategorier på wikien din ikke fungerer som den skal (altså at sider ikke sorteres riktig i kategoriene) kan du bruke --force for å fikse sorteringsrekkefølgen overalt.
Kjøretiden til skriptet avhenger av antallet rader i categorylinks, og for ekstremt store wikier kan det ta mer enn 24 timer å kjøre skriptet.
(En kjøring på engelskspråklig Wikipedia i september 2016 tok rundt ei uke: phab:T136150.) Skriptet kan prosessere rundt 10 000 rader i minuttet (avhengig av ditt oppsett); du kan se et estimat av antall rader på wikien din før du kjører skriptet på ekte ved å bruke updateCollation.php --dry-run.
Wikimedia-wikier av diverse størrelser har byttet sorteringsrekkefølge flere ganger (phab:T47443); bare sørg for å sjekke omtrent hvor lang tid det vil ta å kjøre skriptet før du starter det.
Options/Arguments
| Option | Description | Required? |
|---|---|---|
| --force | Run on all rows, even if the collation is supposed to be up-to-date. | Optional |
| --previous-collation | Set the previous value of $wgCategoryCollation here to speed up this script, especially if your categorylinks table is large. This will only update rows with that collation, though, so it may miss out-of-date rows with a different, even older collation. | Optional |
| --target-collation | Set this to the new collation type to use instead of $wgCategoryCollation. Usually you should not use this, you should just update $wgCategoryCollation in LocalSettings.php. | Optional |
| --target-table | Copy rows from categorylinks into the specified table instead of updating them in place. | Optional |
| --remote | Use Shellbox to calculate the new sort keys remotely. | Optional |
| --dry-run | Don't actually change the collations, just compile statistics. | Optional |
| --verbose-stats | Show more statistics. | Optional |
Usage
php maintenance/updateCollation.php [ --force| --previous-collation| --target-collation| --target-table| --remote| --dry-run| --verbose-stats ]
Dry run to check updates
$ php maintenance/updateCollation.php --dry-run Selecting next 100 rows... processing...0 rows would be updated so far. Selecting next 100 rows... processing...0 rows would be updated so far.
Updating category collations
$ php maintenance/updateCollation.php Selecting next 100 rows... processing...100 done. Selecting next 100 rows... processing...143 done. 143 rows processed