Help:Lint errors/bogus-image-options
The bogus-image-options error is when an image is detected to use an invalid option. For example in the code [[File:Example.jpg|foo|bar|baz]]
, "foo
" and "bar
" are invalid 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.
Some of the known bugs in the Linter bogus file options detection are mentioned in, but not limited to:
- Parent task: task T274382 - Make File syntax processing match the specification and documentation
Some other supported file types 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]]
- 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
,thumb
, or###px
(any unlabeled pixel size) within<gallery>...</gallery>
tags. To fix, remove###px
,left
,right
,thumb
. Set pixel dimensions for the gallery using instructions at Help:Images . - Use of a
px
value withframe
(remove the px value to fix the error). - Use of
pxpx
in a size value (remove the extra "px" to fix the error).
Tools
editThe 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.