Template:Citation Style documentation/url
< Template:Citation Style documentation
Jump to navigation
Jump to search
Revision as of 10:43, 4 September 2019 by wii>Pol098 (or the equivalent {{para|dead-url|no}}, (minor?))
- url: URL of an online location where the text of the publication can be found. Cannot be used if title is wikilinked. If applicable, the link may point to the specific page(s) referenced. Remove tracking parameters from URLs, e.g.
#ixzz2rBr3aO94
or?utm_source=google&utm_medium=...&utm_term=...&utm_campaign=...
. Script error: No such module "Hatnote inline". Do not link to any commercial booksellers, such as Amazon.com; use|ISBN=
or|OCLC=
to provide neutral search links for books. Invalid URLs, including those containing spaces, will result in an error message.- access-date: Full date when the content pointed to by url was last verified to support the text in the article; do not wikilink; requires url; use the same format as other access and archive dates in the citations.[date 1] Not required for linked documents that do not change. For example, access-date is required for online sources, such as personal websites, that do not have a publication date; see WP:CITEWEB. Access dates are not required for links to published research papers, published books, or news articles with publication dates. Note that access-date is the date that the URL was found to be working and to support the text being cited. Can be hidden or styled by registered editors. Alias: accessdate.
- archive-url: The URL of an archived snapshot of a web page. Typically used to refer to services such as Internet Archive Script error: No such module "Hatnote inline"., WebCite Script error: No such module "Hatnote inline". and archive.is Script error: No such module "Hatnote inline".; requires archive-date and url. By default (overridden by
|url-status=live
, or the equivalent|dead-url=no
, deprecated but still used in many articles) the archived link is displayed first, with the original link at the end. Alias: archiveurl.- archive-date: Archive-service snapshot-date; preceded in display by default text "archived from the original on". Use the same format as other access and archive dates in the citations. This does not necessarily have to be the same format that was used for citing publication dates.[date 1] Do not wikilink; templated dates are discouraged. Alias: archivedate.
- url-status: this optional parameter is ignored if archive-url is not set. If omitted, or with null value, the default value is
|url-status=dead
. When the URL is still live, but pre-emptively archived, then set|url-status=live
; this changes the display order, with the title retaining the original link and the archive linked at the end. When the original URL has been usurped for the purposes of spam, advertising, or is otherwise unsuitable, setting|url-status=unfit
or|url-status=usurped
suppresses display of the original URL (but|url=
and|archive-url=
are still required). - dead-url: (deprecated)
the default value of this optional parameter, if omitted, is|dead-url=yes
; equivalent values are y or true. Ignored if archive-url is not set. When the URL is still live, but pre-emptively archived, then set|dead-url=no
; this changes the display order, with the title retaining the original link and the archive linked at the end. When the original URL has been usurped for the purposes of spam, advertising, or is otherwise unsuitable, setting|dead-url=unfit
or|dead-url=usurped
suppresses display of the original URL (but|url=
and|archive-url=
are still required). Alias: deadurl (deprecated).
- template-doc-demo: The archive parameters will be error-checked to ensure that all the required parameters are included, or else {{citation error}} is invoked. With errors, main, help and template pages are placed into one of the subcategories of Category:Articles with incorrect citation syntax. Set
|template-doc-demo=true
to disable categorization; mainly used for documentation where the error is demonstrated. Alias: no-cat.
- format: Format of the work referred to by url; for example: PDF, DOC, or XLS; displayed in parentheses after title. (For media format, use type.) HTML is implied and should not be specified. Automatically added when a PDF icon is displayed. Does not change the external link icon. Note: External link icons do not include alt text; thus, they do not add format information for the visually impaired.
- URLs must begin with a supported URI scheme.
http://
andhttps://
will be supported by all browsers; however,ftp://
,gopher://
,irc://
,ircs://
,mailto:
andnews:
may require a plug-in or an external application and should normally be avoided. IPv6 host-names are currently not supported. - If URLs in citation template parameters contain certain characters, then they will not display and link correctly. Those characters need to be percent-encoded. For example, a space must be replaced by
%20
. To encode the URL, replace the following characters with:
sp | " | ' | < | > | [ | ] | { | | | } |
---|---|---|---|---|---|---|---|---|---|
%20 | %22 | %27 | %3c | %3e | %5b | %5d | %7b | %7c | %7d |
- Single apostrophes do not need to be encoded; however, unencoded multiples will be parsed as italic or bold markup. Single curly closing braces also do not need to be encoded; however, an unencoded pair will be parsed as the double closing braces for the template transclusion.