Difference between revisions of "Template:Dead link/doc"

From blackwiki
Jump to navigation Jump to search
imported>Redrose64
m (→‎Dead link tools: fix interwiki)
imported>Rich Farmbrough
Line 2: Line 2:
 
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
 
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->
 
<!--redirect regex: [Dd]ead[ _]+link|[Dd]l|[Dd]eadlink|[Cc]leanup-link|[Dd]l-s|404|[Bb]roken[ _]+link|[Bb]rokenlink -->
 
<!--redirect regex: [Dd]ead[ _]+link|[Dd]l|[Dd]eadlink|[Cc]leanup-link|[Dd]l-s|404|[Bb]roken[ _]+link|[Bb]rokenlink -->
{{template shortcut|404|dl|broken link}}
+
{{Template shortcut|404|dl|Broken link}}
  
Use {{tl|dead link}} when you find a [[WP:Linkrot|dead external link]] within a paragraph or a reference citation. Doing so will place a note by the URL and add the article to one of the [[:Category:Articles with dead external links]] categories.
+
==Usage==
 +
Use {{Tl|Dead link}} when you find a [[WP:Linkrot|dead external link]] within a paragraph or a reference citation. Doing so will place a note by the URL and add the article to one of the [[:Category:Articles with dead external links]] categories.
  
 
Append this template '''directly after''' the link or template, leaving the original link intact.  Not doing so will prevent detection from automated tools.  This tag should be placed just before the <code>&lt;/ref&gt;</code> that contains the dead link. The notice will then appear in the footnote reference (instead of in the body of the text, which is not recommended).
 
Append this template '''directly after''' the link or template, leaving the original link intact.  Not doing so will prevent detection from automated tools.  This tag should be placed just before the <code>&lt;/ref&gt;</code> that contains the dead link. The notice will then appear in the footnote reference (instead of in the body of the text, which is not recommended).
Line 10: Line 11:
 
In citations that contain multiple URLs (e.g. chapterurl and url), where links are formed by the template and thus cannot be followed by the dead link template, the above instruction is inadequate.
 
In citations that contain multiple URLs (e.g. chapterurl and url), where links are formed by the template and thus cannot be followed by the dead link template, the above instruction is inadequate.
  
== Usage ==
+
 
 
;Common form (with current date)
 
;Common form (with current date)
 
<tt>{&#123;dead link|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}</tt>
 
<tt>{&#123;dead link|date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}</tt>
Line 16: Line 17:
 
===Optional parameters===
 
===Optional parameters===
 
;url: Provides a history of the linked page via [[Wayback Machine]].  Set '''only''' if history actually exists, as otherwise it is misleading to users and editors.
 
;url: Provides a history of the linked page via [[Wayback Machine]].  Set '''only''' if history actually exists, as otherwise it is misleading to users and editors.
;date: Given in month name followed by year for use by the categorization system.  Use <code>date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}</code>  <br/>If you don't add a date parameter, a bot will date your entry with the month and year at a later time.
+
;date: Month name followed by year, for use by the categorization system.  Use <code>date={{CURRENTMONTHNAME}} {{CURRENTYEAR}}</code>  <br/>If you don't add a date parameter, a bot will date your entry with the month and year at a later time.
;bot: [[WP:BOTS|Bot accounts]] will specify the |bot= parameter to notify the others that the page was tagged by an automated process.  Set as <code>bot=ExampleBot</code>.
+
;bot: [[WP:BOTS|Bot accounts]] specify the |bot= parameter as a sign that the tag was added by an automated process.  Set as <code>bot=<bot name></code>.
  
 
== Examples ==
 
== Examples ==
Line 37: Line 38:
 
<references />
 
<references />
  
=== Caveats ===
+
===Caveats===
 
* Avoid using free links (e.g. <code>http://example.org/{{dead link<nowiki />}}</code>) as software unable to handle templates may read an incorrect link. Add brackets if necessary.
 
* Avoid using free links (e.g. <code>http://example.org/{{dead link<nowiki />}}</code>) as software unable to handle templates may read an incorrect link. Add brackets if necessary.
 
* Avoid complicated formatting. Nesting inside a template is generally not supported well.   
 
* Avoid complicated formatting. Nesting inside a template is generally not supported well.   
 
* Avoid using <tt>[ ] { | } < ></tt> character between the end of the external link and <nowiki>{{dead link}}</nowiki>, as they are often used to format text
 
* Avoid using <tt>[ ] { | } < ></tt> character between the end of the external link and <nowiki>{{dead link}}</nowiki>, as they are often used to format text
  
== See also ==
+
==See also==
* {{tl|dead links}} header
+
* {{Tl|Dead links}} header
* {{tl|linkrot}} header (same as {{tl|Cleanup-link rot}})
+
* {{Tl|Link rot}} header (same as {{Tl|Cleanup-link rot}})
* {{tl|Registration required}} citation flag
+
* {{Tl|Registration required}} citation flag
* {{tl|Subscription required}} citation flag
+
* {{Tl|Subscription required}} citation flag
* {{tl|Failed verification}} citation flag
+
* {{Tl|Failed verification}} citation flag
 
* [[WP:DEADREF|What to do when a reference link goes dead]]
 
* [[WP:DEADREF|What to do when a reference link goes dead]]
* {{tl|Wayback}}  
+
* {{Tl|Wayback}}  
  
=== Dead link tools ===
+
===Dead link tools===
 
* [[User:Dispenser/Checklinks|Checklinks]]
 
* [[User:Dispenser/Checklinks|Checklinks]]
 
* [[User:DeadLinkBOT|DeadLinkBOT]]
 
* [[User:DeadLinkBOT|DeadLinkBOT]]

Revision as of 10:54, 13 October 2010

Usage

Use {{Dead link}} when you find a dead external link within a paragraph or a reference citation. Doing so will place a note by the URL and add the article to one of the Category:Articles with dead external links categories.

Append this template directly after the link or template, leaving the original link intact. Not doing so will prevent detection from automated tools. This tag should be placed just before the </ref> that contains the dead link. The notice will then appear in the footnote reference (instead of in the body of the text, which is not recommended).

In citations that contain multiple URLs (e.g. chapterurl and url), where links are formed by the template and thus cannot be followed by the dead link template, the above instruction is inadequate.


Common form (with current date)

{{dead link|date=January 2026}}

Optional parameters

url
Provides a history of the linked page via Wayback Machine. Set only if history actually exists, as otherwise it is misleading to users and editors.
date
Month name followed by year, for use by the categorization system. Use date=January 2026
If you don't add a date parameter, a bot will date your entry with the month and year at a later time.
bot
Bot accounts specify the |bot= parameter as a sign that the tag was added by an automated process. Set as bot=<bot name>.

Examples

  • <ref>{{cite web |url=http://example.org |title=title |accessdate=2000-01-01 }} {{dead link |date=April 2005 }}</ref>
    [1]
  • <ref>Plunkett, John. [http://media.guardian.co.uk/site/story/0,14173,1601858,00.html "Sorrell accuses Murdoch of panic buying"],{{dead link}} ''The Guardian'', London, October 27, 2005. Retrieved June 5, 2008.</ref>
    [2]
  1. "title". Retrieved 2000-01-01. Check date values in: |accessdate= (help)[dead link]
  2. Plunkett, John. "Sorrell accuses Murdoch of panic buying",[dead link] The Guardian, London, October 27, 2005. Retrieved June 5, 2008.

Caveats

  • Avoid using free links (e.g. http://example.org/{{dead link}}) as software unable to handle templates may read an incorrect link. Add brackets if necessary.
  • Avoid complicated formatting. Nesting inside a template is generally not supported well.
  • Avoid using [ ] { | } < > character between the end of the external link and {{dead link}}, as they are often used to format text

See also

Dead link tools