Template:Xambox/doc

Usage
This template creates an explicit ambox; that is, an article message box that always actually presents its message to the user, even in mobile view. Use it when the reader should see the actual message. (Wikipedia, for which ambox is apparently maintained, is primarily concerned with delivering content regardless of quality, while explaining what needs improvement as a follow-up concern; though consistent with Wikipedia's workflow, this is not always appropriate, and on some projects may even be usually inappropriate depending on their workflow. Currently, ambox on mobile view shows a discreet message "Page Issues" which can be clicked on to see what the issues are.)

This template generates two boxes, one for the desktop view and a second for the mobile view; one or the other should be hidden via css.

The desktop box draws its primary content from parameter  if available, otherwise parameter  if available. The mobile box looks for first, otherwise.

Parameter  if provided determines the color of the border and bar on the left side of the box, and may determine the left image. Parameter  if omitted or blank defaults to. As of this writing, the types with associated colors are

while those with associated images are

The desktop box takes optional parameters  and   to specify images (or other content) to the left and to the right of the text. If  is omitted, the left image defaults to some image based on  ; if   is blank, space is left as if there were an image (allowing multiple messages to align);   omits the left image. The right image is omitted unless explicitly specified.

The mobile box uses instead optional parameters and. If is unspecified it defaults to none, if blank it defaults to an image based on.

If parameter  is non-blank, the boxes also have class.

Internals
The desktop box is wrapped in a div element of class desktop-only, the mobile box in a div element of class mobile-only; there should be a rule in Mediawiki:Common.css hiding elements of class mobile-only, and in Mediawiki:Mobile.css hiding elements of class desktop-only.