Template:External: Difference between revisions

From railML 2 Wiki
Jump to navigation Jump to search
[checked revision][checked revision]
No edit summary
No edit summary
(39 intermediate revisions by the same user not shown)
Line 1: Line 1:
<includeonly>[{{{1}}} {{#if:{{{2|}}}|{{{2}}}|{{#if:{{{text|}}}|{{{text}}}|{{{1}}}}}}}] ''(external link{{#if:{{{type|}}}|;&nbsp;{{{type}}}}}{{#if:{{{lang|}}}|;&nbsp;{{{lang}}}}})''[[kategorie:External Link]]</includeonly><noinclude>
<includeonly>{{#switch:{{#sub:{{{1}}}|0|17}}
|http://www.w3.org
|https://www.w3.or=[{{{1}}} {{#if:{{{2|}}}|{{{2}}}|{{#if:{{{text|}}}|{{{text}}}|{{{1}}}}}}}]{{#if:{{{date|}}}|&nbsp;''(|{{#if:{{{type|}}}|&nbsp;''(|{{#if:{{{lang|}}}|&nbsp;''(|{{#if:{{{visited|}}}|&nbsp;''(|{{#if:{{{comment|}}}|&nbsp;''(}}}}}}}}}}{{#sub:{{#if:{{{date|}}}|,&nbsp;{{{date}}}}}{{#if:{{{type|}}}|,&nbsp;{{{type}}}}}{{#if:{{{lang|}}}|,&nbsp;{{flag|{{{lang}}}}}}}{{#if:{{{size|}}}|,&nbsp;size: {{{size}}}}}{{#if:{{{visited|}}}|,&nbsp;visited on {{{visited}}}}}{{#if:{{{comment|}}}|,&nbsp;{{{comment}}}}}|7}}{{#if:{{{date|}}}|)''|{{#if:{{{type|}}}|)''|{{#if:{{{lang|}}}|)''|{{#if:{{{visited|}}}|)''|{{#if:{{{comment|}}}|)''}}}}}}}}}}
|#default=[{{{1}}} {{#if:{{{2|}}}|{{{2}}}|{{#if:{{{text|}}}|{{{text}}}|{{{1}}}}}}}] ''({{#if:{{{inlang|}}}|{{#switch:{{{inlang}}}|de=externer Link|fr=lien externe|#default=external link}}|external link}}{{#if:{{{date|}}}|,&nbsp;{{{date}}}}}{{#if:{{{type|}}}|,&nbsp;{{{type}}}}}{{#if:{{{lang|}}}|,&nbsp;{{flag|{{{lang}}}}}}}{{#if:{{{size|}}}|,&nbsp;size: {{{size}}}}}{{#if:{{{visited|}}}|,&nbsp;visited on {{{visited}}}}}{{#if:{{{comment|}}}|<nowiki>;</nowiki>&nbsp;{{{comment}}}}})''}}[[category:External Link]]</includeonly><noinclude>
==Usage==
==Usage==
Use this template, whenever you set external links.
The template can be used to mark external links.


This template grants that external links will be collected in [[:category:External Link]]. So we keep an overview of external links and control their actuality routinely.
This template grants that external links will be collected in [[:category:External Link]]. So we keep an overview of external links and control their actuality routinely.


For Links to pages on the railML<sup>®</sup> ([http://railml.org http://railml.org]), please use [[Template:Site]].
For Links to pages on the {{rml}}-site ([http://railml.org http://railml.org]), please use [[Template:Site]].
===Options===
The template has an obligatory and an optional argument:
* The first, obligatory, argument is the link target
* The second, optional argument is the link text. If it is empty, the link target will be used as link text.


==Examples==
Please, consider, that the template contains an exception for links to the World Wide Web Consortium (W3C), as there are too many links to W3C data types — we want to avoid the reading flow being disturbed.
<nowiki>{{external|http://uic.org}}</nowiki>
===Dependencies===
{{note|The template requires the extension ''StringFunctions'', comp. {{external|https://www.mediawiki.org/wiki/Extension:StringFunctions}}.}}
===Arguments===
The template has an obligatory and five optional argument:
*Obligatory; unnamed
**'''1''': the link target, e.g. http://uic.org<br>'''Notice:''' the mediawiki software will misinterpret URLs containing the equality sign (=). Replace equality signs in URLs with the HTML-entity &amp;#61;.<br>''Example:'' replace <nowiki>{{external|http://www.railml.org/forum/index.php?t=msg&th=469&start=0&}}</nowiki> with <nowiki>{{external|http://www.railml.org/forum/index.php?t&amp;#61;msg&th&amp;#61;469&start&amp;#61;0&}}</nowiki> as to display [http://www.railml.org/forum/index.php?t&#61;msg&th&#61;469&start&#61;0& http://www.railml.org/forum/index.php?t&#61;msg&th&#61;469&start&#61;0&] ''(external link)''
*Optional
**'''2''' or ''text'': the link text. If it is empty, the link target will be used as link text. This argument can be used both named or unnamed.
**''date'': the publication date of the file
**''type'': the file type, e.g. PDF
**''lang'': the language of the link target file, e.g. EN. For EN, FR, DE, NL, NO, CZ and ES a flag will be displayed. In all other cases the input string will be returned.
**''size'': the file size — use only for very big files beyond 25 M!
**''visited'': the date when the file was visited
**''inlang'': en (=default), de or fr for a notice in the language of the context
**''comment'': anything that does not fit into the other parameters; a string to be displayed directly


delivers
If the second argument is unnamed (example: <nowiki>{{external|http://example.ex|some example text}}</nowiki>), it will be interpreted as link text. If the second argument is named (example:<nowiki>{{external|http://example.ex|type=some file format}}</nowiki>), it will be interpreted according to the argument name.


[http://uic.org http://uic.org] ''(external link)''
==Examples==
 
{|border="1"
<nowiki>{{external|http://uic.org|UIC homepage}}</nowiki>
|'''Code'''
 
|'''Output'''
delivers
|-
 
|<nowiki>{{external|http://www.uic.org}}</nowiki>
[http://uic.org UIC homepage] ''(external link)''
|{{external|http://www.uic.org}}
|-
|<nowiki>{{external|http://www.uic.org|International Union of Railways}}</nowiki>
|{{external|http://www.uic.org|International Union of Railways}}
|-
|<nowiki>{{external|http://www.uic.org|type=HTML}}</nowiki>
|{{external|http://www.uic.org|type=HTML}}
|-
|<nowiki>{{external|http://www.uic.org|lang=EN|text=UIC}}</nowiki>
|{{external|http://www.uic.org|lang=EN|text=UIC}}
|-
|<nowiki>{{external|http://www.uic.org|UIC|type=HTML|lang=EN}}</nowiki>
|{{external|http://www.uic.org|UIC|type=HTML|lang=EN}}
|-
|<nowiki>{{external|https://www.w3.org/TR/xmlschema-2/#language}}</nowiki>
|{{external|https://www.w3.org/TR/xmlschema-2/#language}}
|}


[[kategorie:ContentTemplate]]
[[category:LinkTemplate]]
</noinclude>
</noinclude>

Revision as of 15:56, 27 February 2020

Usage

The template can be used to mark external links.

This template grants that external links will be collected in category:External Link. So we keep an overview of external links and control their actuality routinely.

For Links to pages on the railML®-site (http://railml.org), please use Template:Site.

Please, consider, that the template contains an exception for links to the World Wide Web Consortium (W3C), as there are too many links to W3C data types — we want to avoid the reading flow being disturbed.

Dependencies

🗒️ The template requires the extension StringFunctions, comp. https://www.mediawiki.org/wiki/Extension:StringFunctions (external link).

Arguments

The template has an obligatory and five optional argument:

  • Obligatory; unnamed
    • 1: the link target, e.g. http://uic.org
      Notice: the mediawiki software will misinterpret URLs containing the equality sign (=). Replace equality signs in URLs with the HTML-entity &#61;.
      Example: replace {{external|http://www.railml.org/forum/index.php?t=msg&th=469&start=0&}} with {{external|http://www.railml.org/forum/index.php?t&#61;msg&th&#61;469&start&#61;0&}} as to display http://www.railml.org/forum/index.php?t=msg&th=469&start=0& (external link)
  • Optional
    • 2 or text: the link text. If it is empty, the link target will be used as link text. This argument can be used both named or unnamed.
    • date: the publication date of the file
    • type: the file type, e.g. PDF
    • lang: the language of the link target file, e.g. EN. For EN, FR, DE, NL, NO, CZ and ES a flag will be displayed. In all other cases the input string will be returned.
    • size: the file size — use only for very big files beyond 25 M!
    • visited: the date when the file was visited
    • inlang: en (=default), de or fr for a notice in the language of the context
    • comment: anything that does not fit into the other parameters; a string to be displayed directly

If the second argument is unnamed (example: {{external|http://example.ex|some example text}}), it will be interpreted as link text. If the second argument is named (example:{{external|http://example.ex|type=some file format}}), it will be interpreted according to the argument name.

Examples

Code Output
{{external|http://www.uic.org}} http://www.uic.org (external link)
{{external|http://www.uic.org|International Union of Railways}} International Union of Railways (external link)
{{external|http://www.uic.org|type=HTML}} http://www.uic.org (external link, HTML)
{{external|http://www.uic.org|lang=EN|text=UIC}} UIC (external link, UK flag.png)
{{external|http://www.uic.org|UIC|type=HTML|lang=EN}} UIC (external link, HTML, UK flag.png)
{{external|https://www.w3.org/TR/xmlschema-2/#language}} https://www.w3.org/TR/xmlschema-2/#language