Difference between revisions of "Template:Delink/doc"
Jump to navigation
Jump to search
test>SamB (Highlight that it doesn't work on bare URLs) |
test>A876 (+,. to https;.) |
||
Line 3: | Line 3: | ||
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. --> | <!-- Categories go at the bottom of this page and interwikis go in Wikidata. --> | ||
− | {{High-use|800,000+|all-pages = yes}} | + | {{High-use|800,000+|all-pages=yes}} |
− | This template removes links from wikitext. It de-links wikilinks | + | This template removes links from wikitext. It de-links wikilinks and URL links, removes HTML comments, and normalises whitespace. It handles most wikitext correctly, including category links, the [[Help:Colon trick|colon trick]], the [[Help:Pipe trick|pipe trick]] (normal and reverse), nested wikilinks, and invalid link characters. |
− | |||
− | |||
+ | ==Usage== | ||
; Basic | ; Basic | ||
Line 17: | Line 16: | ||
<pre> | <pre> | ||
{{delink | {{delink | ||
− | | 1 = | + | | 1 = |
| wikilinks = no | | wikilinks = no | ||
| urls = no | | urls = no | ||
Line 26: | Line 25: | ||
</pre> | </pre> | ||
− | == Parameters == | + | ==Parameters== |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | *<code>1</code> - the text to be de-linked. | |
+ | *<code>wikilinks</code> - if set to "no", "n", "false", or "0", wikilinks are not de-linked. | ||
+ | *<code>urls</code> - if set to "no", "n", "false", or "0", URL links are not de-linked. | ||
+ | *<code>comments</code> - if set to "no", "n", "false", or "0", HTML comments are not removed. | ||
+ | *<code>whitespace</code> - if set to "no", "n", "false", or "0", whitespace is not normalised. The normalisation makes the whitespace of the resulting text look as if it had been put through the MediaWiki parser. For example, single newlines are converted to a single space, but double newlines are left alone. | ||
+ | *<code>refs</code> - (experimental) if set to "yes", "y", "true", or "1", removes references. This is not recommended, as only the <sup>[1]</sup>, <sup>[2]</sup>, etc. markers will be removed - the references themselves will still appear at the end of the page. There is no known workaround for this problem as of April 2014. | ||
+ | ==Examples== | ||
{| class="wikitable" | {| class="wikitable" | ||
! Code | ! Code | ||
Line 47: | Line 45: | ||
| {{delink|[[Foo|Bar]]}} | | {{delink|[[Foo|Bar]]}} | ||
|- | |- | ||
− | | <code><nowiki>{{delink|[[Foo]], [[bar]] and [[baz]].}}</nowiki></code> | + | | <code><nowiki>{{delink|[[Foo]], [[bar]], and [[baz]].}}</nowiki></code> |
− | | {{delink|[[Foo]], [[bar]] and [[baz]].}} | + | | {{delink|[[Foo]], [[bar]], and [[baz]].}} |
|- | |- | ||
− | | <code><nowiki>{{delink|I visited [ | + | | <code><nowiki>{{delink|I visited [https://www.example.com example.com].}}</nowiki></code> |
− | | {{delink|I visited [ | + | | {{delink|I visited [https://www.example.com example.com].}} |
|- | |- | ||
| <code><nowiki>{{delink|Foo}}</nowiki></code> | | <code><nowiki>{{delink|Foo}}</nowiki></code> | ||
Line 61: | Line 59: | ||
}}</includeonly> | }}</includeonly> | ||
− | |||
− | |||
+ | ==Non-examples== | ||
{| class="wikitable" | {| class="wikitable" | ||
! Code | ! Code | ||
! Output | ! Output | ||
|- | |- | ||
− | | <code><nowiki>{{delink| | + | | <code><nowiki>{{delink|https://www.example.com}}</nowiki></code> |
− | | {{delink| | + | | {{delink|https://www.example.com}} |
|} | |} | ||
Line 75: | Line 72: | ||
*{{tl|trim brackets}} | *{{tl|trim brackets}} | ||
*{{tl|delink question hyphen-minus}} | *{{tl|delink question hyphen-minus}} | ||
− | {{String-handling templates |delink}} | + | |
+ | {{String-handling templates|delink}} |
Revision as of 06:52, 10 December 2019
![]() | This is a documentation subpage for Template:Delink. It contains usage information, categories and other content that is not part of the original template page. |
![]() | This template uses Lua: |
![]() | This template is used on 1,480,000+ pages, or roughly 368% of all pages. To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them. Transclusion count updated automatically (see documentation). |
This template removes links from wikitext. It de-links wikilinks and URL links, removes HTML comments, and normalises whitespace. It handles most wikitext correctly, including category links, the colon trick, the pipe trick (normal and reverse), nested wikilinks, and invalid link characters.
Usage
- Basic
{{delink|text}}
- All parameters
{{delink | 1 = | wikilinks = no | urls = no | comments = no | whitespace = no | refs = yes }}
Parameters
1
- the text to be de-linked.wikilinks
- if set to "no", "n", "false", or "0", wikilinks are not de-linked.urls
- if set to "no", "n", "false", or "0", URL links are not de-linked.comments
- if set to "no", "n", "false", or "0", HTML comments are not removed.whitespace
- if set to "no", "n", "false", or "0", whitespace is not normalised. The normalisation makes the whitespace of the resulting text look as if it had been put through the MediaWiki parser. For example, single newlines are converted to a single space, but double newlines are left alone.refs
- (experimental) if set to "yes", "y", "true", or "1", removes references. This is not recommended, as only the [1], [2], etc. markers will be removed - the references themselves will still appear at the end of the page. There is no known workaround for this problem as of April 2014.
Examples
Code | Output |
---|---|
{{delink|[[Foo]]}}
|
Foo |
{{delink|[[Foo|Bar]]}}
|
Bar |
{{delink|[[Foo]], [[bar]], and [[baz]].}}
|
Foo, bar, and baz. |
{{delink|I visited [https://www.example.com example.com].}}
|
I visited example.com. |
{{delink|Foo}}
|
Foo |
Non-examples
Code | Output |
---|---|
{{delink|https://www.example.com}}
|
https://www.example.com |