Template:Navbar/doc: Difference between revisions

Line 4:

== Usage ==

===General===

Copy one of the following examples. When it is placed inside a given [[Help:templates|template]]~~, and only a template,~~ it adds navbar navigational functionality:

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:~~PAGENAME~~}}|mini=1}}</nowiki></tt>

:<tt><nowiki>{{navbar|{{subst:FULLPAGENAME}}|mini=1}}</nowiki></tt> (v/t/e only, most used)

:<tt><nowiki>{{navbar|{{subst:~~PAGENAME~~}}|plain=1}}</nowiki></tt>

:<tt><nowiki>{{navbar|{{subst:FULLPAGENAME}}|plain=1}}</nowiki></tt> (no "this box" comment)

:<tt><nowiki>{{navbar|{{subst:~~PAGENAME~~}}|fontstyle=color:green}}</nowiki></tt>

:<tt><nowiki>{{navbar|{{subst:FULLPAGENAME}}|fontstyle=color:green}}</nowiki></tt> (may fit better in some navboxes)

The <code><nowiki>{{subst:~~PAGENAME~~}}</nowiki></code> will be substituted with the template's ~~name~~ when parsed by the servers. For example, <code><nowiki>{{navbar|{{subst:~~PAGENAME~~}}}}</nowiki></code> gives: <code><nowiki>{{navbar|navbar~~/doc~~}}</nowiki></code> ~~– note~~ that the wikispace, ~~while~~ nominally in the URL, is ~~not~~ included in the ~~substituted pagename~~. And thus, the final output is:

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"

|{{navbar|navbar~~/doc~~}}

|{{navbar|navbar}}

|}

Line 20:

== Examples ==

===Required parameters===

*<code><nowiki>{{navbar|Template Name}}</nowiki></code> – the template name is required. ''It ~~must '''not include'''~~ the template-space identifier ~~and it will not work for other wikispaces''~~. It may be automatically filled as in the Usage section for convenience.

*<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===

@@ Line 4: / Line 4: @@
 == Usage ==
 ===General===
-Copy one of the following examples. When it is placed inside a given [[Help:templates|template]], and only a template, it adds navbar navigational functionality:
+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:PAGENAME}}|mini=1}}</nowiki></tt>
+:<tt><nowiki>{{navbar|{{subst:FULLPAGENAME}}|mini=1}}</nowiki></tt> (v/t/e only, most used)
-:<tt><nowiki>{{navbar|{{subst:PAGENAME}}|plain=1}}</nowiki></tt>
+:<tt><nowiki>{{navbar|{{subst:FULLPAGENAME}}|plain=1}}</nowiki></tt> (no "this box" comment)
-:<tt><nowiki>{{navbar|{{subst:PAGENAME}}|fontstyle=color:green}}</nowiki></tt>
+:<tt><nowiki>{{navbar|{{subst:FULLPAGENAME}}|fontstyle=color:green}}</nowiki></tt> (may fit better in some navboxes)
-The <code><nowiki>{{subst:PAGENAME}}</nowiki></code> will be substituted with the template's name when parsed by the servers. For example, <code><nowiki>{{navbar|{{subst:PAGENAME}}}}</nowiki></code> gives: <code><nowiki>{{navbar|navbar/doc}}</nowiki></code> &ndash; note that the wikispace, while nominally in the URL, is not included in the substituted pagename. And thus, the final output is:
+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"
-|{{navbar|navbar/doc}}
+|{{navbar|navbar}}
 |}
@@ Line 20: / Line 20: @@
 == Examples ==
 ===Required parameters===
-*<code><nowiki>{{navbar|Template Name}}</nowiki></code> – the template name is required. ''It must '''not include''' the template-space identifier and it will not work for other wikispaces''. It may be automatically filled as in the Usage section for convenience.
+*<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===