Template:Plain link/doc

From TrainzOnline
< Template:Plain link(Difference between revisions)
Jump to: navigation, search
m (tweak usage)
(Examples: tweak)
 
(2 intermediate revisions by one user not shown)
Line 1: Line 1:
 
<noinclude>{{Documentation subpage}}
 
<noinclude>{{Documentation subpage}}
</noinclude>
+
</noinclude><includeonly>{{Usage-style}}</includeonly>
 
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
 
<!-- EDIT TEMPLATE DOCUMENTATION BELOW THIS LINE -->
 
;Purpose of {{Lts|{{BASEPAGENAME}}}}
 
;Purpose of {{Lts|{{BASEPAGENAME}}}}
Line 14: Line 14:
 
--->
 
--->
 
You can use  {{Plain link|MW|magicword}} to generate URLs to Wikipedia pages.
 
You can use  {{Plain link|MW|magicword}} to generate URLs to Wikipedia pages.
 +
==Pass parameters==
 +
__NOTOC__
 +
Arguments or ''''positional/default pass parameters'''' are separated by the pipe character in Wiki markup language, so the first default parameter (placeholder is <nowiki> {{{1}}}</nowiki>) is assigned the link url address. The second (<nowiki> {{{2}}}</nowiki>) is the 'pretty text' for how you want to have it appear.
 +
# ''''|1='''' is the same as ''''| url = '''' (or in wiki template code: <nowiki> {{{1}}}</nowiki> = <nowiki> {{{url}}}</nowiki>)
 +
# ''''|2='''' is the same as ''''|name='''' (or in wiki template code: <nowiki> {{{2}}}</nowiki> = <nowiki> {{name}}}</nowiki>)
  
 
==Examples==
 
==Examples==
<!--
+
<big><!--
*<code><nowiki>{{Plain link|url=//www.wikipedia.org}}</nowiki></code> gives {{Plain link|url=//www.wikipedia.org}}
+
* <code><nowiki>{{Plain link|url=//www.wikipedia.org}}</nowiki></code> gives {{Plain link|url=//www.wikipedia.org}}
*<code><nowiki>{{Plain link|//www.wikipedia.org Wikipedia}}</nowiki></code> gives {{Plain link|//www.wikipedia.org Wikipedia}}
+
* <code><nowiki>{{Plain link|//www.wikipedia.org Wikipedia}}</nowiki></code> gives {{Plain link|//www.wikipedia.org Wikipedia}}
*<code><nowiki>{{Plain link|//www.wikipedia.org | Wikipedia}}</nowiki></code> gives {{Plain link|//www.wikipedia.org|Wikipedia}} -->
+
* <code><nowiki>{{Plain link|//www.wikipedia.org | Wikipedia}}</nowiki></code> gives {{Plain link|//www.wikipedia.org|Wikipedia}} -->
*<code><nowiki>{{Plain link|http://www.google.co.uk|Google}}</nowiki></code> gives {{Plain link|http://www.google.co.uk|Google}}
+
* <code><nowiki>{{Plain link|http://www.google.co.uk|Google}}</nowiki></code> gives <code> {{Plain link|http://www.google.co.uk|Google}} </code>
 +
:: compare normal external wiki-link:
 +
* <code><nowiki>[http://www.google.co.uk Google]</nowiki></code> gives <code> [http://www.google.co.uk Google] </code>
 +
</big>
  
 +
==Caution on url insides==
 
Note that if your url or link title contains an equals sign <code>=</code> you must use named parameters:
 
Note that if your url or link title contains an equals sign <code>=</code> you must use named parameters:
 
*<code><nowiki>{{ Plainlink | url=http://en.wikipedia.org/w/index.php?title=Equals_sign&oldid=282228764 | name="this edit" }}</nowiki></code> gives {{Plain link|url=http://en.wikipedia.org/w/index.php?title=Equals_sign&oldid=282228764 |name="this edit"}}
 
*<code><nowiki>{{ Plainlink | url=http://en.wikipedia.org/w/index.php?title=Equals_sign&oldid=282228764 | name="this edit" }}</nowiki></code> gives {{Plain link|url=http://en.wikipedia.org/w/index.php?title=Equals_sign&oldid=282228764 |name="this edit"}}
 +
whereas
 +
*<code><nowiki>{{Plain link|http://forums.auran.com/trainz/showthread.php?14511-Having-Problems-with-Multiple-industry-New-Setup&highlight=%26lt%3Bkuid%3A107727%3A100012%26gt%3B |Having Problems}}</nowiki></code> gives <br
 +
/>{{Plain link|http://forums.auran.com/trainz/showthread.php?14511-Having-Problems-with-Multiple-industry-New-Setup&highlight=%26lt%3Bkuid%3A107727%3A100012%26gt%3B |Having Problems}} ''''which link-to-be'... is ''clearly broken'' with a mal-formed url due to the internal equals sign''', ''whilst:
 +
*<code><nowiki>{{Plain link|url=http://forums.auran.com/trainz/showthread.php?14511-Having-Problems-with-Multiple-industry-New-Setup&highlight=%26lt%3Bkuid%3A107727%3A100012%26gt%3B |2=Having Problems}}</nowiki></code> gives {{Plain link|url=http://forums.auran.com/trainz/showthread.php?14511-Having-Problems-with-Multiple-industry-New-Setup&highlight=%26lt%3Bkuid%3A107727%3A100012%26gt%3B |2=Having Problems}}'' works the same as if default parameter ''''|1='''' and ''''|name='''' are defined, since url is just an alternative that is a bit more explicit to <nowiki> {{{1}}}, and the default parameter {{{2}}}</nowiki> is used (mapped) the same as the ''''|name='''' parameter.
 
<!--
 
<!--
 
To be more concise, you can use <code><nowiki>{{scp}}</nowiki></code> and numbers as parameter names e.g.
 
To be more concise, you can use <code><nowiki>{{scp}}</nowiki></code> and numbers as parameter names e.g.

Latest revision as of 08:58, 18 November 2013



 
It contains usage information, categories and other informational content that is best arranged so that it is not part of the original template page, such as in many cases, examples of how to use the template in question.
  • Documentation subpages were developed to reduce server demands, or to protect the code version of widely used templates.
     

Purpose of Template:Plain link (edit talk links history)
  • Create a 'Pretty-Print' external url link inside text.

[edit] Caution

You can use [MW magicword] to generate URLs to Wikipedia pages.

[edit] Pass parameters

Arguments or 'positional/default pass parameters' are separated by the pipe character in Wiki markup language, so the first default parameter (placeholder is {{{1}}}) is assigned the link url address. The second ( {{{2}}}) is the 'pretty text' for how you want to have it appear.

  1. '|1=' is the same as '| url = ' (or in wiki template code: {{{1}}} = {{{url}}})
  2. '|2=' is the same as '|name=' (or in wiki template code: {{{2}}} = {{name}}})

[edit] Examples

  • {{Plain link|http://www.google.co.uk|Google}} gives Google
compare normal external wiki-link:
  • [http://www.google.co.uk Google] gives Google

[edit] Caution on url insides

Note that if your url or link title contains an equals sign = you must use named parameters:

  • {{ Plainlink | url=http://en.wikipedia.org/w/index.php?title=Equals_sign&oldid=282228764 | name="this edit" }} gives "this edit"

whereas

  • {{Plain link|http://forums.auran.com/trainz/showthread.php?14511-Having-Problems-with-Multiple-industry-New-Setup&highlight=%26lt%3Bkuid%3A107727%3A100012%26gt%3B |Having Problems}} gives
    [Having Problems ] 'which link-to-be'... is clearly broken with a mal-formed url due to the internal equals sign, whilst:
  • {{Plain link|url=http://forums.auran.com/trainz/showthread.php?14511-Having-Problems-with-Multiple-industry-New-Setup&highlight=%26lt%3Bkuid%3A107727%3A100012%26gt%3B |2=Having Problems}} gives Having Problems works the same as if default parameter '|1=' and '|name=' are defined, since url is just an alternative that is a bit more explicit to {{{1}}}, and the default parameter {{{2}}} is used (mapped) the same as the '|name=' parameter.
Personal tools