Difference between revisions of "Template:Navbox style/doc"

From Kerbal Space Program Wiki
Jump to: navigation, search
(Rewrite the docs to reflect the new purpose of this template. Preserve the history in the docs, in case it's useful to someone in the future. (And yeah, I know the italics don't work in <pre>…))
(Examples)
Line 47: Line 47:
 
}}
 
}}
 
</pre>
 
</pre>
 +
 +
=== Examples ===
 +
 +
{{Navbox
 +
| name = Navbox style/doc
 +
 +
| titlestyle      = {{Navbox style|color=red|title}}
 +
| abovestyle      = {{Navbox style|color=red|above}}
 +
| belowstyle      = {{Navbox style|color=red|below}}
 +
| groupstyle      = {{Navbox style|color=red|group}}
 +
 +
| title = Level 1
 +
| above = Level 2
 +
 +
| list1 = {{Navbox|child
 +
| titlestyle      = {{Navbox style|color=red|child|title}}
 +
| abovestyle      = {{Navbox style|color=red|child|above}}
 +
| belowstyle      = {{Navbox style|color=red|child|below}}
 +
| groupstyle      = {{Navbox style|color=red|child|group}}
 +
 +
| above = Level 3
 +
 +
| list1 = color=red
 +
}}
 +
}}
 +
{{Navbox
 +
| name = Navbox style/doc
 +
 +
| titlestyle      = {{Navbox style|color=green|title}}
 +
| abovestyle      = {{Navbox style|color=green|above}}
 +
| belowstyle      = {{Navbox style|color=green|below}}
 +
| groupstyle      = {{Navbox style|color=green|group}}
 +
 +
| title = Level 1
 +
| above = Level 2
 +
 +
| list1 = {{Navbox|child
 +
| titlestyle      = {{Navbox style|color=green|child|title}}
 +
| abovestyle      = {{Navbox style|color=green|child|above}}
 +
| belowstyle      = {{Navbox style|color=green|child|below}}
 +
| groupstyle      = {{Navbox style|color=green|child|group}}
 +
 +
| above = Level 3
 +
 +
| list1 = color=green
 +
}}
 +
}}
 +
{{Navbox
 +
| name = Navbox style/doc
 +
 +
| titlestyle      = {{Navbox style|color=blue|title}}
 +
| abovestyle      = {{Navbox style|color=blue|above}}
 +
| belowstyle      = {{Navbox style|color=blue|below}}
 +
| groupstyle      = {{Navbox style|color=blue|group}}
 +
 +
| title = Level 1
 +
| above = Level 2
 +
 +
| list1 = {{Navbox|child
 +
| titlestyle      = {{Navbox style|color=blue|child|title}}
 +
| abovestyle      = {{Navbox style|color=blue|child|above}}
 +
| belowstyle      = {{Navbox style|color=blue|child|below}}
 +
| groupstyle      = {{Navbox style|color=blue|child|group}}
 +
 +
| above = Level 3
 +
 +
| list1 = color=blue
 +
}}
 +
}}
 +
{{Navbox
 +
| name = Navbox style/doc
 +
 +
| titlestyle      = {{Navbox style|color=silver|title}}
 +
| abovestyle      = {{Navbox style|color=silver|above}}
 +
| belowstyle      = {{Navbox style|color=silver|below}}
 +
| groupstyle      = {{Navbox style|color=silver|group}}
 +
 +
| title = Level 1
 +
| above = Level 2
 +
 +
| list1 = {{Navbox|child
 +
| titlestyle      = {{Navbox style|color=silver|child|title}}
 +
| abovestyle      = {{Navbox style|color=silver|child|above}}
 +
| belowstyle      = {{Navbox style|color=silver|child|below}}
 +
| groupstyle      = {{Navbox style|color=silver|child|group}}
 +
 +
| above = Level 3
 +
 +
| list1 = color=silver
 +
}}
 +
}}
  
 
=== History ===
 
=== History ===

Revision as of 08:01, 12 June 2015

Usage

This template is not used directly, it is intended for a very specific use, to generate parameters for another highly complex template.

This template provides a mechanism for standard style customisation of {{Navbox}} templates. The site default style comes from MediaWiki:Common.css, and navbox templates should generally use the site default unless they have a good reason to use something else. Currently the style parameter below can be set one of the following:

  • |color=red
  • |color=green
  • |color=blue (the current site default, and only included for completeness)

e.g. {{Navbox style|color=green|title}}

It is currently intended to only be used for relatively minor re-styling, such as alternate color schemes. Major changes to the style should really be done via the site CSS.

If you do not wish to customise the style of a navbox, it should not contain any reference to this template.

Top level navboxes

{{Navbox

...

| titlestyle      = {{Navbox style|''style''|title}}
| abovestyle      = {{Navbox style|''style''|above}}
| belowstyle      = {{Navbox style|''style''|below}}
| groupstyle      = {{Navbox style|''style''|group}}

...

}}

Subgroup / child navboxes

{{Navbox|child

...

 | titlestyle      = {{Navbox style|''style''|child|title}}
 | abovestyle      = {{Navbox style|''style''|child|above}}
 | belowstyle      = {{Navbox style|''style''|child|below}}
 | groupstyle      = {{Navbox style|''style''|child|group}}

...
}}

Examples

History

This template was originally a temporary workaround for the CSS missing from MediaWiki:Common.css which was needed to properly support the use of {{Navbox}}. Due to the nature of CSS, it can never be a perfect solution, and is the wrong way to specify the actual layout. The style options being passed to {{Navbox}} exceeded the original design of it, as those options were only ever intended for minor adjustments such as changing the color scheme. Despite that, the usage did provide a short term acceptable solution until the correct CSS was in place. The visual result was broadly similar to that achieved with the correct CSS stylesheet in place. Inline style via the "style" attribute on HTML elements is never a full or correct replacement for a CSS stylesheet, and contains a number of limitations not present for a stylesheet.

The original approximation of the full CSS for {{Navbox}} has been stripped out, but can be found in the template's change history. Remember, it was an imperfect solution, and was only ever intended to be a temporary workaround. It was removed from this template to avoid both current and future conflicts with changes made to the site CSS.