Template:Citation Style documentation/registration: Difference between revisions

m 1 revision imported: Citation templates
m 1 revision imported: template update
 
(4 intermediate revisions by 4 users not shown)
Line 4: Line 4:
<!-- There are four access levels split between the url-holding parameters and the identifier parameters. -->Four access levels can be used:
<!-- There are four access levels split between the url-holding parameters and the identifier parameters. -->Four access levels can be used:
*[[#Access indicator for named identifiers|access indicator for named identifiers]]:
*[[#Access indicator for named identifiers|access indicator for named identifiers]]:
** [[File:Lock-green.svg|9px|link=|alt=Freely accessible|Freely accessible]] <code>free</code>: the source is free to read for anyone (from the viewpoint of the provider of the source &ndash; could still be blocked by client-side filtering or safeguarding, or distributor-based geoblocking<!-- to be distinguished from geoblocking by the provider of the source -->)
** [[File:Lock-green.svg|9px|link=|alt=Freely accessible|Freely accessible]] <code>free</code>: the source is free to read for anyone
*[[#Access indicators for url-holding parameters|access indicators for url-holding parameters]]:
*[[#Access indicators for url-holding parameters|access indicators for url-holding parameters]]:
** [[File:Lock-gray-alt-2.svg|9px|link=|alt=Free registration required|Free registration required]] <code>registration</code>: a free registration with the provider of the source is required to access the source, even if a limited preview, abstract or review may still be available without registration
** [[File:Lock-gray-alt-2.svg|9px|link=|alt=Free registration required|Free registration required]] <code>registration</code>: a free registration with the provider is required to access the source, even if a limited preview, abstract or review may still be available without registration
** [[File:Lock-gray-alt-2.svg|9px|link=|alt=Free access subject to limited trial, subscription normally required|Free access subject to limited trial, subscription normally required]] <code>limited</code>: there are other constraints (such as a cap on daily views, a restriction to certain day or night times, or providing the contents only to certain IP ranges/locales on behalf of the provider of the source<!-- to be distinguished from geoblocking by other parties -->) to freely access this source as a whole
** [[File:Lock-gray-alt-2.svg|9px|link=|alt=Free access subject to limited trial, subscription normally required|Free access subject to limited trial, subscription normally required]] <code>limited</code>: free access is subject to limited trial and a subscription is normally required
** [[File:Lock-red-alt-2.svg|9px|link=|alt=Paid subscription required|Paid subscription required]] <code>subscription</code>: the source as a whole is only accessible via a paid subscription with the provider of the source ("[[paywall]]"), even if a limited preview, abstract or review may still be available without subscription
** [[File:Lock-red-alt-2.svg|9px|link=|alt=Paid subscription required|Paid subscription required]] <code>subscription</code>: the source is only accessible via a paid subscription with the provider of the source ("[[paywall]]")


As there are often multiple external links with different access levels in the same citation, each value is attributed to a specific external link.
As there are often multiple external links with different access levels in the same citation, each value is attributed to a specific external link.


=====Access indicators for url-holding parameters=====
=====Access indicators for url-holding parameters=====
 
{{shortcut|WP:URLACCESS}}
Online sources linked by {{para|url}}, {{para|article-url}}, {{para|chapter-url}}, {{para|contribution-url}}, {{para|entry-url}}, {{para|map-url}}, and {{para|section-url}} are presumed to be free-to-read.<ref name=NotRef>{{NotRef}}</ref> When they are not free-to-read, editors should mark those sources with the matching access-indicator parameter so that an appropriate icon is included in the rendered citation. Because the sources linked by these url-holding parameters are presumed to be free-to-read, they may not be marked as <code>free</code>.
{{main|WP:CONLINK}}
Online sources linked by {{para|url}}, {{para|article-url}}, {{para|chapter-url}}, {{para|contribution-url}}, {{para|entry-url}}, {{para|map-url}}, and {{para|section-url}} are presumed to be free-to-read. When they are not free-to-read, editors should mark those sources with the matching access-indicator parameter so that an appropriate icon is included in the rendered citation. Because the sources linked by these URL-holding parameters are presumed to be free-to-read, they are not marked as <code>free</code>.  If the registration/limited/subscription access to the source goes dead and is no longer available, then remove the access-indicator parameter and add {{para|archive-url}} and {{para|archive-date}} values if possible.


{| class="wikitable plainrowheaders"
{| class="wikitable plainrowheaders"
Line 44: Line 45:
| {{para|section-url-access}}
| {{para|section-url-access}}
|}
|}
{{reflist}}


For example, this cites a web page that requires registration but not subscription:
For example, this cites a web page that requires registration but not subscription:


:<nowiki>{{cite web |url=https://example.com/nifty_data.php |url-access=registration |date=2021-04-15 |title=Nifty example data}}</nowiki>
<syntaxhighlight lang="wikitext">{{cite web |url=https://example.com/nifty_data.php |url-access=registration |date=2021-04-15 |title=Nifty example data}}</syntaxhighlight>


which renders as:
which renders as:
Line 96: Line 96:
|-
|-
!scope="row"| {{para|bibcode}}
!scope="row"| {{para|bibcode}}
| {{para|bibcode-access}} || rowspan="7" | <code>free</code> [[File:Lock-green.svg|9px|link=|alt=Freely accessible|Freely accessible]]
| {{para|bibcode-access}} || rowspan="8" | <code>free</code> [[File:Lock-green.svg|9px|link=|alt=Freely accessible|Freely accessible]]
|-
|-
!scope="row"| {{para|doi}}
!scope="row"| {{para|doi}}
Line 112: Line 112:
!scope="row"| {{para|osti}}
!scope="row"| {{para|osti}}
| {{para|osti-access}}
| {{para|osti-access}}
|-
!scope="row"| {{para|ssrn}}
| {{para|ssrn-access}}
|-
|-
!scope="row"| {{para|s2cid}}
!scope="row"| {{para|s2cid}}
Line 121: Line 124:
*{{para|biorxiv}}
*{{para|biorxiv}}
*{{para|citeseerx}}
*{{para|citeseerx}}
*{{para|medrxiv}}
*{{para|pmc}}
*{{para|pmc}}
*{{para|rfc}}
*{{para|rfc}}
*{{para|ssrn}}


For embargoed {{#invoke:cs1 documentation support|canonical_name_get|PMC}} that will become available in the future, see {{#invoke:cs1 documentation support|canonical_name_get|Embargo|id=csdoc_Embargo}}.
For embargoed {{#invoke:cs1 documentation support|canonical_name_get|PMC}} that will become available in the future, see {{#invoke:cs1 documentation support|canonical_name_get|Embargo|id=csdoc_Embargo}}.
=====Tracking of free DOIs=====
* The template is able to recognize known free-to-read [[DOI registrant]]s, based on a list in [[Module:Citation/CS1/Configuration]]. Once a free registrant is identified, the <code>10.xxxx/...</code> part of the DOI associated with the registrant can be added to the list under ''local function build_free_doi_registrants_table()''. If {{para|doi-access|free}} is not set, it will place the page in [[:Category:CS1 maint: unflagged free DOI]], which is routinely cleared by [[User:Citation bot]].
* The template is also able to recognize known free-to-read journals, assuming they have a clear <code>10.xxxx/yyyy....</code> DOI pattern. Once that pattern is identified, it can be added to [[Module:Citation/CS1/Configuration]] under ''local extended_registrants_t = {'' with the format <code>['XXXX'] = {'YYYY'},</code>. If there are multiple journals with the same DOI prefix, they can be grouped together with the format <code>['XXXX'] = {'YYYY', 'ZZZZ', '...'},</code>.
* If you add a free registrant/free journal to the lists in [[Module:Citation/CS1/Configuration]], leave a note at [[User talk:Citation bot]] so the bot knows about it.