Template:Prevnext2: Difference between revisions

From KDE Wiki Sandbox
(avoid little empty box when no prevpage or nextpage is given)
 
(11 intermediate revisions by 2 users not shown)
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>
<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: left; width: 33%">{{#if: {{{prevpage|}}} | [[{{{prevpage}}}|&larr; {{{prevtext|{{{prevpage}}}}}}]] | }}</td>
<td style="text-align: center; width:  33%">'''{{#if: {{{index|}}} | [[{{{index}}}|&uarr; {{{indextext|{{PAGENAME}}}}} &uarr;]] | {{{indextext|{{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><noinclude>{{Template:I18n/Language Navigation Bar|Template:Prevnext}}
</tr></table></includeonly><noinclude></nowiki>}}


{{Info|This template is a work-in-progress and will probably be re-named to something less obtuse quite soon, so avoid using it just at the moment.}}
{{Info|This template is a work-in-progress and will probably be re-named to something less obtuse quite soon, so avoid using it just at the moment.}}
Line 12: Line 20:
== Arguments ==
== Arguments ==


<code>{{Prevnext2
<tt><nowiki>{{Prevnext2</nowiki><br><nowiki>
| prevpage  = The path of the previous article.
| prevpage  = The path of the previous article.</nowiki><br><nowiki>
| prevtext  = The link name for prevpage.*
| prevtext  = The link name for prevpage.*</nowiki><br><nowiki>
| nextpage  = The path to the next article.*
| nextpage  = The path to the next article.*</nowiki><br><nowiki>
| nexttext  = The link name for nextpage.*
| nexttext  = The link name for nextpage.*</nowiki><br><nowiki>
| index    = The path to the manual index.*
| index    = The path to the manual index.*</nowiki><br><nowiki>
| indextext = The link name for index.*
| indextext = The link name for index.*</nowiki><br><nowiki>
}}
}}</nowiki></tt>
</code>
 


(* - Optional arguments.)
(* - Optional arguments.)
Line 26: Line 34:
== Example usage ==
== Example usage ==
Writing this:
Writing this:
<code>{{Prevnext2
 
| prevpage=path/to/article | nextpage=path/to/article
<br><tt><nowiki>{{Prevnext2</nowiki><br><nowiki>
| prevtext=previous section| nexttext=The next section
| prevpage=path/to/article | nextpage=path/to/article</nowiki><br><nowiki>
}}</code>
| prevtext=previous section| nexttext=The next section</nowiki><br><nowiki>
}}</nowiki></tt><br>
 
Gets you this:
Gets you this:
----
----
Line 41: Line 51:


Writing this:
Writing this:
<code>{{Prevnext2
 
| nextpage=path/to/article
<tt><nowiki>{{Prevnext2</nowiki><br><nowiki>
| nexttext=The next section
| nextpage=path/to/article</nowiki><br><nowiki>
}}</code>
| nexttext=The next section</nowiki><br><nowiki>
}}</nowiki></tt>
 
Gets you this:
Gets you this:
----
----
Line 54: Line 66:


Writing this:
Writing this:
<code>{{Prevnext2
 
| prevpage=path/to/article
<tt><nowiki>{{Prevnext2</nowiki><br><nowiki>
| prevtext=previous section
| prevpage=path/to/article</nowiki><br><nowiki>
}}</code>
| prevtext=previous section</nowiki><br><nowiki>
}}</nowiki></tt>
 
Gets you this:
Gets you this:
----
----
{{Prevnext2
{{Prevnext2
| prevpage=path/to/article  
| prevpage=path/to/article
| prevtext=previous section
| prevtext=previous section
}}
}}
Line 68: Line 82:
== Example usage: the least amount of typing ==
== Example usage: the least amount of typing ==
Writing this:
Writing this:
<code>{{Prevnext2
 
| nextpage=path/to/article
<tt><nowiki>{{Prevnext2</nowiki><br><nowiki>
| prevpage=path/to/lastsection
| nextpage=path/to/article</nowiki><br><nowiki>
}}</code>
| prevpage=path/to/lastsection</nowiki><br><nowiki>
}}</nowiki></tt>
 
Gets you this:
Gets you this:
----
----
Line 80: Line 96:
----
----


== Extra options ==
== Example usage: including every argument ==


There are two more completely optional arguments for this template. These replace the text in the middle of the template with a link to wherever you like (most usually the index of the article). To use them, write this:
Writing this:


<code>{{Prevnext2
<tt><nowiki>{{Prevnext2</nowiki><br><nowiki>
| prevpage=path/to/article      | nextpage=path/to/article
| prevpage=path/to/article      | nextpage=path/to/article</nowiki><br><nowiki>
| prevtext=previous section      | nexttext=The next section
| prevtext=previous section      | nexttext=The next section</nowiki><br><nowiki>
| index=  {{PAGENAME}}/Manual  | indextext=Contents page
| index=  {{PAGENAME}}/Manual  | indextext=Contents page</nowiki><br><nowiki>
}}</code>
}}</nowiki></tt>


which will be rendered as:
Gets you this:
----
----
{{Prevnext2
{{Prevnext2
Line 99: Line 115:
----
----


You don't need to use both of them. If you just want to specify the text in the middle without making it a link, simply omit the ''index'' argument completely:
Writing this:


<code>{{Prevnext2
<tt><nowiki>{{Prevnext2</nowiki><br><nowiki>
| nextpage=path/to/article
| nextpage=path/to/article</nowiki><br><nowiki>
| nexttext=The next section
| nexttext=The next section</nowiki><br><nowiki>
| indextext=Contents section
| indextext=Contents section</nowiki><br><nowiki>
}}</code>
}}</nowiki></tt>


Which will be rendered as:
Gets you this:
----
----
{{Prevnext2
{{Prevnext2
Line 116: Line 132:
----
----


== Template source code ==
<code>
<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%">'''{{#if: {{{index|}}} | [[{{{index}}}|&uarr; {{{indextext|{{PAGENAME}}}}} &uarr;]] | {{PAGENAME}}}}'''</td>
<td style="text-align: right; width: 33%">{{#if: {{{nextpage|}}} | [[{{{nextpage}}}|{{{nexttext|{{{nextpage}}}}}}&rarr;]] | }}</td>
</tr></table>
</code>
[[Category:Template]]
[[Category:Template]]

Latest revision as of 08:32, 20 July 2019


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>
Information
This template is a work-in-progress and will probably be re-named to something less obtuse quite soon, so avoid using it just at the moment.


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: