http://playground-mw.bitplan.com/index.php?action=history&feed=atom&title=Vorlage%3ALink
Vorlage:Link - Versionsgeschichte
2026-04-07T03:39:44Z
Versionsgeschichte dieser Seite in wiki
MediaWiki 1.39.10
http://playground-mw.bitplan.com/Thanatos/index.php?title=Vorlage:Link&diff=289&oldid=prev
Sysop: pushed from contexts by wikipush
2025-03-05T16:48:03Z
<p>pushed from contexts by wikipush</p>
<p><b>Neue Seite</b></p><div><noinclude><!-- THIS FILE IS PROTECTED - smartGENERATOR WILL NOT OVERWRITE IT -->{{TemplateSequence<br />
|prev=Template:Languagelink<br />
|next=Template:MdiIcon<br />
}}<br />
== template purpose ==<br />
This is a Template for internal and external Links in WikiSon notation.<br />
=== Motivation ===<br />
In Mediawiki there are at least five different ways to use a link - we'd like to hide this complexity and add new functionality:<br />
# <pre>[[Main Page]]</pre>[[Main Page]] - internal link with no text <br />
# <pre>[[Main Page|Start Page]]</pre>[[Main Page|Start Page]] - internal link with text <br />
# <pre>[http://partner.bitplan.com] </pre>[http://partner.bitplan.com] - external link as footnote <br />
# <pre>[http://partner.bitplan.com BITPlan partner site] </pre>[http://partner.bitplan.com BITPlan partner site] - external link with text <br />
# <pre>http://partner.bitplan.com </pre>http://partner.bitplan.com - automatic external link<br />
<br />
== WikiSon Link ==<br />
=== Motivation ===<br />
The Concept behind a link is<br />
<uml><br />
Class Link {<br />
target<br />
title<br />
}<br />
' BITPlan Corporate identity skin params<br />
' Copyright (c) 2015 BITPlan GmbH<br />
' see http://wiki.bitplan.com/PlantUmlSkinParams#BITPlanCI<br />
' skinparams generated by com.bitplan.restmodelmanager<br />
hide Circle<br />
skinparam note{<br />
BackGroundColor #FFFFFF<br />
FontSize 14<br />
ArrowColor #FF8000<br />
BorderColor #FF8000<br />
FontColor black<br />
FontName Technical<br />
}<br />
<br />
skinparam component{<br />
BackGroundColor #FFFFFF<br />
FontSize 14<br />
ArrowColor #FF8000<br />
BorderColor #FF8000<br />
FontColor black<br />
FontName Arial<br />
}<br />
<br />
skinparam package{<br />
BackGroundColor #FFFFFF<br />
FontSize 14<br />
ArrowColor #FF8000<br />
BorderColor #FF8000<br />
FontColor black<br />
FontName Arial<br />
}<br />
<br />
skinparam usecase{<br />
BackGroundColor #FFFFFF<br />
FontSize 14<br />
ArrowColor #FF8000<br />
BorderColor #FF8000<br />
FontColor black<br />
FontName Arial<br />
}<br />
<br />
skinparam activity{<br />
BackGroundColor #FFFFFF<br />
FontSize 14<br />
ArrowColor #FF8000<br />
BorderColor #FF8000<br />
FontColor black<br />
FontName Arial<br />
}<br />
<br />
skinparam classAttribute{<br />
BackGroundColor #FFFFFF<br />
FontSize 14<br />
ArrowColor #FF8000<br />
BorderColor #FF8000<br />
FontColor black<br />
FontName Technical<br />
}<br />
<br />
skinparam interface{<br />
BackGroundColor #FFFFFF<br />
FontSize 14<br />
ArrowColor #FF8000<br />
BorderColor #FF8000<br />
FontColor black<br />
FontName Arial<br />
}<br />
<br />
skinparam class{<br />
BackGroundColor #FFFFFF<br />
FontSize 14<br />
ArrowColor #FF8000<br />
BorderColor #FF8000<br />
FontColor black<br />
FontName Technical<br />
}<br />
</uml><br />
This calls for the WikiSon notation <br />
<pre><br />
{{Link<br />
|target=sometarget<br />
|title=sometitle<br />
}}<br />
</pre><br />
<br />
=== Link as WikiSon ===<br />
Using the WikiSon Concept approach the Link Concept is represented via<br />
the Wiki [[:Category:Link]]<br><br />
Especially there is a [[List of Links]] page available.<br />
<br />
Properties set:<br />
* {{Link|target=Property:Link targetUrl}}<br />
<br />
=== Examples ===<br />
<pre><br />
{{Link}}<br />
</pre><br />
internal default link to Main Page<br />
{{Link}}<br />
<pre><br />
{{Link|target=Main Page}}<br />
</pre><br />
internal link to Main Page<br />
{{Link|target=Main Page}}<br />
<pre><br />
{{Link|target=Main Page|title=Main Page}}<br />
</pre><br />
internal link to Main Page with title<br />
{{Link|target=Main Page|title=Main Page}}<br />
<br />
<pre><br />
{{Link|target=http://partner.bitplan.com}}<br />
</pre><br />
external link<br />
{{Link|target=http://partner.bitplan.com}}<br />
<br />
<pre><br />
{{Link|target=http://partner.bitplan.com|title=BITPlan Partner wiki}}<br />
</pre><br />
external link with title<br />
{{Link|target=http://partner.bitplan.com|title=BITPlan Partner wiki}}<br />
<br />
=== implementation ===<br />
==== Prerequisite ====<br />
LocalSettings.php needs to have the StringFunctions enabled:<br />
<source lang='php'><br />
# WF 2015-01-20<br />
# allow string functions<br />
$wgPFEnableStringFunctions=true;<br />
</source><br />
<br />
==== Template source ====<br />
The complexity of this template macro needs to be hidden<br />
===== original Link Template =====<br />
<pre><br />
{{#set:Link target={{{target|}}}<br />
|Link title={{{title|}}}<br />
}}{{#ifeq: <br />
{{#sub:{{{target|}}}|0|4}} <br />
| http | {{#set:Link targetUrl={{{target|}}}}}{{#if: {{{title|}}} <br />
| [{{{target|http://www.smartMediaWiki.com}}} {{{title}}}] <br />
| [{{{target|http://www.smartMediaWiki.com}}}] <br />
}}| {{#set:Link targetPage={{{target|}}}}}{{#if: {{{title|}}} <br />
| [[{{{target|Main Page}}}|{{{title}}}]] <br />
| [[{{{target|Main Page}}}]]<br />
}}}}[[Category:Link]]<br />
</pre><br />
===== pretty printed Template macro =====<br />
this version would unfortunately create unwanted newlines in the macro result<br />
<source lang='html4strict'><br />
<!-- set concept attributes target (mandatory) and title (optional) --><br />
{{#set:Link target={{{target|}}}<br />
|Link title={{{title|}}}<br />
}}<br />
<!-- check whether link is external or internal by comparing the firsts 4 chars with "http" --><br />
{{#ifeq: <br />
{{#sub:{{{target|}}}|0|4}} <br />
<br />
| http <br />
<br />
| <!-- in the http case (external link) set the targetURL property - it has the type "URL" and not "Text" like target or "Page" like targetPage --><br />
{{#set:Link targetUrl={{{target|}}}}}<br />
<br />
<!-- display external link with our without title --><br />
{{#if: {{{title|}}} <br />
| [{{{target|http://www.smartMediaWiki.com}}} {{{title}}}] <br />
| [{{{target|http://www.smartMediaWiki.com}}}] <br />
}}<br />
<br />
| <!-- in the non-http case (internal link) set the targetPage property - it has the type "Page" and not "Text" like target or "Url" like targetUrl --><br />
{{#set:Link targetPage={{{target|}}}}}<br />
<br />
<!-- display internal link with our without title --><br />
{{#if: {{{title|}}} <br />
| [[{{{target|Main Page}}}|{{{title}}}]] <br />
| [[{{{target|Main Page}}}]]<br />
}}<br />
}}<br />
<!-- set the Category so that any page using this is displayed in this category --><br />
[[Category:Link]]<br />
</source><br />
<br />
==== How the Link Macro works ====<br />
The Link Macro checks whether the link is external or internal and displays the correct version. It sets the Link Concept's attributes by setting the correspond Semantic Media Wiki properties.<br />
it uses the following helper funcitons:<br />
<br />
* Substring: https://www.mediawiki.org/wiki/Extension:StringFunctions/en#.23sub:<br />
* #ifeq: https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions/en#.23ifeq<br />
* #if: https://www.mediawiki.org/wiki/Help:Extension:ParserFunctions/en#.23if<br />
* #set: https://semantic-mediawiki.org/wiki/Help:Setting_values<br />
===== Substring =====<br />
<pre><br />
{{#sub:string|start|length}}<br />
<br />
The start parameter, if positive (or zero), specifies a zero-based index of the first character to be returned.<br />
<br />
Example: {{#sub:Icecream|3}} returns cream.<br />
<br />
{{#sub:Icecream|0|3}} returns Ice.<br />
</pre><br />
<br />
===== if exists and non empty =====<br />
<pre><br />
{{#if: test string | value if test string is not empty | value if test string is empty (or only white space) }}<br />
</pre><br />
<br />
===== if equals =====<br />
<pre><br />
{{#ifeq: string 1 | string 2 | value if identical | value if different }}<br />
</pre><br />
===== setting Semantic values =====<br />
<pre><br />
{{#set:Has population=2,234,105<br />
|Located in country=France<br />
|Has mayor=Bertrand Delanoë<br />
}}<br />
</pre><br />
=== Properties set ===<br />
# {{Link|target=Property:Link_target}}<br />
# {{Link|target=Property:Link_targetPage}}<br />
# {{Link|target=Property:Link_targetUrl}}<br />
# {{Link|target=Property:Link_title}}<br />
[[Categorie:Link]]<br />
[[Category:Template]]{{NeededFor|ProfiWiki}}</noinclude><includeonly>{{#set:Link target={{{target|}}}<br />
|Link title={{{title|}}}<br />
}}{{#ifeq: <br />
{{#sub:{{{target|}}}|0|4}} <br />
| http | {{#set:Link targetUrl={{{target|}}}}}{{#if: {{{title|}}} <br />
| [{{{target|http://www.smartMediaWiki.com}}} {{{title}}}] <br />
| [{{{target|http://www.smartMediaWiki.com}}}] <br />
}}| {{#set:Link targetPage={{{target|}}}}}{{#if: {{{title|}}} <br />
| [[{{{target|Main Page}}}|{{{title}}}]] <br />
| [[{{{target|Main Page}}}]]<br />
}}}}</includeonly></div>
Sysop