Difference between revisions of "Template:Navbar/doc"
(→General: Oops. Removed code (font is weird, only backgrounds the text and not the whole thing) and replaced with table.) |
(Update for FULLPAGENAME magic word) |
||
Line 4: | Line 4: | ||
== Usage == | == Usage == | ||
===General=== | ===General=== | ||
− | Copy one of the following examples. When it is placed inside a given [[Help:templates|template]] | + | Copy one of the following examples. When it is placed inside a given [[w:Help:templates|template]] or other page it adds navbar navigational functionality to the following; the pagename, its doc subpage, and an editing link to the page, as follows: |
− | :<tt><nowiki>{{navbar|{{subst: | + | :<tt><nowiki>{{navbar|{{subst:FULLPAGENAME}}|mini=1}}</nowiki></tt> (v/t/e only, most used) |
− | :<tt><nowiki>{{navbar|{{subst: | + | :<tt><nowiki>{{navbar|{{subst:FULLPAGENAME}}|plain=1}}</nowiki></tt> (no "this box" comment) |
− | :<tt><nowiki>{{navbar|{{subst: | + | :<tt><nowiki>{{navbar|{{subst:FULLPAGENAME}}|fontstyle=color:green}}</nowiki></tt> (may fit better in some navboxes) |
− | The <code><nowiki>{{subst: | + | The <code><nowiki>{{subst:FULLPAGENAME}}</nowiki></code> will be substituted with the template's namespace and pagename, when parsed by the servers. For example, <code><nowiki>{{navbar|{{subst:FULLPAGENAME}}}}</nowiki></code> on this template page gives: <code><nowiki>{{navbar|navbar}}</nowiki></code>. Note that the wikispace, is nominally in the link or URL (eg [[:Template:Navbox]] and is included in the parameter specified. And thus, the final output of this test example is inside the following: |
{|style="background:#000000" | {|style="background:#000000" | ||
− | |{{navbar|navbar | + | |{{navbar|navbar}} |
|} | |} | ||
Line 20: | Line 20: | ||
== Examples == | == Examples == | ||
===Required parameters=== | ===Required parameters=== | ||
− | *<code><nowiki>{{navbar|Template Name}}</nowiki></code> – the template name is required. | + | *<code><nowiki>{{navbar|Template Name}}</nowiki></code> – the template name is required. It should the template-space identifier, as per FULLPAGENAME magic word formatting. It may be automatically filled as in the Usage section, again with the magic word code, for convenience. |
===Optional parameters=== | ===Optional parameters=== |
Revision as of 16:21, 4 September 2015
Usage
General
Copy one of the following examples. When it is placed inside a given template or other page it adds navbar navigational functionality to the following; the pagename, its doc subpage, and an editing link to the page, as follows:
- {{navbar|{{subst:FULLPAGENAME}}|mini=1}} (v/t/e only, most used)
- {{navbar|{{subst:FULLPAGENAME}}|plain=1}} (no "this box" comment)
- {{navbar|{{subst:FULLPAGENAME}}|fontstyle=color:green}} (may fit better in some navboxes)
The {{subst:FULLPAGENAME}}
will be substituted with the template's namespace and pagename, when parsed by the servers. For example, {{navbar|{{subst:FULLPAGENAME}}}}
on this template page gives: {{navbar|navbar}}
. Note that the wikispace, is nominally in the link or URL (eg Template:Navbox and is included in the parameter specified. And thus, the final output of this test example is inside the following:
Font-size
Font-size is 88% when used in a navbar, and 100% when nested in a navbox. In the navbar, the weight is "normal"; when nested in navbox, it takes on the outer setting. The middot is bold.
Examples
Required parameters
{{navbar|Template Name}}
– the template name is required. It should the template-space identifier, as per FULLPAGENAME magic word formatting. It may be automatically filled as in the Usage section, again with the magic word code, for convenience.
Optional parameters
Options | Parameters | Produces... (this page) |
---|---|---|
Basic | {{navbar|Template: Name}} |
|
Different text | {{navbar|Template: Name|text=This template:}} |
|
Without "This box:" text | {{navbar|Template: Name|plain=1}} |
|
Short version | {{navbar|Template: Name|mini=1}} |
|
With a color option | {{navbar|Template: Name|fontstyle=color:green}} |
|
With brackets | {{navbar|Template: Name|brackets=1}}
|
Deprecated parameters
The miniv=1, viewplain=1, nodiv=1 and fontcolor= parameters have been deprecated. To implement the view-only version, use the {{v}}
or {{view}}
templates instead.
Notes
Navbar is contained within a <div>...</div>
in order to accomodate a horizontal unnumbered list. This means it cannot be placed inside a <span>...</span>
or other inline element, because Tidy will 'fix' situations where it finds block elements inside inline elements.
Prepackaged
{{Tnavbar-header}}
- Positions v · d · e on the right edge of the line, often used in non-collapsible navbox heading.
{{Tnavbar-navframe}}
- For use in conjunction with Navframe divs, positions v · d · e opposite of the [hide]/[show] feature.
{{Tnavbar-collapsible}}
- For use in conjunction with Collapsible tables, floats v · d · e opposite of the [hide]/[show] feature.