Help:Lint errors/bogus-image-options
The bogus-image-options error is when an image is detected to use a non-existent option. For example in the code [[File:Example.jpg|foo|bar|baz]]
, "foo
" and "bar
" are bogus options, and "baz
" shows up as the caption.
Help:Images has details on the supported image options, including a few notes about the quirky behavior of some of the parameters.
Known bugs in the Linter bogus file options detection include, but are not limited to:
- Parent task: task T274382 - Make File syntax processing match the specification and documentation
- task T216003 - Linter fails to detect a quotation mark after the "upright" number.
- task T264464 - Conflicting border/thumb/frame options are not detected as Linter errors
- task T216566 - Capitalized versions of valid File options are usually ignored, but are not flagged as Linter bogus file options
- task T179605 - LintError bogus-image-options triggers on "Thumbtime"
- task T276675 - Image caption ending in "px" is incorrectly detected as a Linter error (To work around a false positive error when "px" is at the end of a caption, add {{sp}} after "px". It will add a space, which does not change the displayed caption but which makes the error go away.)
In addition some other supported file options such as video and multi-page formats (e.g. pdf) are also checked.
Common errors include:
- Repeated options, e.g.
[[File:Example.jpg|thumb|right|thumb]]
→[[File:Example.jpg|thumb|right]]
- Conflicting alignment options, e.g.
[[File:Example.jpg|thumb|right|150px|left]]
→[[File:Example.jpg|thumb|right|150px]]
- Conflicting border/frame/thumb options (not reported as a Linter error; see phab link above), e.g.
[[File:Example.jpg|border|thumb|right|150px]]
→[[File:Example.jpg|thumb|right|150px]]
(always remove the "border" option) - A manual line break in
|alt=
or in the caption. (Remove the line break to fix the error.) - Blank options, e.g.
[[File:Example.jpg|thumb||right]]
→[[File:Example.jpg|thumb|right]]
- Two captions, e.g.
[[File:Example.jpg|thumb|right|Intended alt text|Caption text]]
→[[File:Example.jpg|thumb|right|alt=Intended alt text|Caption text]]
- A plain number instead of a px value, e.g.
[[File:Example.jpg|thumb|right|225|Caption text]]
→[[File:Example.jpg|thumb|right|225px|Caption text]]
- Typos in options, e.g.
[[File:Example.jpg|thumb|fight|Caption text]]
→[[File:Example.jpg|thumb|right|Caption text]]
- Use of
left
,right
or###px
(any unlabeled pixel size) within<gallery>...</gallery>
tags. To fix, removeleft
orright
. Set pixel dimensions using instructions at Help:Images .
Tools[edit]
The following tools can help fix bogus image options:
- WPCleaner: see instructions on how to use WPCleaner for fixing errors detected by Linter. Bogus image options may be reported by WPCleaner as part of CheckWiki error #534.