Manual:$wgIllegalFileChars/de-formal

From Linux Web Expert

Revision as of 21:30, 4 August 2023 by imported>FuzzyBot (Updating to match new version of source page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

<translate> Files and file uploads</translate>: $wgIllegalFileChars
Override the default list of illegal characters in file names.
<translate> Introduced in version:</translate>1.16.0 (r55802)
<translate> Deprecated in version:</translate>1.41.0 (Gerrit change 942710; git #1552f420)
<translate> Removed in version:</translate><translate> still in use</translate>
<translate> Allowed values:</translate>(string of characters)
<translate> Default value:</translate>':\\/\\\\' (1.39+)

":\\/\\\\" (1.28-1.38)

":" (1.16-1.27)

Details

File:OOjs UI icon notice-destructive.svg <translate> Warning:</translate> Don't change this unless you know what you're doing!

This is a regex character class (i.e. a list of characters in a format suitable for a regular expression) that you want MediaWiki to convert to dashes ("-") despite being in the list of allowable title characters.

By default, file names can use the same characters as titles (see $wgLegalTitleChars ), except for those characters listed in this variable, the default being the colon, slash and backslash. All invalid characters in file names, including those listed in this variable, will automatically be converted to dashes ("-").

The default will not allow namespaces to be part of file names (example: File:Project:filename.txt). While this is generally desirable, it interferes with any extension that uses namespace indexing or protection. To keep the colon from being converted to a dash, remove the colon from the value of this variable.

References