Template:Sidebar/doc View history

(Created doc page for template)
 
No edit summary
 
Line 1: Line 1:
{{documentation subpage}}
{{documentation subpage}}


This template is intended to be a [[wikt:metatemplate|metatemplate]] for sidebar templates, which are [[Vertical direction|vertically]]-aligned [[Wikipedia:Navigation templates|navigation templates]].  The sidebar is usually positioned on the right-hand side of a page, in the same way as the {{tlx|infobox}} template is aligned for [[Wikipedia:Manual of Style/Infoboxes|infoboxes]].  
This template is intended as a metatemplate for sidebar templates (vertically-aligned [[:Category:Navigational templates|navigation (navbox)]] templates usually positioned on the right-hand sides of pages) in the same spirit as {{tl|Infobox}} for [[:en:Wikipedia:Manual of Style/Infoboxes|infobox]] templates and {{tl|Navbox}} for navbox templates.


{{tl|Sidebar with collapsible lists}} adds collapsibility to a sidebar's sections, i.e., the means to show or hide sections by clicking links beside their headings.
{{tl|Sidebar with collapsible lists}} adds collapsibility to a Sidebar's sections, i.e. the means to show or hide sections by clicking links beside their headings.


== Usage ==
== Usage ==
{{Sidebar
{{sidebar
| name = {{PAGENAME}}
| name       = {{PAGENAME}}
| outertitle = {{{outertitle}}}
| outertitle = {{{outertitle}}}
| topimage = {{{topimage}}}
| topimage   = {{{topimage}}}
| topcaption = {{{topcaption}}}
| topcaption = {{{topcaption}}}
| pretitle = {{{pretitle}}}
| pretitle   = {{{pretitle}}}
| title = {{{title}}}
| title     = {{{title}}}
| image = {{{image}}}
| image     = {{{image}}}
| above = {{{above}}}
 
| heading1 = {{{heading1}}}
| above     = {{{above}}}
| content1 = {{{content1}}}
| heading1   = {{{heading1}}}
| heading2 = {{{heading2}}}
| content1   = {{{content1}}}
| content2 = {{{content2}}}
| heading2   = {{{heading2}}}
| heading3 = {{{heading3}}}
| content2   = {{{content2}}}
| content3 = {{{content3}}}
| heading3   = {{{heading3}}}
| content4 = ... up to 35th ...
| content3   = {{{content3}}}
| heading35 = {{{heading35}}}
| content4   = ................
| content35 = {{{content35}}}
| heading35 = {{{heading35}}}
| below = {{{below}}}
| content35 = {{{content35}}}
| below     = {{{below}}}
 
}}
}}


(parameters with infrequent use omitted)
Parameters with infrequent use omitted.
<pre style="overflow:auto;">
<pre style="overflow: auto;">
{{Sidebar
{{sidebar
| name = {{subst:PAGENAME}}
| name       = {{subst:PAGENAME}}
| outertitle =  
| outertitle =  
| topimage =  
| topimage   =  
| pretitle =  
| pretitle   =  
| title =  
| title     =  
| image =  
| image     =  


| headingstyle =  
| headingstyle =  
Line 49: Line 51:
| content3 =  
| content3 =  


<!--...up to 35th:-->
...


| heading35 =  
| heading35 =  
Line 118: Line 120:
|- style="vertical-align: top;"
|- style="vertical-align: top;"
| {{para|above}}
| {{para|above}}
| Corresponds to {{para|above}} offered by {{tl|navbox}}.
| Corresponds to {{para|above}} offered by {{tl|Navbox}}.
|-
|-
|
|
Line 172: Line 174:


== Handling long links ==
== Handling long links ==
{{tl|Normalwraplink}} may be used to handle links that should wrap within the sidebar or otherwise need to be made to wrap, in order to prevent the sidebar from becoming too wide. Use {{tlx|normalwraplink|''longlinkname''}}, where {{para||''longlinkname''}} is the long link without its square brackets.
{{tl|Normalwraplink}} may be used to handle links that should wrap within the sidebar or otherwise need to be made to wrap in order to prevent the sidebar becoming too wide. Use {{tlx|Normalwraplink|''longlinkname''}}, where {{para||''longlinkname''}} is the long link without its square brackets.


Use the {{para|wraplinks|true}} parameter to turn link wrapping off for the whole template.
Use the {{para|wraplinks|true}} parameter to turn link wrapping off for the whole template.
==Embedding==
One sidebar template can be embedded into another using the {{para|child}} parameter.  This feature can be used to create a modular sidebar, or to create more well-defined and logical sections.
{{sidebar
| title = Top level title
| content1 = {{sidebar
  | child = yes
  | title = First subsection
  | heading1 = Heading 1.1
  | content1 = Content 1.1
}}
| content2 = {{sidebar
  | child = yes
  | title = Second subsection
  | heading1 = Heading 2.1
  | content1 = Content 2.1
}}
|belowstyle =
|below = Below text
}}
<pre style="overflow:auto">
{{sidebar
| title = Top level title
| content1 = {{sidebar
  | child = yes
  | title = First subsection
  | heading1 = Heading 1.1
  | content1 = Content 1.1
}}
| content2 = {{sidebar
  | child = yes
  | title = Second subsection
  | heading1 = Heading 2.1
  | content1 = Content 2.1
}}
|belowstyle =
|below = Below text
}}
</pre>
Note, in the examples above, the child infobox is placed in a <code>content</code> field, not a <code>heading</code> field.  Notice that the section subheadings are not in bold font if bolding is not explicitly specified. To obtain bold section headings, place the child infobox in a <code>heading</code> field, either using
{{sidebar
| title = Top level title
| heading1 = {{sidebar
  | child = yes
  | title = First subsection
  | heading1 = Heading 1.1
  | content1 = Content 1.1
}}
| heading2 = {{sidebar
  | child = yes
  | title = Second subsection
  | heading1 = Heading 2.1
  | content1 = Content 2.1
}}
|belowstyle =
|below = Below text
}}
<pre style="overflow:auto">
{{sidebar
| title = Top level title
| heading1 = {{sidebar
  | child = yes
  | title = First subsection
  | heading1 = Heading 1.1
  | content1 = Content 1.1
}}
| heading2 = {{sidebar
  | child = yes
  | title = Second subsection
  | heading1 = Heading 2.1
  | content1 = Content 2.1
}}
|belowstyle =
|below = Below text
}}
</pre>
or,
{{sidebar
| title = Top level title
| heading1 = First subsection {{sidebar
  | child = yes
  | heading1 = Heading 1.1
  | content1 = Content 1.1
}}
| heading2 = Second subsection {{sidebar
  | child = yes
  | heading1 = Heading 2.1
  | content1 = Content 2.1
}}
|belowstyle =
|below = Below text
}}
<pre style="overflow:auto">
{{sidebar
| title = Top level title
| heading1 = First subsection {{sidebar
  | child = yes
  | heading1 = Heading 1.1
  | content1 = Content 1.1
}}
| heading2 = Second subsection {{sidebar
  | child = yes
  | heading1 = Heading 2.1
  | content1 = Content 2.1
}}
|belowstyle =
|below = Below text
}}
</pre>
Note that omitting the {{para|title}} parameter, and not including any text preceding the embedded sidebar, may result in spurious blank table rows, creating gaps in the visual presentation.


== Full blank syntax ==
== Full blank syntax ==
(omitting sections 4 to penultimate)
(omitting sections 4 to penultimate)


<pre style="overflow:auto;">
<pre style="overflow: auto;">
{{Sidebar
{{Sidebar
| name = {{subst:PAGENAME}}
| name       = {{subst:PAGENAME}}
| class =           <!--or bodyclass-->
| bodyclass  = <!--or class-->
| style =           <!--or bodystyle-->
| bodystyle  = <!--or style-->
| width =  
| width       =  
| cellspacing =  
| cellspacing =  
| cellpadding =  
| cellpadding =  


| outertitle      =
| outertitleclass =  
| outertitleclass =  
| outertitlestyle =  
| outertitlestyle =  
| outertitle =


| topimageclass =  
| topimage        =
| topimagestyle =  
| topimageclass   =  
| topimage =  
| topimagestyle   =  
| topcaption      =  
| topcaptionstyle =  
| topcaptionstyle =  
| topcaption =


| pretitle      =
| pretitleclass =  
| pretitleclass =  
| pretitlestyle =  
| pretitlestyle =  
| pretitle =  
| title        =
| titleclass    =  


| titleclass =  
| image        =  
| title =  
| imageclass  =
| imagestyle  =
| caption      =
| captionstyle =  


| imageclass =  
| above      =  
| imagestyle =  
| aboveclass =  
| image =
| abovestyle =  
| captionstyle =
| caption =  


| headingclass =  
| headingclass =  
Line 325: Line 220:
| contentclass =  
| contentclass =  
| contentstyle =  
| contentstyle =  
| aboveclass =
| abovestyle =
| above =


| heading1style =  
| heading1style =  
| heading1 =  
| heading1     =  
| content1style =  
| content1style =  
| content1 =  
| content1     =  


| heading2style =  
| heading2style =  
| heading2 =  
| heading2     =  
| content2style =  
| content2style =  
| content2 =  
| content2     =  


| heading3style =  
| heading3style =  
| heading3 =  
| heading3     =  
| content3style =  
| content3style =  
| content3 =  
| content3     =  


<!--...up to 35th:-->
<!--etc.-->


| heading35style =  
| heading35style =  
| heading35 =  
| heading35     =  
| content35style =  
| content35style =  
| content35 =  
| content35     =  


| below      =
| belowclass =  
| belowclass =  
| belowstyle =  
| belowstyle =  
| below =


| navbarstyle =     <!--or tnavbarstyle-->
| navbar          = <!--or tnavbar-->
| navbarfontstyle = <!--or tnavbarfontstyle-->
| navbarstyle    = <!--or tnavbarstyle-->
| navbar =           <!--or tnavbar-->
| navbarfontstyle = <!--or tnavbarfontstyle-->
 
| wraplinks =        <!--true or false-->


| wraplinks = true/false
}}
}}
</pre>
</pre>


== Supplementary documentation ==
==Related pages==
Supplementary documentation relevant to navigational functionality through 'navbar' coding in a sidebar is at [[Template:Navbar/doc]].
 
== See also ==
* {{tl|Sidebar with collapsible lists}}
* {{tl|Sidebar with collapsible lists}}
* {{tl|Infobox}}
* {{tl|Infobox}}
* [[Wikipedia:UBLIST]], for help in using unbulleted lists in fields.
   
   
<includeonly>{{#ifeq:{{PAGENAME}}|{{BASEPAGENAME}}|
<includeonly>{{#ifeq:{{PAGENAME}}|{{BASEPAGENAME}}|

Latest revision as of 20:52, 23 February 2016

This is a documentation subpage for Template:Sidebar.
It contains usage information, categories and other content that is not part of the original template page.

This template is intended as a metatemplate for sidebar templates (vertically-aligned navigation (navbox) templates usually positioned on the right-hand sides of pages) in the same spirit as {{Infobox}} for infobox templates and {{Navbox}} for navbox templates.

{{Sidebar with collapsible lists}} adds collapsibility to a Sidebar's sections, i.e. the means to show or hide sections by clicking links beside their headings.

Usage

Parameters with infrequent use omitted.

{{sidebar
| name       = {{subst:PAGENAME}}
| outertitle = 
| topimage   = 
| pretitle   = 
| title      = 
| image      = 

| headingstyle = 
| contentstyle = 

| heading1 = 
| content1 = 

| heading2 = 
| content2 = 

| heading3 = 
| content3 = 

...

| heading35 = 
| content35 = 

}}

Parameters

No parameters are required unless {{navbar}} links (V - T - E) are to appear at the bottom of the sidebar, in which case the |name= parameter is needed (see entry in the table immediately below).

Principal

Parameter Explanation
|name= The sidebar's name, i.e., the name following "Template:" in the page's name. Required for the {{navbar}} links at the bottom of the sidebar to function correctly, unless these are omitted (see |navbar= at the bottom of this table). It is recommended to use {{subst:PAGENAME}} for this field.
|outertitle= Use to place a title for the sidebar immediately above the sidebar.
|topimage= Use to place an image at the top of the sidebar, i.e., above any |title= included.

Full wikisyntax expected (i.e., [[File:...]]).
To add a caption below the image, use |topcaption=.

|pretitle= Use to place a line such as "Part of the X series on" before the title.
|title= Use to place a title for the sidebar at the top of the sidebar (immediately below the |topimage=, if used).
|image= Use to place an image between the |title= (if used) and first section.

As with |topimage=, full wikisyntax expected (i.e., [[File:...]]).
To add a caption below the image, use |caption=.

|headingstyle= Use to alter the default CSS styling set for section headings.

To alter the CSS styling for a specific section's heading, use |headingnstyle=, where n is the number of the section.

|contentstyle= Use to alter the default CSS styling set for section content.

To alter the CSS styling for a particular section's content, use |contentnstyle=, where n is the number of the section.

|heading1= First section's heading (if needed).
|content1= First section's content (required).
|heading2= Second section's heading (if needed).
|content2= Second section's content (if needed).
|heading3= Third section's heading (if needed).
|content3= Third section's content (if needed).
...... etc ......
|heading35= Currently, the last possible section heading and/or content (if needed).
|content35=

Other parameters

Parameter Explanation
|above= Corresponds to |above= offered by {{Navbox}}.
  • |bodyclass= (or |class=)
  • |outertitleclass=
  • |topimageclass=
  • |pretitleclass=
  • |titleclass=
  • |imageclass=
  • |aboveclass=
  • |headingclass=
  • |contentclass=
  • |belowclass=

Microformat classes for the corresponding parameters.
(|bodyclass= (or |class=) applies to the sidebar as a whole.)

|below= Use to, e.g., add one or more portal links to the bottom of the template (by default in bold).
  • |bodystyle= (or |style=)
  • |outertitlestyle=
  • |topimagestyle=
  • |topcaptionstyle=
  • |pretitlestyle=
  • |titlestyle=
  • |imagestyle=
  • |captionstyle=
  • |abovestyle=
  • |headingstyle=
  • |headingnstyle=
  • |contentstyle=
  • |contentnstyle=
  • |belowstyle=
  • |navbarstyle= (or |tnavbarstyle=)

Use to alter default CSS styling for the corresponding parameters.
(|bodystyle= (or |style=) applies to the sidebar as a whole.)

|cellspacing= Use to amend the default cellspacing set for the infobox-class table with which the sidebar is built.
|cellpadding= Ditto the default cellpadding.
|navbar= (or |tnavbar=) Set to "none" (without the quotes) to remove the {{navbar}} links appearing at the bottom of the sidebar.
|navbarfontstyle= (or |tnavbarfontstyle=) Use to specify the font style used by the navbar at the bottom of the sidebar (see {{navbar}} for options available).

Handling long links

{{Normalwraplink}} may be used to handle links that should wrap within the sidebar or otherwise need to be made to wrap in order to prevent the sidebar becoming too wide. Use {{Normalwraplink|longlinkname}}, where |longlinkname is the long link without its square brackets.

Use the |wraplinks=true parameter to turn link wrapping off for the whole template.

Full blank syntax

(omitting sections 4 to penultimate)

{{Sidebar
| name        = {{subst:PAGENAME}}
| bodyclass   = <!--or class-->
| bodystyle   = <!--or style-->
| width       = 
| cellspacing = 
| cellpadding = 

| outertitle      = 
| outertitleclass = 
| outertitlestyle = 

| topimage        = 
| topimageclass   = 
| topimagestyle   = 
| topcaption      = 
| topcaptionstyle = 

| pretitle      = 
| pretitleclass = 
| pretitlestyle = 
| title         = 
| titleclass    = 

| image        = 
| imageclass   = 
| imagestyle   = 
| caption      = 
| captionstyle = 

| above      = 
| aboveclass = 
| abovestyle = 

| headingclass = 
| headingstyle = 
| contentclass = 
| contentstyle = 

| heading1style = 
| heading1      = 
| content1style = 
| content1      = 

| heading2style = 
| heading2      = 
| content2style = 
| content2      = 

| heading3style = 
| heading3      = 
| content3style = 
| content3      = 

<!--etc.-->

| heading35style = 
| heading35      = 
| content35style = 
| content35      = 

| below      = 
| belowclass = 
| belowstyle = 

| navbar          = <!--or tnavbar-->
| navbarstyle     = <!--or tnavbarstyle-->
| navbarfontstyle = <!--or tnavbarfontstyle-->

| wraplinks = true/false
}}