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
(44 intermediate revisions by the same user not shown)
Line 1: Line 1:
<includeonly>[[{{{1}}} {{#if:{{{2|}}}|{{{2}}}|{{{1}}}}}]] ''(external link)''[[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.
===Options===
 
The template has an obligatory and an optional argument:
For Links to pages on the {{rml}}-site ([http://railml.org http://railml.org]), please use [[Template:Site]].
* 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.
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.
[[kategorie:ContentTemplate]]
===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
 
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.
 
==Examples==
{|border="1"
|'''Code'''
|'''Output'''
|-
|<nowiki>{{external|http://www.uic.org}}</nowiki>
|{{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}}
|}
 
[[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