View source for Template:External

<includeonly><noinclude>
var:link soll dem Archivlink entsprechen so vorhanden, und sonst {{{1}}}; Verlinkt wird der Archivlink, gezeigt aber {{{1}}}
</noinclude>{{#vardefine:link|{{#if:{{{archive|}}}|{{{archive}}}|{{{1}}}}}}}<noinclude>
Mode: silent or not?
</noinclude>{{#switch:{{{mode}}}
|silent=[{{#var:link}} {{#if:{{{2|}}}|{{{2}}}|{{#if:{{{text|}}}|{{{text}}}|{{{1}}}}}}}]
|#default={{#switch:{{#sub:{{{1}}}|0|17}}
|https://www.w3.org
|https://www.w3.or=[{{#var:link}} {{#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;{{lang|{{{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=[{{#var:link}} {{#if:{{{2|}}}|{{{2}}}|{{#if:{{{text|}}}|{{{text}}}|{{{1}}}}}}}] ''({{#if:{{{inlang|}}}|{{#switch:{{{inlang}}}|de=externer {{#if:{{{archive|}}}|Archiv-}}Link|fr=lien externe|#default=external&#32;{{#if:{{{archive|}}}|archive&#32;}}link}}|external&#32;{{#if:{{{archive|}}}|archive&#32;}}link}}{{#if:{{{date|}}}|,&nbsp;{{{date}}}}}{{#if:{{{type|}}}|,&nbsp;{{{type}}}}}{{#if:{{{lang|}}}|,&nbsp;{{lang|{{{lang}}}}}}}{{#if:{{{size|}}}|,&nbsp;size: {{{size}}}}}{{#if:{{{visited|}}}|,&nbsp;visited on {{{visited}}}}}{{#if:{{{comment|}}}|<nowiki>;</nowiki>&nbsp;{{{comment}}}}})''}}}}[[category:External Link]]</includeonly><noinclude>
==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 {{rml}}-site ({{site|https://railml.org|mode=silent|inline=1}}), 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.
{{note|An outline on Citations and References within the {{rml}} wikis can be found '''[[Dev:Wiki_Documentation_Guidelines#Citations_and_References|here]]'''.}}
===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. https://uic.org. '''Please, recognize [[#note|the note below]].'''
{{note|{{anchor|note}}If the content of the unnamed arguments contains equality signs this can easily result in errors.
;example
<nowiki>{{site|https://www.railml.org/forum/index.php?t=msg&goto=71&|Heidrun Jost BaliseGroup and its attributes railML forum post}}<nowiki />}}</nowiki><br>results in:<br>{{site|https://www.railml.org/forum/index.php?t=msg&goto=71&|Heidrun Jost BaliseGroup and its attributes railML forum post}}<nowiki />

There are two remedies:
*Either make the argument number explicit:<br><nowiki>{{site|1=https://www.railml.org/forum/index.php?t=msg&goto=71&|2=Heidrun Jost BaliseGroup and its attributes railML forum post}}</nowiki>
*Or escape all equality signs via {{wikipedia|url encoding}} in the first argument and with {{wikipedia|HTML entities}} in the second argument:<br><nowiki>{{site|https://www.railml.org/forum/index.php?t%3Dmsg&goto%3D71&|Heidrun Jost BaliseGroup and its attributes railML forum post}}</nowiki>|reminder}}
*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. '''Please, recognize [[#note|the note above]].'''
**''archive'': Provide an archive link in case the source is no longer available. On default, the original URL (argument '''1''') be displayed and the archive URL will be linked.
**''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
**''mode'': if mode=silent, the link will not be commented.
**''inline'': dummyargument. Set inline=1 whenever you employ the template outside <<nowiki />ref> tags to show that this is on purpose not in a footnote.

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

==Examples==
{|border="1"
|'''Code'''
|'''Output'''
|-
|<nowiki>{{external|https://www.uic.org}}</nowiki>
|{{external|https://www.uic.org}}
|-
|<nowiki>{{external|https://www.uic.org|International Union of Railways}}</nowiki>
|{{external|https://www.uic.org|International Union of Railways}}
|-
|<nowiki>{{external|https://www.uic.org|type=HTML}}</nowiki>
|{{external|https://www.uic.org|type=HTML}}
|-
|<nowiki>{{external|https://www.uic.org|lang=EN|text=UIC}}</nowiki>
|{{external|https://www.uic.org|lang=EN|text=UIC}}
|-
|<nowiki>{{external|https://www.uic.org|UIC|type=HTML|lang=EN}}</nowiki>
|{{external|https://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}}
|-
|<nowiki>{{external|https://railml.org|mode=silent}}</nowiki>
|{{external|https://railml.org|mode=silent}}
|-
|<nowiki>{{external|https://railml.org|{{rml}} site|mode=silent}}</nowiki>
|{{external|https://railml.org|{{rml}} site|mode=silent}}
|-
|<nowiki>{{external|http://www.railml.org/en/index-en.shtml|archive=https://web.archive.org/web/20030527011905/http://www.railml.org/en/index-en.shtml}}</nowiki>
|{{external|http://www.railml.org/en/index-en.shtml|archive=https://web.archive.org/web/20030527011905/http://www.railml.org/en/index-en.shtml}}
|}

[[category:LinkTemplate]]

{{interwiki}}
</noinclude>