View source for Template:Sec link/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

This is the {{tl|sec link}} template.

It creates a secure link. The link can be local or to any other Wikimedia project. It can for instance link to Wiktionary or the Portuguese Wikipedia. 

Secure links go through the Wikimedia [[Wikipedia:Secure server|secure server]], so they give you an encrypted connection between your browser and the Wikimedia servers.

'''Note!''' For most usage cases you should instead use {{tl|sec link auto}}. That one creates a secure link only if the user is already using the secure server, otherwise it makes a normal link. For other secure link templates see the [[#See also|see also]] section below.

=== Usage ===

<code><nowiki>{{sec link| project | Pagename | text | lang = de }}</nowiki></code>

This templates takes one or more parameters: 
* The first is the prefix of the Wikimedia project you want to link to. For instance "wiktionary" or "wikt" for Wiktionary, and "de" for the German Wikipedia. This parameter must always be fed. For the complete list of prefixes see [[Wikipedia:InterWikimedia links]], [[Special:SiteMatrix]] and {{sec link|meta|List_of_Wikipedias|meta:List of Wikipedias}}.
* The second parameter is the full pagename you want to link to, such as "User:Example" or "São Paulo". If this parameter is omitted then this template links to the main page of the project.
* The third parameter is the text that will be visible as the link. If this parameter is omitted the link address is instead shown.
* There is also a named parameter "lang=". This parameter is usually not used. It takes a language prefix such as "de" or "pt". This enables to link to for instance the German version of Wiktionary. If this parameter is omitted, then this template links to the same language on the other project as you are on here. So if on the English Wikipedia, and you link to Wiktionary, per default you get a link to the English Wiktionary.

Here's some examples:

<pre>
{{sec link| commons }}

{{sec link| wikt }}

{{sec link| de }}

{{sec link| pt }}
</pre>
{{sec link| commons }}

{{sec link| wikt }}

{{sec link| de }}

{{sec link| pt }}

<pre>
{{sec link| commons | São Paulo }}

{{sec link| wikt | São Paulo }}

{{sec link| de | São Paulo }}

{{sec link| pt | São Paulo }}
</pre>
{{sec link| commons | São Paulo }}

{{sec link| wikt | São Paulo }}

{{sec link| de | São Paulo }}

{{sec link| pt | São Paulo }}


<pre>
{{sec link| pt | São Paulo | São Paulo, in the Portuguese Wikipedia. }}
</pre>
{{sec link| pt | São Paulo | São Paulo, in the Portuguese Wikipedia. }}


<pre>
{{sec link| wikt | São Paulo | lang=pt }}

{{sec link| lang=pt | wikt | São Paulo | São Paulo, in the Portuguese Wiktionary. }}
</pre>
{{sec link| wikt | São Paulo | lang=pt }}

{{sec link| lang=pt | wikt | São Paulo | São Paulo, in the Portuguese Wiktionary. }}

In the above example we fed "lang=pt" before the other parameters. That is okay since named parameters don't interfere with the numbering of unnamed parameters.

This template can of course also create a secure link to the same project as it currently is used on. For instance, even if already on the English Wikipedia this works:

<pre>
{{sec link| en | | Secure link to the main page of the English Wikipedia }}
</pre>
{{sec link| en | | Secure link to the main page of the English Wikipedia }}

=== Anchors and queries ===

This template can also handle anchors and query parameters. Like this:

<pre>
{{sec link| en | Template:Sec link | anchor = See also }}

{{sec link| en | Special:Search | query = search=secure+server&fulltext=Search&ns4=1&ns5=1 }}

{{sec link| de | Wikipedia:Spielwiese | query = action=edit | Edit the German Wikipedia's sandbox }}
</pre>

{{sec link| en | Template:Sec link | anchor = See also }}

{{sec link| en | Special:Search | query = search=secure+server&fulltext=Search&ns4=1&ns5=1 }}

{{sec link| de | Wikipedia:Spielwiese | query = action=edit | Edit the German Wikipedia's sandbox }}

When feeding query parameters you must manually change any spaces "<code>&nbsp;</code>" to plus signs "<code>+</code>". But feed anchors unchanged.

=== The padlock ===

The small padlock is automatically added to all https links by the global CSS in all Wikimedia projects. This template does not suppress that, since it makes it clearer it is a secure link. But if you want to suppress the padlock, then there are two ways. Like this:

<pre>
{{sec link| padlock=no | pt | São Paulo }}

<span class="plainlinks">
{{sec link| pt | São Paulo }}
</span>
</pre>

{{sec link| padlock=no | pt | São Paulo }}

<span class="plainlinks">
{{sec link| pt | São Paulo }}
</span>

Using "<code>padlock=no</code>" is easier for a single link. But when having many links then surrounding the whole area with "<code>&lt;span class="plainlinks">&lt;/span></code>" can be more convenient. 

Many templates such as the mboxes, navboxes and infoboxes use the "plainlinks" class since it also prevents the external link icon [[File:External.png|10x10px]]. Thus when this template is used inside such boxes it looses the padlock. Then you can turn on the padlock like this:

<pre>
{{sec link| padlock=yes | pt | São Paulo }}
</pre>
{{sec link| padlock=yes | pt | São Paulo }}

=== Technical details ===

When you are connected to the secure server, then most local links in a project is automatically secure links. But hardcoded links and links to other projects are unfortunately not auto-changed to secure links. With this template you can work around that.

This template doesn't handle the "[[bugzilla:]]" prefix, since it already points to a secure server.

Some languages on Wikisource don't have their own language project, instead they are pages under the main "{{sec link| oldwikisource }}" address. For instance the Afrikaans main page on Wikisourse is not "<code><nowiki>{{sec link|wikisource|lang=af}}</nowiki></code>", but instead "<code><nowiki>{{sec link|oldwikisource|Tuisblad}}</nowiki></code>".

This template internally uses the sub-templates {{tl|sec link/secure url}} and {{tl|sec link/text}}. It also has the sub-templates {{tl|sec link/normal url}} and {{tl|sec link/normal link}}, but they are used by its sister templates such as {{tl|sec link auto}} and {{tl|sec link image}}.

For more technical details see the [[Template talk:Sec link|talk page]].

=== See also ===

{{sec link see also}}

<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Interwiki link templates]]
</includeonly>