Template:Citation Style documentation/url: Difference between revisions
Content deleted Content added
Extended confirmed users, Pending changes reviewers 114,692 edits re url-status=live issue: see Talk page. Could possibly be an issue with my setup, but hovering the mouse over the ref number in the Talk post will show what happens. |
Extended confirmed users, Pending changes reviewers 114,692 edits url-status: added {{Em|Note: if {{para|url-status|live}} is included but there is no {{para|archive-url}}, an error message is displayed when the link is hovered over, and a warning shown when the edit is previewed, although the reference shows normally in the list.}} Tag: Reverted |
||
| Line 3: | Line 3: | ||
** <b id="csdoc_archiveurl">archive-url</b>: The URL of an [[Web archiving|archived]] snapshot of a web page. Typically used to refer to services such as [[Internet Archive]] {{crossref|(see [[Wikipedia:Using the Wayback Machine]])}}, [[WebCite]] {{crossref|(see [[Help:Using WebCite]])}} and [[archive.today]] {{crossref|(see [[Help:Using archive.today]])}}; requires '''archive-date''' and '''url'''. By default (overridden by {{para|url-status|live}}) the archived link is displayed first, with the original link at the end. Alias: '''archiveurl'''. |
** <b id="csdoc_archiveurl">archive-url</b>: The URL of an [[Web archiving|archived]] snapshot of a web page. Typically used to refer to services such as [[Internet Archive]] {{crossref|(see [[Wikipedia:Using the Wayback Machine]])}}, [[WebCite]] {{crossref|(see [[Help:Using WebCite]])}} and [[archive.today]] {{crossref|(see [[Help:Using archive.today]])}}; requires '''archive-date''' and '''url'''. By default (overridden by {{para|url-status|live}}) the archived link is displayed first, with the original link at the end. Alias: '''archiveurl'''. |
||
*** <b id="csdoc_archivedate">archive-date</b>: 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.{{r|date|group=date}} Do not wikilink; templated dates are discouraged. See [[#csdoc_auto-date-format|"Automatic date formatting"]] above for details about interaction with {{tlx|use dmy dates}} and {{tlx|use mdy dates}}. Alias: '''archivedate'''. |
*** <b id="csdoc_archivedate">archive-date</b>: 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.{{r|date|group=date}} Do not wikilink; templated dates are discouraged. See [[#csdoc_auto-date-format|"Automatic date formatting"]] above for details about interaction with {{tlx|use dmy dates}} and {{tlx|use mdy dates}}. Alias: '''archivedate'''. |
||
*** <b id="csdoc_urlstatus">url-status</b>: this optional parameter is ignored if '''archive-url''' is not set. If omitted, or with null value, the default value is {{para|url-status|dead}}. When the URL is still live, but pre-emptively archived, then set {{para|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 is 'live' but no longer supports the article text, set {{para|url-status|deviated}}. When the original URL has been usurped for the purposes of spam, advertising, or is otherwise unsuitable, setting {{para|url-status|unfit}} or {{para|url-status|usurped}} suppresses display of the original URL (but {{para|url}} and {{para|archive-url}} are still required). |
*** <b id="csdoc_urlstatus">url-status</b>: this optional parameter is ignored if '''archive-url''' is not set. If omitted, or with null value, the default value is {{para|url-status|dead}}. When the URL is still live, but pre-emptively archived, then set {{para|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 is 'live' but no longer supports the article text, set {{para|url-status|deviated}}. {{Em|Note: if {{para|url-status|live}} is included but there is no {{para|archive-url}}, an error message is displayed when the link is hovered over, and a warning shown when the edit is previewed, although the reference shows normally in the list.}} When the original URL has been usurped for the purposes of spam, advertising, or is otherwise unsuitable, setting {{para|url-status|unfit}} or {{para|url-status|usurped}} suppresses display of the original URL (but {{para|url}} and {{para|archive-url}} are still required). |
||
*** <b id="csdoc_archive_format">archive-format</b>: File format of the work referred to by '''archive-url'''; for example: PDF, DOC, or XLS; displayed in parentheses after the archive link. HTML is implied and should not be specified. File format annotation is automatically rendered when a PDF icon is displayed. Does not change the [[Help:External link icons|external link icon]]. Note: External link icons do not include [[Wikipedia:ALT|alt text]]; thus, they do not add file format information for the visually impaired. {{crossref|See [[Help:Citation Style 1#Using {{pipe}}format=|Using {{pipe}}format=]]}} |
*** <b id="csdoc_archive_format">archive-format</b>: File format of the work referred to by '''archive-url'''; for example: PDF, DOC, or XLS; displayed in parentheses after the archive link. HTML is implied and should not be specified. File format annotation is automatically rendered when a PDF icon is displayed. Does not change the [[Help:External link icons|external link icon]]. Note: External link icons do not include [[Wikipedia:ALT|alt text]]; thus, they do not add file format information for the visually impaired. {{crossref|See [[Help:Citation Style 1#Using {{pipe}}format=|Using {{pipe}}format=]]}} |
||
** <b id="csdoc_url_access">url-access</b>: {{crossref|See [[#Access indicators for url-holding parameters|Access indicators for url-holding parameters]]}} |
** <b id="csdoc_url_access">url-access</b>: {{crossref|See [[#Access indicators for url-holding parameters|Access indicators for url-holding parameters]]}} |
||
Revision as of 11:41, 13 July 2022
- url: URL of an online location where the text of the publication named by title 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.
#ixzz2rBr3aO94or?utm_source=google&utm_medium=...&utm_term=...&utm_campaign=.... ; requires archive-date and url. By default (overridden by|url-status=live) 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. See "Automatic date formatting" above for details about interaction with
{{use dmy dates}}and{{use mdy dates}}. 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 is 'live' but no longer supports the article text, set|url-status=deviated. Note: if|url-status=liveis included but there is no|archive-url=, an error message is displayed when the link is hovered over, and a warning shown when the edit is previewed, although the reference shows normally in the list. When the original URL has been usurped for the purposes of spam, advertising, or is otherwise unsuitable, setting|url-status=unfitor|url-status=usurpedsuppresses display of the original URL (but|url=and|archive-url=are still required). - archive-format: File format of the work referred to by archive-url; for example: PDF, DOC, or XLS; displayed in parentheses after the archive link. HTML is implied and should not be specified. File format annotation is automatically rendered when a PDF icon is displayed. Does not change the alt text; thus, they do not add file format information for the visually impaired.
- 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. See "Automatic date formatting" above for details about interaction with
- url-access:
alt text; thus, they do not add file format information for the visually impaired.
URLs must begin with a supported
URI scheme.
host-names are currently not supported.
http:// and https:// will be supported by all browsers; however, ftp://, gopher://, irc://, ircs://, mailto: and news: may require a plug-in or an external application and should normally be avoided. IPv6If URLs in
percent-encoded
. For example, a space must be replaced by %20. To encode the URL, replace the following characters with:
| Character | space | " | ' | < | > | [ | ] | { | | | } |
|---|---|---|---|---|---|---|---|---|---|---|
| Encoding | %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.
- ^ MOS:DATEUNIFY.