View source for Template:Cleanup bare URLs/doc

{{Documentation subpage}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE. -->
{{For|the template that tags specific citations|Template:Bare URL inline}}
{{High use|18767}}
{{AWB standard installation}}
{{Twinkle standard installation}}
{{Tsh|Bare links|Bare refs|Link rot|Lr}}

This template will add tagged articles to a cleanup category according to the month and year given.

== What is a bare URL? ==

A bare [[Uniform resource locator|URL]] is a link to a website with '''no''' identifying information except the link itself.  It is ''not'' just a citation style that leaves the URL visible to the reader.  Fully visible URLs are required by some citation styles, such as the [[The MLA Style Manual|MLA style]].  However, these visible URLs should be accompanied by useful descriptions of the page being linked, such as information about the author, title, and/or publication.

;Bare URLs—add this tag
* http://www.example.org/page.html
* [http://www.example.org/page.html]

;Good citations—do not add this tag
* Fuster V, Walsh RA, Harrington RA, eds. ''Hurst's The Heart.'' 13th ed. New York: McGraw-Hill; 2011. http://www.accessmedicine.com/content.aspx?aID=7812984.
* Fuster V, Walsh RA, Harrington RA, eds. ''Hurst's The Heart.'' 13th ed. New York: McGraw-Hill; 2011.[http://www.accessmedicine.com/content.aspx?aID=7812984]

== How to use ==
Before adding this template, consider trying [[toollabs:refill]], paste into the text box the name of the page with bare references, then click the "Fix page" button. Wait patiently for the program to finish filling in all citation templates for each bare reference. When the result page is loaded, please double-check the changes made in the ''diff'' preview on the result page and fix the errors before clicking the "Show preview" button at the bottom. References that could not be filled in with the tool will be listed on the page. On the actual editing interface on-wiki, you may wish to check the changes once again and use [[User:Ohconfucius/script/Sources|Ohconfucius's scripts]] to automatically correct some mistakes. When everything looks fine, click the "Publish changes" button to save your changes.

If there are references you failed to fix or you need assistance in fixing them, paste this at the '''top of an article''' with bare-URL references:
: {{Tlx|Cleanup bare URLs|date{{=}}{{CURRENTMONTHNAME}} {{CURRENTYEAR}}}}

Save the page. Someone else may click on the ''reFill tool'' link on the template to fix the bare references semi-automatically, or manually correct them.

A manual of the tool is available on [[Wikipedia:ReFill]].

== Tracking categories ==
This template places the article into the following categories:
*[[:Category:All articles with bare URLs for citations]] — {{PAGESINCATEGORY:All articles with bare URLs for citations}} pages
*[[:Category:Articles with bare URLs for citations]] or a dated subcategory thereof, currently
**[[:Category:Articles with bare URLs for citations from {{CURRENTMONTHNAME}} {{CURRENTYEAR}}]] — {{PAGESINCATEGORY:Articles with bare URLs for citations from {{CURRENTMONTHNAME}} {{CURRENTYEAR}}}} pages
* [[:Category:Articles covered by WikiProject Wikify]] or a dated subcategory thereof, currently
**[[:Category:Articles covered by WikiProject Wikify from {{CURRENTMONTHNAME}} {{CURRENTYEAR}}]] — {{PAGESINCATEGORY:Articles covered by WikiProject Wikify from {{CURRENTMONTHNAME}} {{CURRENTYEAR}}}} pages
* [[:Category:Articles needing cleanup]] or a dated subcategory thereof, currently
**[[:Category:Articles needing cleanup from {{CURRENTMONTHNAME}} {{CURRENTYEAR}}]] — {{PAGESINCATEGORY:Articles needing cleanup from {{CURRENTMONTHNAME}} {{CURRENTYEAR}}}} pages

If no date was added, a [[Wikipedia:Bots|bot]] will add it later.

<small>{{Purge|''Purge this page to update pages-in-category counts''}}</small>

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
	"description": "Use this cleanup template to indicate that an article uses references containing bare URLs, which may be threatened by link rot.",
	"format": "inline",
	"params": {
		"date": {
			"label": "Month and year",
			"description": "The month and year that the template was placed (in full). \"{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}\" inserts the current month and year automatically.",
			"type": "line",
			"autovalue": "{{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}}",
			"example": "January 2013",
			"suggested": true
		},
		"1": {
			"label": "Affected area",
			"description": "Text to replace the word \"article\", usually \"section\"",
			"type": "line",
			"autovalue": "section",
			"example": "section"
		}
	},
	"paramOrder": [
		"date",
		"1"
	]
}
</templatedata>

== On-demand search and tag ==
[[Template:Cleanup bare URLs/bot|Tagbot]] adds the template on-demand. It searches for pages with bare links and tags them. See the control page [[Template:Cleanup bare URLs/bot]] for instructions how to trigger the bot to run.

In addition to {{para|date}} the bot adds two arguments:
* {{para|bot|wp:tagbot}}
* {{para|requester|<username>}} ie. who requested the bot to run

== Redirects ==
{{columns-list|colwidth=20em|
* {{Tl|Bare}}
* {{Tl|Bare links}}
* {{Tl|Barelinks}}
* {{Tl|Bare references}}
* {{Tl|Bare refs}}
* {{Tl|Bare URLs}}
* {{Tl|Bare urls}}
* {{Tl|Bareurls}}
* {{Tl|BareURLs}}
* {{Tl|Bare-URLs}}
* {{Tl|Cleanup link rot}}
* {{Tl|Cleanup link-rot}}
* {{Tl|Cleanup-link-rot}}
* {{Tl|Cleanup-linkrot}}
* {{Tl|Link rot}}
* {{Tl|Linkrot}}
}}
[{{fullurl:Special:WhatLinksHere/Template:Cleanup bare URLs|hidetrans=1&hidelinks=1}} And more]

== See also ==
* [https://en.wikipedia.org/w/index.php?title=Special:WhatLinksHere/Template:Cleanup_bare_URLs&hideredirs=1&hidelinks=1 List of Wikipedia articles with bare URLs]
* {{tl|Bare URL inline}}
* {{tl|Citations broken}}
* {{tl|Dead link}}
* {{tl|External links}}
* [[Wikipedia:Link rot]]
* [[Wikipedia:Template messages/Cleanup]]

{{Citation and verifiability article maintenance templates}}

<includeonly>{{Sandbox other||<!--
++++ PLEASE ADD CATEGORIES AND INTERWIKIS BELOW THIS LINE, THANK YOU. -->
[[Category:Cleanup templates]]
[[Category:Citation and verifiability maintenance templates]]

[[pt:Predefinição:Formatar referências]]
[[sl:Predloga:GoliURL]]
[[zh:Template:Bare URLs]]
}}</includeonly>