Template:Prevnext2: Difference between revisions

Latest revision as of 10:03, 6 March 2024

The old code was

<includeonly><table align=center id=toc style="width: 95%" class="noprint"><tr>
<td style="text-align: left; width: 33%">{{#if: {{{prevpage|}}} | [[{{{prevpage}}}|← {{{prevtext|{{{prevpage}}}}}}]] | }}</td>
<td style="text-align: center; width:   33%">'''{{#if: {{{index|}}} | [[{{{index}}}|↑ {{{indextext|{{PAGENAME}}}}} ↑]] | {{{indextext|{{PAGENAME}}}}}}}'''</td>
<td style="text-align: right; width: 33%">{{#if: {{{nextpage|}}} | [[{{{nextpage}}}|{{{nexttext|{{{nextpage}}}}}} →]] | }}</td>
</tr></table></includeonly><noinclude>

Use this template when you want to provide links to the previous and the next sections of the article so the user isn't forced to go back to the index to navigate.

Arguments

{{Prevnext2 | prevpage = The path of the previous article. | prevtext = The link name for prevpage.* | nextpage = The path to the next article.* | nexttext = The link name for nextpage.* | index = The path to the manual index.* | indextext = The link name for index.* }}

(* - Optional arguments.)

Example usage

Writing this:

{{Prevnext2 | prevpage=path/to/article | nextpage=path/to/article | prevtext=previous section| nexttext=The next section }}

Gets you this:

Example usage: omitting arguments

Writing this:

{{Prevnext2 | nextpage=path/to/article | nexttext=The next section }}

Gets you this:

Writing this:

{{Prevnext2 | prevpage=path/to/article | prevtext=previous section }}

Gets you this:

Example usage: the least amount of typing

Writing this:

{{Prevnext2 | nextpage=path/to/article | prevpage=path/to/lastsection }}

Gets you this:

Example usage: including every argument

Writing this:

{{Prevnext2 | prevpage=path/to/article | nextpage=path/to/article | prevtext=previous section | nexttext=The next section | index= {{PAGENAME}}/Manual | indextext=Contents page }}

Gets you this:

Writing this:

{{Prevnext2 | nextpage=path/to/article | nexttext=The next section | indextext=Contents section }}

Gets you this:

@@ Line 1: / Line 1: @@
+<includeonly><ul class="pager">
+{{#if: {{{prevpage|}}} | <li>[[{{{prevpage}}}|&larr; {{{prevtext|{{{prevpage}}}}}}]]</li> | }}
+<li>'''{{#if: {{{index|}}} | [[{{{index}}}|&uarr; {{{indextext|{{PAGENAME}}}}} &uarr;]] | {{{indextext|{{PAGENAME}}}}}}}'''</li>
+{{#if: {{{nextpage|}}} | <li>[[{{{nextpage}}}|{{{nexttext|{{{nextpage}}}}}} &rarr;]]</li> | }}
+</ul></includeonly><noinclude>
+The old code was
+{{Input|1=<nowiki>
 <includeonly><table align=center id=toc style="width: 95%" class="noprint"><tr>
 <td style="text-align: left; width: 33%">{{#if: {{{prevpage|}}} | [[{{{prevpage}}}|&larr; {{{prevtext|{{{prevpage}}}}}}]] | }}</td>
-<td style="text-align: center; width:   33%">'''{{PAGENAME}}'''</td>
+<td style="text-align: center; width:   33%">'''{{#if: {{{index|}}} | [[{{{index}}}|&uarr; {{{indextext|{{PAGENAME}}}}} &uarr;]] | {{{indextext|{{PAGENAME}}}}}}}'''</td>
-<td style="text-align: right; width: 33%">{{#if: {{{nextpage|}}} | [[{{{nextpage}}}|{{{nexttext|{{{nextpage}}}}}}&rarr;]] | }}</td>
+<td style="text-align: right; width: 33%">{{#if: {{{nextpage|}}} | [[{{{nextpage}}}|{{{nexttext|{{{nextpage}}}}}} &rarr;]] | }}</td>
-</tr></table></includeonly>
+</tr></table></includeonly><noinclude></nowiki>}}
-<noinclude>
+Use this template when you want to provide links to the previous and the next sections of the article so the user isn't forced to go back to the index to navigate.
+== Arguments ==
-{{Template:I18n/Language Navigation Bar|Template:Prevnext}}
+<tt><nowiki>{{Prevnext2</nowiki><br><nowiki>
+| prevpage  = The path of the previous article.</nowiki><br><nowiki>
+| prevtext  = The link name for prevpage.*</nowiki><br><nowiki>
+| nextpage  = The path to the next article.*</nowiki><br><nowiki>
+| nexttext  = The link name for nextpage.*</nowiki><br><nowiki>
+| index     = The path to the manual index.*</nowiki><br><nowiki>
+| indextext = The link name for index.*</nowiki><br><nowiki>
+}}</nowiki></tt>
-Use this template when you want to provide links to the previous and the next sections of the article so the user isn't forced to go back to the index to navigate.
-== How to use this template ==
+(* - Optional arguments.)
-Write
+== Example usage ==
+Writing this:
-<tt>'''<nowiki>{{Prevnext2</nowiki><br><nowiki>
+<br><tt><nowiki>{{Prevnext2</nowiki><br><nowiki>
 | prevpage=path/to/article | nextpage=path/to/article</nowiki><br><nowiki>
 | prevtext=previous section| nexttext=The next section</nowiki><br><nowiki>
-}}</nowiki>'''</tt>
+}}</nowiki></tt><br>
-which will be returned as,
+Gets you this:
+----
 {{Prevnext2
 | prevpage=path/to/article | nextpage=path/to/article
 | prevtext=previous section| nexttext=The next section
 }}
+----
+== Example usage: omitting arguments ==
-Additionally, the arguments in this template are optional. That is, if there is no previous page to link to, you don't have to include it in the template. You can just write this:
+Writing this:
-<tt>'''<nowiki>{{Prevnext2</nowiki><br><nowiki>
+<tt><nowiki>{{Prevnext2</nowiki><br><nowiki>
 | nextpage=path/to/article</nowiki><br><nowiki>
 | nexttext=The next section</nowiki><br><nowiki>
-}}</nowiki>'''</tt>
+}}</nowiki></tt>
-Which would be rendered as:
+Gets you this:
+----
 {{Prevnext2
 | nextpage=path/to/article
 | nexttext=The next section
 }}
+----
-This works the other way around, too. This:
+Writing this:
-<tt>'''<nowiki>{{Prevnext2</nowiki><br><nowiki>
+<tt><nowiki>{{Prevnext2</nowiki><br><nowiki>
-| prevpage=path/to/article </nowiki><br><nowiki>
+| prevpage=path/to/article</nowiki><br><nowiki>
 | prevtext=previous section</nowiki><br><nowiki>
-}}</nowiki>'''</tt>
+}}</nowiki></tt>
-is rendered as:
+Gets you this:
+----
 {{Prevnext2
 | prevpage=path/to/article
 | prevtext=previous section
 }}
+----
-Finally, the link description text doesn't have to be specified, either. The text will default to the name of the article you are linking to. So, the following syntax,
+== Example usage: the least amount of typing ==
+Writing this:
-<tt>'''<nowiki>{{Prevnext2</nowiki><br><nowiki>
+<tt><nowiki>{{Prevnext2</nowiki><br><nowiki>
 | nextpage=path/to/article</nowiki><br><nowiki>
 | prevpage=path/to/lastsection</nowiki><br><nowiki>
-}}</nowiki>'''</tt>
+}}</nowiki></tt>
-will render as:
+Gets you this:
+----
 {{Prevnext2
 | nextpage=path/to/article
 | prevpage=path/to/lastsection
 }}
+----
+== Example usage: including every argument ==
+Writing this:
+<tt><nowiki>{{Prevnext2</nowiki><br><nowiki>
+| prevpage=path/to/article       | nextpage=path/to/article</nowiki><br><nowiki>
+| prevtext=previous section      | nexttext=The next section</nowiki><br><nowiki>
+| index=   {{PAGENAME}}/Manual   | indextext=Contents page</nowiki><br><nowiki>
+}}</nowiki></tt>
+Gets you this:
+----
+{{Prevnext2
+| prevpage=path/to/article     | nextpage=path/to/article
+| prevtext=previous section    | nexttext=The next section
+| index={{PAGENAME}}/Manual    | indextext=Contents page
+}}
+----
+Writing this:
-This might be useful in some situations. But often it looks ugly, so try to specify link text whenever you can!
+<tt><nowiki>{{Prevnext2</nowiki><br><nowiki>
+| nextpage=path/to/article</nowiki><br><nowiki>
+| nexttext=The next section</nowiki><br><nowiki>
+| indextext=Contents section</nowiki><br><nowiki>
+}}</nowiki></tt>
+Gets you this:
+----
+{{Prevnext2
+| nextpage=path/to/article
+| nexttext=The next section
+| indextext=Contents section
+}}
+----
 [[Category:Template]]