Difference between revisions of "Template:Navbox/doc"

From Nookipedia, the Animal Crossing wiki
(Fix leftover from sandbox)
(→‎Usage: Update documentation)
Line 16: Line 16:
 
  | List          =  
 
  | List          =  
  
  | Above2        =
+
  | Below          =
  | Group2        =  
+
  | BelowLink      =
| Group2Link    =
+
}}
| List2          =
+
</pre>
  
| Above3        =
+
This template is intended to be used for all navboxes, as it allows them to be easily created and maintained and gives them a consistent visual style and functionality. It is very complex, and has been designed to adapt to the many different needs of various navboxes across the wiki. This template is mobile-friendly and will appear with repositioned elements on mobile devices.
| Group3        =
 
| Group3Link    =
 
| List3          =
 
  
| Above4        =
+
The following parameters primarily set the visual style of the template:
| Group4        =
+
* <code>Title</code> sets the displayed heading of the navbox.
| Group4Link    =
+
* <code>Link</code> sets a linked page for the navbox title.
| List4          =
+
* <code>Icon</code> is an optional parameter that allows an image or text to appear in the upper-left corner of the navbox.
 +
* <code>IconSize</code> is an optional parameter that allows a custom size for the icon to be specified.
 +
* <code>Image</code> sets the image file to be displayed on the right side of the navbox.
  
| Above5        =
+
* <code>PrimaryColor</code> sets the display colors of the infobox. Requires hue and saturation values in in '''HSL format''', as other colors on the template are adjusted dynamically based on these values.
| Group5        =
+
* <code>SecondaryColor</code> allows a complimentary color to be specified. Requires hue and saturation values in in '''HSL format''', as other colors on the template are adjusted dynamically based on these values.
| Group5Link    =
+
* <code>Width</code> allows a custom width to be specified for the navbox (for style reasons this parameter should normally not be used)
| List5          =
 
  
| Above6        =
+
The following parameters primarily set the content of the template:
| Group6        =
+
* <code>Above</code> sets a text heading to be displayed above the group and list.
| Group6Link    =
+
* <code>Group</code> sets a text heading for the group, which appears to the left of the list.
| List6          =
+
* <code>GroupLink</code> sets sets a linked page for the group heading text.
 +
* <code>List</code> sets the content that appears in the list. This should always be wikilinks to articles, and each link should be separated with a bullet (•) symbol.
  
| Above7        =
+
The following parameters set the content of the navbox footer. This should be used to link to the topic's category, project page or relevant image category. It can also be used for broad topic links that don't fit into any of the groups in the navbox.
| Group7        =
+
* <code>Below</code> sets the text of a link that will appear in the footer.
| Group7Link    =
+
* <code>BelowLink</code> sets the linked page for the specified text.
| List7          =
 
  
| Above8        =
+
The infobox template supports up to 10 groups with lists and 5 footer links. When adding more than one, you must append the sequential number to the names of the parameters like so. Failing to this will result in display errors.
| Group8        =
+
<pre>
| Group8Link    =
+
  | Above2         =
| List8          =
+
  | Group2         =
 
+
  | Group2Link     =
  | Above9         =
+
  | List2         =
  | Group9         =  
 
  | Group9Link     =  
 
  | List9         =  
 
  
| Above10        =
+
  | Below2        =  
| Group10        =
 
| Group10Link    =
 
| List10        =
 
 
 
| Below          =
 
| BelowLink      =
 
  | Below2        =
 
 
  | Below2Link    =
 
  | Below2Link    =
| Below3        =
 
| Below3Link    =
 
| Below4        =
 
| Below4Link    =
 
| Below5        =
 
| Below5Link    =
 
}}
 
 
</pre>
 
</pre>
 
This template is used for all navboxes, and allows them to be easily created and maintained.
 
  
 
===Example===
 
===Example===

Revision as of 18:10, July 4, 2020

Usage

{{Navbox
 | Title          = 
 | Link           = 
 | Icon           = 
 | IconSize       = 
 | Image          = 
 | PrimaryColor   = 
 | SecondaryColor = 
 | Width          =

 | Above          =
 | Group          = 
 | GroupLink      = 
 | List           = 

 | Below          =
 | BelowLink      =
}}

This template is intended to be used for all navboxes, as it allows them to be easily created and maintained and gives them a consistent visual style and functionality. It is very complex, and has been designed to adapt to the many different needs of various navboxes across the wiki. This template is mobile-friendly and will appear with repositioned elements on mobile devices.

The following parameters primarily set the visual style of the template:

  • Title sets the displayed heading of the navbox.
  • Link sets a linked page for the navbox title.
  • Icon is an optional parameter that allows an image or text to appear in the upper-left corner of the navbox.
  • IconSize is an optional parameter that allows a custom size for the icon to be specified.
  • Image sets the image file to be displayed on the right side of the navbox.
  • PrimaryColor sets the display colors of the infobox. Requires hue and saturation values in in HSL format, as other colors on the template are adjusted dynamically based on these values.
  • SecondaryColor allows a complimentary color to be specified. Requires hue and saturation values in in HSL format, as other colors on the template are adjusted dynamically based on these values.
  • Width allows a custom width to be specified for the navbox (for style reasons this parameter should normally not be used)

The following parameters primarily set the content of the template:

  • Above sets a text heading to be displayed above the group and list.
  • Group sets a text heading for the group, which appears to the left of the list.
  • GroupLink sets sets a linked page for the group heading text.
  • List sets the content that appears in the list. This should always be wikilinks to articles, and each link should be separated with a bullet (•) symbol.

The following parameters set the content of the navbox footer. This should be used to link to the topic's category, project page or relevant image category. It can also be used for broad topic links that don't fit into any of the groups in the navbox.

  • Below sets the text of a link that will appear in the footer.
  • BelowLink sets the linked page for the specified text.

The infobox template supports up to 10 groups with lists and 5 footer links. When adding more than one, you must append the sequential number to the names of the parameters like so. Failing to this will result in display errors.

 | Above2         =
 | Group2         =
 | Group2Link     =
 | List2          =

 | Below2         = 
 | Below2Link     =

Example

{{Navbox
 | Title          = Fashion
 | Icon           = Tops NH Icon cropped.png
 | Image          = [[File:Gracie NLa.png|40px|link=]]
 | PrimaryColor   = 322 49

 | Group          = Clothing
 | List           = [[Clothes]] • [[Accessories]] • [[Bottoms]] • [[Dress|Dresses]] • [[Headgear]] • [[Shoes]] • [[Socks]] • [[Tops]] • [[Umbrellas]] • [[Wigs]]

 | Group2         = Concepts
 | List2          = [[Design]]s • [[Look]] • [[Hairstyle]] • [[Mii Mask]]

 | Group3         = Merchants
 | List3          = [[Able Sisters]] • [[GracieGrace]] • [[Kicks (shop)|Kicks]] • [[Shampoodle]]

 | Group4         = Designers
 | List4          = [[Gracie]] • [[Harriet]] • [[Kicks]] • [[Label]] • [[Mabel]] • [[Sable]]

 | Below          = Category
 | BelowLink      = :Category:Furniture
 | Below2         = Project
 | Below2Link     = Nookipedia:Project Fashion
}}