Help:CS1 errors: Difference between revisions

m
no edit summary
(clearer shortcut)
 
imported>Rudyeeeeeeee
mNo edit summary
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Short description|Wikipedia help page}}
{{pp-semi-indef}}
{{pp-semi-indef}}
{{Wikipedia how to}}
{{Wikipedia how to}}
Line 7: Line 8:
Errors issued by Wikipedia's <code>&lt;ref></code> system, in which citation templates are typically embedded, can be found at [[Help:Cite errors]].
Errors issued by Wikipedia's <code>&lt;ref></code> system, in which citation templates are typically embedded, can be found at [[Help:Cite errors]].


==Controlling error message display==
== Controlling error message display ==
<section begin="show_error_messages_help_text" /><section begin="show_all_messages_help_text" />By default, {{cs1}} and {{cs2}} error messages are visible to all readers and maintenance category messages are hidden from all readers.
=== Preview messages ===
When editors preview an article, MediaWiki displays a preview message box under the Preview header.  When {{cs1}} and {{cs2}} templates have error or maintenance messages, [[Module:Citation/CS1]] summarizes those messages in the preview message box.  Such a message box might look something like this:
<div style="margin-left:1.6em" class="mw-message-box-warning mw-message-box"><p>This is only a preview; your changes have not yet been saved! <span class="mw-continue-editing"> [[#editform|→ Go to editing area]]</span>
</p><p>Script warning: {{color|#3a3|One or more {{mono|<nowiki>{{</nowiki>[[Template:cite book|cite book]]<nowiki>}}</nowiki>}} templates have maintenance messages}}; messages may be hidden ([[Help:CS1_errors#Controlling_error_message_display|help]]).</p><p>Script warning: {{color|#d33|One or more {{mono|<nowiki>{{</nowiki>[[Template:cite journal|cite journal]]<nowiki>}}</nowiki>}} templates have errors}}; messages may be hidden ([[Help:CS1_errors#Controlling_error_message_display|help]]).</p></div>


To display maintenance messages, include the following text in your common [[Cascading Stylesheets|CSS]] page or your specific skin's CSS page ([[Special:MyPage/common.css|common.css]] and [[Special:MyPage/skin.css|skin.css]] respectively):
The summary messages have three components:
#'Script warning:' – this prefix is provided by MediaWiki;
#a colored ({{color|#3a3|green maintenance}} or {{color|#d33|red error}}) message that identifies the type of template that has a message with a link to that template's documentation; wrapper templates with messages will show the name of the wrapped template, and;
#'messages may be hidden' – the message suffix with a help link to this page.
Preview messages in the preview message box cannot be hidden.  The preview message suffix 'messages may be hidden' means that the template's message(s) may not be visible.  To learn how to show or hide template messages, see {{slink||Error and maintenance messages}}.
 
=== Error and maintenance messages ===
 
<section begin="show_error_messages_help_text" /><section begin="show_all_messages_help_text" />By default, {{cs1}} and {{cs2}} <span style="color:#d33">error messages</span> are visible to all readers and <span style="color:#3a3">maintenance messages</span> are hidden from all readers.
 
To display <span style="color:#3a3">maintenance messages</span> in the rendered article, include the following text in your common [[Cascading Stylesheets|CSS]] page ([[Special:MyPage/common.css|common.css]]) or your specific skin's CSS page and ([[Special:MyPage/skin.css|skin.css]]).
 
(Note to new editors: those CSS pages are specific to you, and control your view of pages, by adding to your user account's [[CSS]] code. If you have not yet created such a page, then clicking one of the <code>.css</code> links above will yield a page that starts "Wikipedia does not have a [[user page]] with this exact name." Click the "Start the User:''username''/''filename'' page" link, paste the text below, save the page, follow the instructions at the bottom of the new page on bypassing your browser's cache, and finally, in order to see the previously hidden maintenance messages, refresh the page you were editing earlier.)


<syntaxhighlight lang="css">.mw-parser-output span.cs1-maint {display: inline;} /* display Citation Style 1 maintenance messages */</syntaxhighlight>
<syntaxhighlight lang="css">.mw-parser-output span.cs1-maint {display: inline;} /* display Citation Style 1 maintenance messages */</syntaxhighlight>


To display hidden-by-default error messages:
To display hidden-by-default <span style="color:#d33">error messages</span>:


<syntaxhighlight lang="css">.mw-parser-output span.cs1-hidden-error {display: inline;} /* display hidden Citation Style 1 error messages */</syntaxhighlight>
<syntaxhighlight lang="css">.mw-parser-output span.cs1-hidden-error {display: inline;} /* display hidden Citation Style 1 error messages */</syntaxhighlight>
Line 20: Line 36:
Even with this CSS installed, older pages in Wikipedia's cache may not have been updated to show these error messages even though the page is listed in one of the tracking categories. A [[WP:NULLEDIT|null edit]] will resolve that issue.
Even with this CSS installed, older pages in Wikipedia's cache may not have been updated to show these error messages even though the page is listed in one of the tracking categories. A [[WP:NULLEDIT|null edit]] will resolve that issue.


To hide normally-displayed error messages:
To hide normally-displayed <span style="color:#d33">error messages</span>:
<syntaxhighlight lang="css">.mw-parser-output span.cs1-visible-error {display: none;} /* hide Citation Style 1 error messages */</syntaxhighlight>
<syntaxhighlight lang="css">.mw-parser-output span.cs1-visible-error {display: none;} /* hide Citation Style 1 error messages */</syntaxhighlight>


You can personalize the display of these messages (such as changing the color), but you will need to ask someone who knows CSS or at [[WP:VPT|the technical village pump]] if you do not understand how.<section end="show_all_messages_help_text" /><section end="show_error_messages_help_text" />
You can personalize the display of these messages (such as changing the color), but you will need to ask someone who knows CSS or at [[WP:VPT|the technical village pump]] if you do not understand how.
 
{{lang|la|Nota bene}}: these css rules are not obeyed by [[Wikipedia:Tools/Navigation popups|Navigation popups]]. They also do not hide script warning messages in the Preview box that begins with "This is only a preview; your changes have not yet been saved".<section end="show_all_messages_help_text" /><section end="show_error_messages_help_text" />
 
=== Properties category highlighting ===
 
<section begin="prop_cat_highlight_help_text" />
[[Module:Citation/CS1]] adds properties categories to some CS1|2 citations.  Unlike errors or maintenance needs, there is no message when a properties category is added.  Properties categories may be temporary or may be perpetual.  Editors can use CSS to add special styling to CS1|2 template renderings that will highlight a citation that added a properties category.  For example, this template uses a long volume name:
:<code><nowiki>{{cite book |title=Title |date=May–Jun 2021 |volume = 1: Long volume}}</nowiki></code>
::{{cite book |title=Title |date=May–Jun 2021 |volume = 1: Long volume}}
If you add this to your CSS that citation will render with a {{background|#FFC|pale yellow}} background:
:<syntaxhighlight lang="css">.cs1-prop-long-vol {background: #FFC;}</syntaxhighlight>
Add one or more of these (with appropriate styling) to your CSS to highlight template renderings when those templates add the associated properties category:
::{{code|lang=css|.cs1-prop-foreign-lang-source {}|}} – subcategories of {{cl|CS1 foreign language sources}}
::{{code|lang=css|.cs1-prop-foreign-lang-source-2 {}|}} – {{cl|CS1 foreign language sources (ISO 639-2)}}
::{{code|lang=css|.cs1-prop-jul-greg-uncertainty {}|}} – {{cl|CS1: Julian–Gregorian uncertainty}}
::{{code|lang=css|.cs1-prop-location-test {}|}} – {{cl|CS1 location test‎}}
::{{code|lang=css|.cs1-prop-long-vol {}|}} – {{cl|CS1: long volume value}}
::{{code|lang=css|.cs1-prop-script {}|}} – subcategories of {{cl|CS1 uses foreign language script‎}}
::{{code|lang=css|.cs1-prop-tracked-param {}|}} – subcategories of {{cl|CS1 tracked parameters}}
::{{code|lang=css|.cs1-prop-year-range-abbreviated {}|}} – {{cl|CS1: abbreviated year range‎}}
<section end="prop_cat_highlight_help_text" />


==Most common errors==
==Most common errors==
<!-- Items listed here with ~10k or more -->
<!-- Items listed here with ~10k or more -->
* [[#Cite &lt;template> requires %7C&lt;param>=]], ~56k pages
* [[#Cite &lt;template> requires %7C&lt;param>=]], ~54k pages
* [[#Cite has empty unknown parameter: &lt;param>]], ~44k pages
* [[#Cite uses generic name]], ~36k pages
* [[#Citation without a title of any form]], ~37k pages
* [[#Citation without a title of any form]], ~34k pages
* [[#Bare URL without a title]], ~26k pages
* [[#Bare URL without a title]], ~24k pages
* [[#Check date values in: %7C&lt;param1>=, %7C&lt;param2>=, ...]], ~15k pages
* [[#External link in %7C&lt;param>=]], ~13k pages
* [[#Missing or empty %7Curl=]], ~9k pages


{{SeeAlso|Category:CS1 errors|Category:CS1 maintenance}}
 
{{See also|Category:CS1 errors|Category:CS1 maintenance}}


==<span id="accessdate_missing_url">|access-date= requires |url= </span>==
==<span id="accessdate_missing_url">|access-date= requires |url= </span>==
<section begin="accessdate_missing_url_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_accessdate_missing_url}}
<section begin="accessdate_missing_url_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_accessdate_missing_url}}


The {{para|access-date}} (or its alias, {{para|accessdate}}) is the date that the online resource addressed by {{para|url}} was added to the article. If {{para|access-date}} has been included in the citation without {{para|url}} then this message appears. If the citation does not use a web link, then {{para|access-date}} is redundant and should be removed.
The {{para|access-date}} is the date that the online resource addressed by {{para|url}} was added to the article. If {{para|access-date}} has been included in the citation without {{para|url}} then this message appears. If the citation does not use a web link, then {{para|access-date}} is redundant and should be removed.


When the online resource has a publication or other fixed date associated with it, {{para|access-date}} is of limited value though may be useful in identifying an appropriate archived version of the resource. Without {{para|url}}, {{para|access-date}} is not considered useful.
When the online resource has a publication or other fixed date associated with it, {{para|access-date}} is of limited value though may be useful in identifying an appropriate archived version of the resource. Without {{para|url}}, {{para|access-date}} is not considered useful.
Line 65: Line 100:
: {{error-small|flag}} – the flag portion of the URL path (if present; new form URLs only) is not 2 lowercase letters followed by an underscore: 'id_'
: {{error-small|flag}} – the flag portion of the URL path (if present; new form URLs only) is not 2 lowercase letters followed by an underscore: 'id_'
: {{error-small|liveweb}} – <code>liveweb.archive.org</code> is a deprecated form of the domain name
: {{error-small|liveweb}} – <code>liveweb.archive.org</code> is a deprecated form of the domain name
When the archive.org URL has any of these errors, Module:Citation/CS1 does not link to archive.org and emits an appropriate error message.
When the archive.org URL has any of these errors, Module:Citation/CS1 does not link to archive.org in normal article view and emits an appropriate error message.


To resolve this error, choose the URL of an appropriate snapshot from those held at archive.org. [https://archive.org/web/ Search for the target URL].
However, in article preview mode, the module creates a modified link to archive.org that uses a partial timestamp with <code>*</code> wildcard suffix. This new URL links to an archive.org calendar view so that editors may more easily select a suitable archived snapshot from those available at archive.org to fix the malformed {{para|archive-url}} link. (If no snapshots have been archived at archive.org, and the cited page is still live, this link also allows editors to save the first snapshot of the page at archive.org.)


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_archive_url}}.<ref group="lower-alpha" name="categories" /><section end="archive_url_help_text" />
To resolve this error, choose the URL of an appropriate snapshot from those held at archive.org. [https://archive.org/web/ Search for the target URL] at archive.org.
 
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_archive_url|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="archive_url_help_text" />


==<span id="archive_missing_date">|archive-url= requires |archive-date= </span>==
==<span id="archive_missing_date">|archive-url= requires |archive-date= </span>==
<section begin="archive_missing_date_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_archive_missing_date}}
<section begin="archive_missing_date_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_archive_missing_date}}


{{para|archive-date}} (or its alias, {{para|archivedate}}), identifies the date that the web resource was archived.
{{para|archive-date}}, identifies the date that the web resource was archived.


To resolve this error, provide a value for {{para|archive-date}} (see acceptable date formats in [[MOS:DATEFORMAT]]). For web resources archived at archive.org,<ref name="archive.org" /> the archival date can be found in the {{para|archive-url}}; for resources archived at webcitation.org,<ref name="webcitation.org" /> the cache date is included in the archive header.
To resolve this error, provide a value for {{para|archive-date}} (see acceptable date formats in [[MOS:DATEFORMAT]]). For web resources archived at archive.org,<ref name="archive.org" /> the archival date can be found in the {{para|archive-url}}; for resources archived at webcitation.org,<ref name="webcitation.org" /> the cache date is included in the archive header.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_archive_missing_date}}.<ref group="lower-alpha" name="categories" /><section end="archive_missing_date_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_archive_missing_date|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="archive_missing_date_help_text" />


==<span id="archive_missing_url">|archive-url= requires |url= </span>==
==<span id="archive_missing_url">|archive-url= requires |url= </span>==
Line 87: Line 124:
To resolve this error, provide a value for {{para|url}}. For web resources archived at archive.org,<ref name="archive.org" /> the original URL can be found in the {{para|archive-url}} value; for resources archived at webcitation.org,<ref name="webcitation.org" /> the original URL is included in the archive header.
To resolve this error, provide a value for {{para|url}}. For web resources archived at archive.org,<ref name="archive.org" /> the original URL can be found in the {{para|archive-url}} value; for resources archived at webcitation.org,<ref name="webcitation.org" /> the original URL is included in the archive header.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_archive_missing_url}}.<ref group="lower-alpha" name="categories" /><section end="archive_missing_url_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_archive_missing_url|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="archive_missing_url_help_text" />


==<span id="arxiv_missing">|arxiv= required</span>==  
==<span id="arxiv_missing">|arxiv= required</span>==  
Line 96: Line 133:
To resolve this error, ensure that the template has {{para|arxiv}} or {{para|eprint}} with a properly constructed value.
To resolve this error, ensure that the template has {{para|arxiv}} or {{para|eprint}} with a properly constructed value.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_arxiv_missing}}.<ref group="lower-alpha" name="categories" /><section end="arxiv_missing_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_arxiv_missing|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="arxiv_missing_help_text" />
 
==<span id="asintld_missing_asin">|asin-tld= requires |asin=</span>==
<section begin="asintld_missing_asin_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_asintld_missing_asin|$1=asin-tld}}
 
When {{para|asin-tld}} is used in a CS1|2 template, {{para|asin}} (with value) must also be present.
 
To resolve this error, either add the missing ASIN or remove the 'broken' parameter.
 
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_asintld_missing_asin|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="asintld_missing_asin_help_text" />


==<span id="biorxiv_missing">|biorxiv= required</span>==  
==<span id="biorxiv_missing">|biorxiv= required</span>==  
Line 105: Line 151:
To resolve this error, ensure that the template has {{para|biorxiv}} with a properly constructed value.
To resolve this error, ensure that the template has {{para|biorxiv}} with a properly constructed value.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_biorxiv_missing}}.<ref group="lower-alpha" name="categories" /><section end="biorxiv_missing_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_biorxiv_missing|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="biorxiv_missing_help_text" />


==<span id="chapter_ignored">|chapter= ignored</span>==
==<span id="chapter_ignored">|chapter= ignored</span>==
<section begin="chapter_ignored_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_chapter_ignored|$1=chapter}}
<section begin="chapter_ignored_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_chapter_ignored|$1=chapter}}


{{cs1}} templates {{tlx|cite web}}, {{tlx|cite news}}, {{tlx|cite journal}}, {{tlx|cite press release}}, {{tlx|cite podcast}}, {{tlx|cite newsgroup}}, as well as template {{tlx|citation}} when it uses {{para|work}} or any of its aliases, do not support {{para|chapter}} or the aliases {{para|contribution}}, {{para|entry}}, {{para|article}}, or {{para|section}}.
{{cs1}} templates {{tlx|cite web}}, {{tlx|cite news}}, {{tlx|cite journal}}, {{tlx|cite magazine}}, {{tlx|cite press release}}, {{tlx|cite podcast}}, {{tlx|cite newsgroup}}, as well as template {{tlx|citation}} when it uses {{para|work}} or any of its aliases, do not support {{para|chapter}} and its components {{para|trans-chapter}}, {{para|script-chapter}}, {{para|chapter-url}}, and {{para|chapter-format}}.  The alias parameters {{para|contribution}}, {{para|entry}}, {{para|article}}, {{para|section}}, and their components, are similarly not supported.


To resolve this error:
To resolve this error:
Line 118: Line 164:
* for {{tl|cite news}}, {{para|department}} can be used to give the name of the newspaper's section, such as "Obituaries", or
* for {{tl|cite news}}, {{para|department}} can be used to give the name of the newspaper's section, such as "Obituaries", or
* for {{tl|citation}}, remove {{para|work}} or its aliases such as {{para|website}} and place their content in {{para|title}} if appropriate
* for {{tl|citation}}, remove {{para|work}} or its aliases such as {{para|website}} and place their content in {{para|title}} if appropriate
* move the content of the {{para|chapter}} parameter out of the template, before the closing <nowiki></ref></nowiki>


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_chapter_ignored}}.<ref group="lower-alpha" name="categories" /><section end="chapter_ignored_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_chapter_ignored|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="chapter_ignored_help_text" />


==<span id="invisible_char">&lt;char> character in |&lt;param>= at position ''n''</span>==
==<span id="invisible_char">&lt;char> character in |&lt;param>= at position ''n''</span>==
Line 130: Line 177:
* [[replacement character]], U+FFFD
* [[replacement character]], U+FFFD
* [[hair space]], U+200A
* [[hair space]], U+200A
* [[zero width space]], U+200B
* [[zero-width space]], U+200B
* [[zero width joiner]], U+200D
* [[zero-width joiner]], U+200D (note that these are permitted as part of emoji modifiers; see note below)
* [[horizontal tab]], U+0009 (HT)
* [[horizontal tab]], U+0009 (HT)
* [[line feed]], U+0010 (LF)
* [[line feed]], U+0010 (LF)
Line 139: Line 186:
* [[C0 and C1 control codes|C1 control]], U+0080–U+009F (XXX–APC)
* [[C0 and C1 control codes|C1 control]], U+0080–U+009F (XXX–APC)


To resolve invisible-character errors, remove or replace the identified character. Because these characters are mostly invisible, the error message identifies the character's position in the parameter value counted from the left. Space characters between the assignment operator (the '=' sign) and the parameter value are not counted. If you move through the citation with the arrow keys then the cursor may stand still once at an invisible character which can be removed with {{keypress|Delete}} or {{keypress|Backspace}}. If you copy-paste a string to the "Characters" field at https://r12a.github.io/app-conversion/ and click "View in UniView" then the position and name of all characters is shown.
To resolve invisible-character errors, remove or replace the identified character. Most intentional white-space characters should be replaced with a normal space character (i.e. press your keyboard's space bar). See [[MOS:NBSP]] for guidance on insertion of intentional non-breaking spaces. 
 
Because these characters are mostly invisible, the error message identifies the character's position in the parameter value counted from the left. Space characters between the assignment operator (the '=' sign) and the parameter value are not counted. If you move through the citation with the arrow keys then the cursor may stand still once at an invisible character, which can be removed with {{keypress|Delete}} or {{keypress|Backspace}}. If you copy-paste a string to the "Characters" field at https://r12a.github.io/app-conversion/ and click "View in UniView" then the position and name of all characters is shown.
 
[[Zero-width joiner]] characters (U+200D) are used as a valid part of emoji modification (for example, adding a skull emoji to a flag emoji to create a pirate flag emoji). When new modifiers are added to the emoji character set, which happens one or two times per year, those modifiers need to be added to the Citation Style 1 "Configuration" module. Editors can request this addition at [[Help talk:Citation Style 1]].  


{{#invoke:Cs1 documentation support|help_text_error_messages|err_invisible_char|$1=&lt;name> stripmarker|$2=<code class="cs1-code">{{pipe}}&lt;param>=</code>|$3={{var|n}}}}
{{#invoke:Cs1 documentation support|help_text_error_messages|err_invisible_char|$1=&lt;name> stripmarker|$2=<code class="cs1-code">{{pipe}}&lt;param>=</code>|$3={{var|n}}}}


[[Help:Strip markers|Strip markers]] are special sequences of characters that [[MediaWiki]] inserts as a place-holder for certain [[xml]]-like tags.  These tags include {{tag|gallery}}, {{tag|math}}, {{tag|nowiki}}, {{tag|pre}}, and {{tag|ref}}.  The strip markers are replaced with content before the final page rendering.  The module ignores math and nowiki strip markers.
[[Help:Strip markers|Strip markers]] are special sequences of characters that [[MediaWiki]] inserts as a place-holder for certain [[XML]]-like tags.  These tags include {{tag|gallery}}, {{tag|math}}, {{tag|nowiki}}, {{tag|pre}}, and {{tag|ref}}.  The strip markers are replaced with content before the final page rendering.  The module ignores math and nowiki strip markers.


To resolve strip marker errors, remove or replace the identified tag.  The error message identifies the strip marker's position in the parameter value counted from the left.  Space characters between the assignment operator (the '=' sign) and the parameter value are not counted.
To resolve strip marker errors, remove or replace the identified tag.  The error message identifies the strip marker's position in the parameter value counted from the left.  Space characters between the assignment operator (the '=' sign) and the parameter value are not counted when calculating the position.


Strip marker errors can also be caused by unsupported additional text or templates in parameter values{{mdash}}for example, {{tl|ISBN}} in {{para|title}}. Resolve the problem by moving the extraneous text outside of the citation template or by removing the extraneous text or template markup, as appropriate.
Strip marker errors can also be caused by unsupported additional text or templates in parameter values{{mdash}}for example, {{tl|ISBN}} in {{para|title}}. Resolve the problem by moving the extraneous text outside the citation template, or by removing the extraneous text or template markup, as appropriate.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_invisible_char}}.<ref group="lower-alpha" name="categories" /><section end="invisible_char_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_invisible_char|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="invisible_char_help_text" />


==<span id="bad_arxiv">Check |arxiv= value</span>==  
==<span id="bad_arxiv">Check |arxiv= value</span>==  
Line 158: Line 209:
To resolve this error, ensure that the {{para|arxiv}} value is correct.
To resolve this error, ensure that the {{para|arxiv}} value is correct.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_arxiv}}.<ref group="lower-alpha" name="categories" /><section end="bad_arxiv_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_arxiv|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_arxiv_help_text" />


==<span id="bad_asin">Check |asin= value</span>==  
==<span id="bad_asin">Check |asin= value</span>==  
Line 167: Line 218:
To resolve this error, ensure that the {{para|asin}} value is correct.
To resolve this error, ensure that the {{para|asin}} value is correct.


If the {{para|asin}} value is correct and all-numeric, use {{para|isbn}} instead and delete any {{para|asin-tld}} parameters.  Articles with CS1 citations that use {{para|asin}} with all numeric values are categorized in {{cl|CS1 maint: ASIN uses ISBN}}.
If the {{para|asin}} value is correct and all-numeric, use {{para|isbn}} instead and delete any {{para|asin-tld}} parameters.   


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_asin}}.<ref group="lower-alpha" name="categories" /><section end="bad_asin_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_asin|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_asin_help_text" />
 
==<span id="bad_asin_tld">Check |asin-tld= value</span>==
<section begin="bad_asin-tld_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_asin_tld}}
 
{{cs1}} and {{cs2}} templates contain a test for known {{para|asin-tld}} values to specify the [[top-level domain]] (TLD) of a given [[ASIN]] identifier link. The list of currently supported values is:
 
<section begin="asin-tld_values_list" /><code>ae</code>, <code>au</code>, <code>br</code>, <code>ca</code>, <code>cn</code>, <code>de</code>, <code>es</code>, <code>fr</code>, <code>in</code>, <code>it</code>, <code>jp</code>, <code>mx</code>, <code>nl</code>, <code>pl</code>, <code>sa</code>, <code>se</code>, <code>sg</code>, <code>tr</code>, <code>uk</code><section end="asin-tld_values_list" />
 
It is not necessary to provide {{para|asin-tld}} to specify the default (United States). If you want to specify this condition explicitly, a pseudo-value of <code>us</code> can be given to denote this.
 
All these values are automatically resolved to the correct TLD following one of the schemes <code>''nn''</code>, <code>com.''nn''</code>, <code>co.''nn''</code>, <code>z.''nn''</code>, and <code>com</code>.
 
If an unsupported value is encountered, the template will issue this error message.
 
To resolve this error, ensure that the {{para|asin-tld}} value is correct.
 
If the value is correct, please report this at [[Help talk:Citation Style 1]], so that it can be added to the list of supported values.
 
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_asin_tld|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_asin-tld_help_text" />


==<span id="bad_bibcode">Check |bibcode= &lt;message></span>==  
==<span id="bad_bibcode">Check |bibcode= &lt;message></span>==  
Line 185: Line 255:
To resolve this error, ensure that the {{para|bibcode}} value is correct.
To resolve this error, ensure that the {{para|bibcode}} value is correct.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_bibcode}}.<ref group="lower-alpha" name="categories" /><section end="bad_bibcode_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_bibcode|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_bibcode_help_text" />


==<span id="bad_biorxiv">Check |biorxiv= value</span>==  
==<span id="bad_biorxiv">Check |biorxiv= value</span>==  
<section begin="bad_biorxiv_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_biorxiv}}
<section begin="bad_biorxiv_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_biorxiv}}


When {{cs1}} and {{cs2}} templates contain {{para|biorxiv}}, a test is done to see if the [[bioRxiv]] identifier has the proper form.  There are two valid forms:
When {{cs1}} and {{cs2}} templates contain {{para|biorxiv}}, a test is done to see if the [[bioRxiv]] identifier has the proper form.  There are two valid forms, each beginning with bioRxiv's doi directory indicator and registrant code (10.1101) and followed by:
: six numeric characters without punctuation or spaces.
: six numeric characters without punctuation or spaces:
::{{para|biorxiv|10.1101/######}}
::: <code>######</code> – 6-digit bioRxiv identifier
: ymd format date prefix followed by six numeric characters without punctuation or spaces followed by optional version:
: ymd format date prefix followed by six numeric characters without punctuation or spaces followed by optional version:
:: {{para|biorxiv|yyyy.mm.dd.######v#}} where:
:: {{para|biorxiv|10.1101/yyyy.mm.dd.######v#}} where:
::: <code>yyyy.mm.dd.</code> – represents a date no earlier than 11 December 2019 (<code>2019.12.11.</code>) and no later than tomorrow's date; date must be a valid date
::: <code>yyyy.mm.dd.</code> – represents a date no earlier than 11 December 2019 (<code>2019.12.11.</code>) and no later than tomorrow's date; date must be a valid date
::: <code>######</code> – 6-digit bioRxiv identifier
::: <code>######</code> – 6-digit bioRxiv identifier
::: <code>v#</code> – optional version indicator
::: <code>v#</code> – optional version indicator


A common error is to include the bioRxiv ''URL'' (<code><nowiki>https://dx.doi.org/10.1101/</nowiki>{{red|&lt;{{var|BIORXIV>}}}}</code>), or the biorxiv ''DOI'' (<code>10.1101/{{red|&lt;{{var|BIORXIV>}}}}</code>).
A common error is to include the bioRxiv ''URL'' (<code>{{red|<nowiki>https://dx.doi.org/</nowiki>}}10.1101/######}}</code>).


To resolve this error, ensure that the {{para|biorxiv}} value is correct.
To resolve this error, ensure that the {{para|biorxiv}} value is correct.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_biorxiv}}.<ref group="lower-alpha" name="categories" /><section end="bad_biorxiv_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_biorxiv|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_biorxiv_help_text" />


==<span id="bad_citeseerx">Check |citeseerx= value</span>==  
==<span id="bad_citeseerx">Check |citeseerx= value</span>==  
Line 212: Line 284:
For instance, if you want to link to <code>http://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.220.7880</code>, use {{para|citeseerx|10.1.1.220.7880}}.
For instance, if you want to link to <code>http://citeseerx.ist.psu.edu/viewdoc/summary?doi=10.1.1.220.7880</code>, use {{para|citeseerx|10.1.1.220.7880}}.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_citeseerx}}.<ref group="lower-alpha" name="categories" /><section end="bad_citeseerx_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_citeseerx|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_citeseerx_help_text" />


==<span id="bad_date">Check date values in: |&lt;param1>=, |&lt;param2>=, ...</span>==
==<span id="bad_date">Check date values in: |&lt;param1>=, |&lt;param2>=, ...</span>==
<section begin="bad_date_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_date|$1=<code class="cs1-code">{{pipe}}&lt;param1>=</code>, <code class="cs1-code">{{pipe}}&lt;param2>=</code>, ...}}
<section begin="bad_date_help_text" />{{help desk}}
{{plainlist}}
*{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_date|$1=<code class="cs1-code">{{pipe}}&lt;param1>=</code>, <code class="cs1-code">{{pipe}}&lt;param2>=</code>, ...}}
*{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_date|$1=<code class="cs1-code">{{pipe}}year=</code> / <code class="cs1-code">{{pipe}}date=</code> mismatch}}
{{endplainlist}}


When {{cs1}} and {{cs2}} templates contain date-holding parameters, an automated test is done to see if the dates are real dates that comply with a [[Help:Citation_Style_1#Date_compliance_with_Wikipedia's_Manual_of_Style|subset of the date rules]] in  Wikipedia's Manual of Style, specifically checking for violations of [[Wikipedia:Manual of Style/Dates and numbers#Dates and years|MOS:DATEFORMAT]].
When {{cs1}} and {{cs2}} templates contain date-holding parameters, an automated test is done to see if the dates are real dates that comply with a [[Help:Citation_Style_1#Date_compliance_with_Wikipedia's_Manual_of_Style|subset of the date rules]] in  Wikipedia's Manual of Style, specifically checking for violations of [[Wikipedia:Manual of Style/Dates and numbers#Dates and years|MOS:DATEFORMAT]].
Line 223: Line 299:
* {{para|access-date}} must specify a day, not just a month or year.
* {{para|access-date}} must specify a day, not just a month or year.
* misplaced, incorrect, or extraneous punctuation
* misplaced, incorrect, or extraneous punctuation
* misplaced, incorrect, or extraneous spacing
* extraneous text  
* extraneous text  
* hyphens or slashes instead of en dashes in date ranges (en dashes are required)  
* hyphens or slashes instead of en dashes in date ranges (en dashes are required)  
Line 230: Line 307:
* years before 100 AD, including BCE/BC dates. Try using parameter {{para|orig-date}} instead.  
* years before 100 AD, including BCE/BC dates. Try using parameter {{para|orig-date}} instead.  


See [[Help:Citation_Style_1#CS1_compliance_with_Wikipedia.27s_Manual_of_Style|Help: Citation Style 1]] for information about limitations in the CS1 citation templates' handling of date formats. [[WP:DATERANGE|The MOS section on date ranges]] describes how to separate dates in a date range. Do not use <code>&amp;nbsp;</code>, <code>&amp;ndash;</code>, or {{tlx|spaced ndash}} as these corrupt the metadata. To add an en dash, use the [[Help:CharInsert#Insert|CharInsert]] edit tool or see [[Wikipedia:How to make dashes]]. You may also use this one: &ndash;. A bot is often able to correct the separator, provided the overall format is unambiguous.
See [[Help:Citation_Style_1#CS1_compliance_with_Wikipedia.27s_Manual_of_Style|Help: Citation Style 1]] for information about limitations in the CS1 citation templates' handling of date formats. [[WP:DATERANGE|The MOS section on date ranges]] describes how to separate dates in a date range. Do not use <code>&amp;nbsp;</code>, <code>&amp;ndash;</code>, or {{tlx|spaced ndash}} as these corrupt the metadata. To add an en dash, use the [[Help:CharInsert#Insert|CharInsert]] edit tool or see [[Wikipedia:How to make dashes]]. You may also copy and paste this one: &ndash;. A bot is often able to correct the separator, provided the overall format is unambiguous.


Future dates in {{para|date}} in CS1|2 citations are limited to current year + 1; that is, for {{#time:Y}}, citation dates in {{#time:Y|now +1 year}} are acceptable but citation dates in {{#time:Y|now +2 year}} and beyond are not.
Future dates in {{para|date}} in CS1|2 citations are limited to current year + 1; that is, for {{#time:Y}}, citation dates in {{#time:Y|now +1 year}} are acceptable but citation dates in {{#time:Y|now +2 year}} and beyond are not.
Line 238: Line 315:
The access date (in {{para|access-date}}) is checked to ensure that it contains a full date (day, month, and year) and is between 15 January 2001 (the founding date of Wikipedia) and today's date plus one day, because it represents the date that an editor viewed a web-based source to verify a statement on Wikipedia. Because editors may be in time zones that are one day ahead of the UTC date, one extra day is accepted.
The access date (in {{para|access-date}}) is checked to ensure that it contains a full date (day, month, and year) and is between 15 January 2001 (the founding date of Wikipedia) and today's date plus one day, because it represents the date that an editor viewed a web-based source to verify a statement on Wikipedia. Because editors may be in time zones that are one day ahead of the UTC date, one extra day is accepted.
   
   
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_date}}.<ref group="lower-alpha" name="categories" /><section end="bad_date_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_date|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_date_help_text" />
{{anchor|Date Fix Table|Dates|DateFixTable}}
{{anchor|Date Fix Table|Dates|DateFixTable}}
{{anchor|ExamplesOfUnacceptableDates}}
{{anchor|ExamplesOfUnacceptableDates}}
Line 248: Line 325:
| Hyphen in date range (use en dash) || {{para|plain=y|date|2002{{red|-}}2003}} || {{para|plain=y|date|2002{{green|–}}2003}}
| Hyphen in date range (use en dash) || {{para|plain=y|date|2002{{red|-}}2003}} || {{para|plain=y|date|2002{{green|–}}2003}}
|-
|-
| Slash in date range (use en dash) || {{para|plain=y|date|2002{{red|/}}2003}} or {{para|plain=y|date|July{{red|/}}August 2003}}||{{para|plain=y|date|2002{{green|–}}2003}} or {{para|plain=y|date|July{{green|–}}August 2003}}
| Slash in date range (use en dash) || {{para|plain=y|date|2002{{red|/}}2003}} or {{para|plain=y|date|July{{red|/}}August 2003}}||{{para|plain=y|date|2002{{green|–}}2003}} or {{para|plain=y|date|July{{green|–}}August 2003}}
|-
|-
| Hyphen in date range (use en dash) || {{para|plain=y|date|April{{red|-}}May 2004}} || {{para|plain=y|date|April{{green|–}}May 2004}}
| Hyphen in date range (use en dash) || {{para|plain=y|date|April{{red|-}}May 2004}} || {{para|plain=y|date|April{{green|–}}May 2004}}
|-
|-
| Missing space around en dash for range of full dates || {{para|plain=y|date|April 2003{{red|–}}May 2004}} || {{para|plain=y|date|April 2003 {{green|–}} May 2004}}
| Missing space around en dash for range of full dates || {{para|plain=y|date|April 2003{{red|–}}May 2004}} || {{para|plain=y|date|April 2003 {{green|–}} May 2004}}
|-
|-
| Month capitalization || {{para|plain=y|date|28 {{red|f}}ebruary 1900}} || {{para|plain=y|date|28 {{green|F}}ebruary 1900}}
| Month capitalization || {{para|plain=y|date|28 {{red|f}}ebruary 1900}} || {{para|plain=y|date|28 {{green|F}}ebruary 1900}}
|-
|-
| Month capitalization || {{para|plain=y|date|28 F{{red|EBRUARY}} 1900}} || {{para|plain=y|date|28 F{{green|ebruary}} 1900}}
| Month capitalization || {{para|plain=y|date|28 F{{red|EBRUARY}} 1900}} || {{para|plain=y|date|28 F{{green|ebruary}} 1900}}
|-
|-
| Season capitalization || {{para|plain=y|date|{{red|s}}pring 2011}} || {{para|plain=y|date|{{green|S}}pring 2011}}
| Season capitalization || {{para|plain=y|date|{{red|s}}pring 2011}} || {{para|plain=y|date|{{green|S}}pring 2011}}
Line 284: Line 361:
| Comma in season || {{para|plain=y|date|Winter{{red|,}} 1900–1901}} || {{para|plain=y|date|Winter 1900–1901}}
| Comma in season || {{para|plain=y|date|Winter{{red|,}} 1900–1901}} || {{para|plain=y|date|Winter 1900–1901}}
|-
|-
| Missing comma in format which requires it || {{para|plain=y|date|{{red|February 28 1900}}}} || {{para|plain=y|date|February 28{{green|,}} 1900}} or {{para|plain=y|date|28 February 1900}}
| Missing comma in format which requires it || {{para|plain=y|date|{{red|February 28 1900}}}} || {{para|plain=y|date|February 28{{green|,}} 1900}} or {{para|plain=y|date|28 February 1900}} or {{para|plain=y|date|1900-02-28}}
|-
|-
| Non-date text || {{para|plain=y|date|2008{{red|, originally 2000}}}} || {{para|plain=y|date|2008}} {{green|{{para|plain=y|orig-date|2000}}}}
| Non-date text || {{para|plain=y|date|2008{{red|, originally 2000}}}} || {{para|plain=y|date|2008}} {{green|{{para|plain=y|orig-date|2000}}}}
|-
|-
| Zero-padding || {{para|plain=y|date|January {{red|04}}, 1987}} || {{para|plain=y|date|January {{green|4}}, 1987}}
| Zero-padding || {{para|plain=y|date|January {{red|04}}, 1987}} || {{para|plain=y|date|January {{green|4}}, 1987}}
|-
|-
| Date with slashes || {{para|plain=y|date|12{{red|/}}6{{red|/}}87}} || {{plainlist|
| Date with slashes || {{para|plain=y|date|12{{red|/}}6{{red|/}}87}} || {{para|plain=y|date|{{green|December 6, 19}}87}} or {{para|plain=y|date|{{green|6 December 19}}87}} or {{para|plain=y|date|{{green|1987-12-06}}}}<br/>or<br/>{{para|plain=y|date|{{green|12 June 19}}87}} or {{para|plain=y|date|{{green|June 12, 19}}87}} or {{para|plain=y|date|{{green|1987-06-12}}}}
* {{para|plain=y|date|{{green|December 6, 19}}87}}
* {{para|plain=y|date|{{green|12 June 19}}87}}}}
|-
|-
| Two-digit year || {{para|plain=y|date|{{red|87}}-12-06}} || {{para|plain=y|date|{{green|19}}87-12-06}}
| Two-digit year || {{para|plain=y|date|{{red|87}}-12-06}} || {{para|plain=y|date|{{green|19}}87-12-06}}
|-
|-
| One-digit month or day || {{para|plain=y|date|2007-{{red|3}}-{{red|6}}}} || {{para|plain=y|date|2007-{{green|03}}-{{green|06}}}}
| One-digit month or day || {{para|plain=y|date|2007-{{red|3}}-{{red|6}}}} || {{para|plain=y|date|2007-{{green|03}}-{{green|06}}}}
Line 300: Line 375:
| Wikified date || {{para|plain=y|date|{{red|<nowiki>[[</nowiki>}}April 1{{red|<nowiki>]]</nowiki>}}, {{red|<nowiki>[[</nowiki>}}1999{{red|<nowiki>]]</nowiki>}} }} || {{para|plain=y|date|{{green|April 1, 1999}}}}
| Wikified date || {{para|plain=y|date|{{red|<nowiki>[[</nowiki>}}April 1{{red|<nowiki>]]</nowiki>}}, {{red|<nowiki>[[</nowiki>}}1999{{red|<nowiki>]]</nowiki>}} }} || {{para|plain=y|date|{{green|April 1, 1999}}}}
|-
|-
| "mm-dd-yyyy" or "dd-mm-yyyy" date format || {{para|plain=y|date|{{red|07-12-}}2009}} || {{para|plain=y|date|{{green|7 December}} 2009}} or {{para|plain=y|date|{{green|12 July}} 2009}}<br />or<br />{{para|plain=y|date|{{green|July 12,}} 2009}} or {{para|plain=y|date|{{green|December 7,}} 2009}}
| "mm-dd-yyyy" or "dd-mm-yyyy" date format || {{para|plain=y|date|{{red|07-12-}}2009}} || {{para|plain=y|date|{{green|7 December}} 2009}} or {{para|plain=y|date|{{green|12 July}} 2009}}<br />or<br />{{para|plain=y|date|{{green|July 12,}} 2009}} or {{para|plain=y|date|{{green|December 7,}} 2009}}<br />or <br />{{para|plain=y|date|2009-{{green|07-12}}}} or {{para|plain=y|date|2009-{{green|12-07}}}}
|-
| Quarters || {{para|plain=y|date|{{red|3Q}} 1984}} or {{para|plain=y|date|{{red|3rd Qtr.,}} 1984}} or {{para|plain=y|date|{{red|Third quarter}} 1984}} || {{para|plain=y|date|{{green|Third Quarter}} 1984}}
|-
| Named dates || {{para|plain=y|date|{{red|Xmas}} 1984}} or {{para|plain=y|date|{{red|christmas}} 1984}} || {{para|plain=y|date|{{green|Christmas}} 1984}}
|-
|-
| Approximate or uncertain dates || {{para|plain=y|date|{{red|circa}} 1970}} or {{para|plain=y|date|{{red|<nowiki>{{circa}}</nowiki>}} 1970}} ||{{para|plain=y|date|{{green|c.}} 1970}}
| Approximate or uncertain dates || {{para|plain=y|date|{{red|circa}} 1970}} or {{para|plain=y|date|{{red|<nowiki>{{circa}}</nowiki>}} 1970}} || {{para|plain=y|date|{{green|c.}} 1970}}
|-
|-
|}
|}
Line 324: Line 403:
In very rare cases, publishers have released works with a DOI deviating from the standard form. If you are certain that such a non-conforming DOI truly corresponds to the published work, then you can add [[Help:Citation_Style_1#Accept-this-as-written_markup|accept-this-as-written markup]] around the identifier to suppress the error message. (Do not use this markup for DOIs, which are ''inactive'' rather than ''non-conforming''. Instead, use {{para|doi-broken-date}} for them.)
In very rare cases, publishers have released works with a DOI deviating from the standard form. If you are certain that such a non-conforming DOI truly corresponds to the published work, then you can add [[Help:Citation_Style_1#Accept-this-as-written_markup|accept-this-as-written markup]] around the identifier to suppress the error message. (Do not use this markup for DOIs, which are ''inactive'' rather than ''non-conforming''. Instead, use {{para|doi-broken-date}} for them.)


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_doi}}.<ref group="lower-alpha" name="categories" /><section end="bad_doi_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_doi|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_doi_help_text" />


==<span id="bad_hdl">Check |hdl= value</span>==
==<span id="bad_hdl">Check |hdl= value</span>==
Line 333: Line 412:
To resolve this error, ensure that the {{para|hdl}} value is correct.
To resolve this error, ensure that the {{para|hdl}} value is correct.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_hdl}}.<ref group="lower-alpha" name="categories" /><section end="bad_hdl_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_hdl|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_hdl_help_text" />


==<span id="bad_isbn">Check |isbn= value</span>==
==<span id="bad_isbn">Check |isbn= value</span>==
Line 360: Line 439:
See also [[Wikipedia:ISBN]].
See also [[Wikipedia:ISBN]].


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_isbn}}.<ref group="lower-alpha" name="categories" /><!-- See [[bugzilla:47049]] about {{FULLPAGENAME}}, category pagenames containing ISBN, and #ifeq: --><section end="bad_isbn_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_isbn|pages=yes}}.<ref group="lower-alpha" name="categories" /><!-- See [[bugzilla:47049]] about {{FULLPAGENAME}}, category pagenames containing ISBN, and #ifeq: --><section end="bad_isbn_help_text" />


==<span id="bad_ismn">Check |ismn= value</span>==
==<span id="bad_ismn">Check |ismn= value</span>==
Line 369: Line 448:
To resolve this error, ensure that the {{para|ismn}} value is correct, that only one ISMN is used, that the proper optional separators are used, and that no other text is included. Make sure that the ISMN contains exactly 13 digits.
To resolve this error, ensure that the {{para|ismn}} value is correct, that only one ISMN is used, that the proper optional separators are used, and that no other text is included. Make sure that the ISMN contains exactly 13 digits.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_ismn}}.<ref group="lower-alpha" name="categories" /><section end="bad_ismn_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_ismn|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_ismn_help_text" />


==<span id="bad_issn">Check |issn= value</span>==
==<span id="bad_issn">Check |issn= value</span>==
<section begin="bad_issn_help_text" />{{help desk}}
<section begin="bad_issn_help_text" />{{help desk}}
<div class="plainlist">
{{plainlist}}
*{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_issn|$1=_}}
*{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_issn|$1=_}}
*{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_issn|$1=e}}
*{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_issn|$1=e}}
</div>
{{endplainlist}}


{{cs1}} and {{cs2}} templates that contain {{para|issn}} and/or {{para|eissn}} are checked to ensure that the [[ISSN]] is the proper length (eight digits) and that the final [[check digit]] validates according to the ISSN specification. Only one each of ISSN and eISSN is allowed in this field because the whole {{para|issn}} and {{para|eissn}} values are included in the citation's [[COinS]] [[metadata]]. See also [[Wikipedia:COinS]]. (If relevant, they can be specified using {{para|id|{{tlp|ISSN|...}} {{tlp|EISSN|...}}}} instead.)
{{cs1}} and {{cs2}} templates that contain {{para|issn}} and/or {{para|eissn}} are checked to ensure that the [[ISSN]] is the proper length (eight digits) and that the final [[check digit]] validates according to the ISSN specification. Only one each of ISSN and eISSN is allowed in this field because the whole {{para|issn}} and {{para|eissn}} values are included in the citation's [[COinS]] [[metadata]]. See also [[Wikipedia:COinS]]. (If relevant, they can be specified using {{para|id|{{tlp|ISSN|...}} {{tlp|EISSN|...}}}} instead.)
Line 382: Line 461:
The ISSN and eISSN are always rendered as two four-digit numbers separated with a hyphen.
The ISSN and eISSN are always rendered as two four-digit numbers separated with a hyphen.


To resolve this error, ensure that the {{para|issn}} and {{para|eissn}} values are correct, that only one value per parameter is used, and that no other text is included (allowable characters are 0–9, X, and -). If the check-digit is a lowercase 'x', change it to an uppercase 'X'.
To resolve this error, ensure that the {{para|issn}} and {{para|eissn}} values are correct, that only one value per parameter is used, and that no other text is included (allowable characters are 0–9, X, and -). If the check-digit is a lowercase 'x', change it to an uppercase 'X'. It may also be worth checking an actual [[hyphen]] (-) has been used, and not a hyphen-like character like an [[endash]] (–).


In very rare cases, publishers have released works with a malformed identifier. If you are certain that a non-conforming identifier truly corresponds to the published work, then you can add [[Help:Citation_Style_1#Accept-this-as-written_markup|accept-this-as-written markup]] around the identifier to suppress the error message. In some cases, works may have been reissued with a corrected identifier. Use the corrected one when possible.
In very rare cases, publishers have released works with a malformed identifier. If you are certain that a non-conforming identifier truly corresponds to the published work, then you can add [[Help:Citation_Style_1#Accept-this-as-written_markup|accept-this-as-written markup]] around the identifier to suppress the error message. In some cases, works may have been reissued with a corrected identifier. Use the corrected one when possible.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_issn}}.<ref group="lower-alpha" name="categories" /><!-- See [[bugzilla:47049]] about {{FULLPAGENAME}}, category pagenames containing ISSN, and #ifeq: --><section end="bad_issn_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_issn|pages=yes}}.<ref group="lower-alpha" name="categories" /><!-- See [[bugzilla:47049]] about {{FULLPAGENAME}}, category pagenames containing ISSN, and #ifeq: --><section end="bad_issn_help_text" />


==<span id="bad_jfm">Check |jfm= value</span>==
==<span id="bad_jfm">Check |jfm= value</span>==
Line 395: Line 474:
To resolve this error, ensure that the {{para|jfm}} value is correct.
To resolve this error, ensure that the {{para|jfm}} value is correct.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_jfm}}.<ref group="lower-alpha" name="categories" /><section end="bad_jfm_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_jfm|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_jfm_help_text" />
 
==<span id="bad_jstor">Check |jstor= value</span>==
<section begin="bad_jstor_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_jstor}}
 
When {{cs1}} and {{cs2}} templates contain {{para|jstor}}, a test is done to see if the [[JSTOR (identifier)|JSTOR]] identifier value looks like a properly defined value.  Error messages are emitted when the assigned value has some form of the string 'jstor' (case-agnostic), or has a URI scheme (<code>http://</code> or <code>https://</code>), or has any space characters.
 
To resolve this error, ensure that the {{para|jstor}} value is correct.
 
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_jstor|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_jstor_help_text" />


==<span id="bad_lccn">Check |lccn= value</span>==
==<span id="bad_lccn">Check |lccn= value</span>==
<section begin="bad_lccn_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_lccn}}
<section begin="bad_lccn_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_lccn}}


The {{para|lccn}} parameter is for the [[Library of Congress Control Number]] identifier. It is checked to ensure that the identifier is the proper length and has the correct initial digits.
The {{para|lccn}} parameter is for the [[Library of Congress Control Number]] identifier. It is checked to ensure that the identifier is the proper length and has the correct initial digits.
Line 426: Line 513:
When receiving this error, be on the lookout for publishers who omitted leading zeros in the LCCN following the two or four digit year. For example, an LCCN that is [https://catalog.loc.gov/vwebv/search?searchCode=LCCN&searchArg=92035247&searchType=1&permalink=y properly 92-035427] could be shortened in the printed work to [https://books.google.com/books?id=3ocPU-S9gloC&q=35247 92-35247]. When experimenting with inserting omitted zeroes, cross-check the finished number against the LCCN permalinks online.
When receiving this error, be on the lookout for publishers who omitted leading zeros in the LCCN following the two or four digit year. For example, an LCCN that is [https://catalog.loc.gov/vwebv/search?searchCode=LCCN&searchArg=92035247&searchType=1&permalink=y properly 92-035427] could be shortened in the printed work to [https://books.google.com/books?id=3ocPU-S9gloC&q=35247 92-35247]. When experimenting with inserting omitted zeroes, cross-check the finished number against the LCCN permalinks online.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_lccn}}.<ref group="lower-alpha" name="categories" /><section end="bad_lccn_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_lccn|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_lccn_help_text" />


==<span id="bad_message_id">Check |message-id= value</span>==
==<span id="bad_message_id">Check |message-id= value</span>==
Line 437: Line 524:
To resolve this error, ensure that the {{para|message-id}} value is correct, that it contains <code>@</code> and is not wrapped in <code><...></code> characters.
To resolve this error, ensure that the {{para|message-id}} value is correct, that it contains <code>@</code> and is not wrapped in <code><...></code> characters.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_usenet_id}}.<ref group="lower-alpha" name="categories" /><section end="bad_message_id_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_usenet_id|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_message_id_help_text" />


==<span id="bad_mr">Check |mr= value</span>==
==<span id="bad_mr">Check |mr= value</span>==
Line 446: Line 533:
To resolve this error, ensure that the {{para|mr}} value is correct.
To resolve this error, ensure that the {{para|mr}} value is correct.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_mr}}.<ref group="lower-alpha" name="categories" /><section end="bad_mr_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_mr|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_mr_help_text" />


==<span id="bad_oclc">Check |oclc= value</span>==
==<span id="bad_oclc">Check |oclc= value</span>==
Line 467: Line 554:
A tip for fixing this error: Editors sometimes place valid [[ISBN]], [[LCCN]], [[ASIN]], or other identifiers in {{para|oclc}}.  
A tip for fixing this error: Editors sometimes place valid [[ISBN]], [[LCCN]], [[ASIN]], or other identifiers in {{para|oclc}}.  


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_oclc}}.<ref group="lower-alpha" name="categories" /><section end="bad_oclc_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_oclc|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_oclc_help_text" />


==<span id="bad_ol">Check |ol= value</span>==
==<span id="bad_ol">Check |ol= value</span>==
Line 476: Line 563:
To resolve this error, ensure that the {{para|ol}} value is correct. Do not include "OL" in the value.
To resolve this error, ensure that the {{para|ol}} value is correct. Do not include "OL" in the value.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_ol}}.<ref group="lower-alpha" name="categories" /><section end="bad_ol_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_ol|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_ol_help_text" />


==<span id="bad_osti">Check |osti= value</span>==
==<span id="bad_osti">Check |osti= value</span>==
<section begin="bad_osti_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_osti}}
<section begin="bad_osti_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_osti}}


The {{para|osti}} parameter is for the [[Office of Scientific and Technical Information]] (OSTI) identifier. OSTIs are checked to ensure that the identifier is a simple number without punctuation or spaces with a value between 1 and {{#invoke:Cs1 documentation support|id_limits_get|osti}}<!-- value will show after the next update -->. Further validation is not performed.
The {{para|osti}} parameter is for the [[Office of Scientific and Technical Information]] (OSTI) identifier. OSTIs are checked to ensure that the identifier is a simple number without punctuation or spaces with a value between 1018 and {{#invoke:Cs1 documentation support|id_limits_get|osti}}. Further validation is not performed.


A common error is to include the OSTI ''URL'' (<code><nowiki>https://dx.doi.org/10.2172/</nowiki>{{red|&lt;{{var|OSTI>}}}}</code>), or the OSTI ''DOI'' (<code>10.2172/{{red|&lt;{{var|OSTI>}}}}</code>).
A common error is to include the OSTI ''URL'' (<code><nowiki>https://dx.doi.org/10.2172/</nowiki>{{red|&lt;{{var|OSTI>}}}}</code>), or the OSTI ''DOI'' (<code>10.2172/{{red|&lt;{{var|OSTI>}}}}</code>).
Line 487: Line 574:
To resolve this error, ensure that the {{para|osti}} value is correct.
To resolve this error, ensure that the {{para|osti}} value is correct.


If the value is correct and larger than the currently configured limit of {{#invoke:Cs1 documentation support|id_limits_get|osti}}<!-- value will show after the next update -->, please report this at [[Help talk:Citation Style 1]], so that the limit can be updated.
If the value is correct and lower than 1018 or larger than the currently configured limit of {{#invoke:Cs1 documentation support|id_limits_get|osti}}, please report this at [[Help talk:Citation Style 1]], so that the limit can be updated.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_osti}}.<ref group="lower-alpha" name="categories" /><section end="bad_osti_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_osti|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_osti_help_text" />


==<span id="bad_paramlink">Check |&lt;param>-link= value</span>==
==<span id="bad_paramlink">Check |&lt;param>-link= value</span>==
<section begin="bad_paramlink_help_text" />{{help desk}}
<section begin="bad_paramlink_help_text" />{{help desk}}
<div class="plainlist">
{{plainlist}}
* {{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_paramlink|$1=<code class="cs1-code">&lt;param>-link</code>}}
* {{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_paramlink|$1=<code class="cs1-code">&lt;param>-link</code>}}
* {{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_paramlink|$1=<code class="cs1-code">&lt;param></code>}}
* {{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_paramlink|$1=<code class="cs1-code">&lt;param></code>}}
</div>
{{endplainlist}}


These link-holding parameters and their matching title-holding parameters are combined to create a working [[wikilink]] to a related article.
These link-holding parameters and their matching title-/name-holding parameters are combined to create a working [[wikilink]] to a related article.
{{div col|colwidth=20em}}
{| class="wikitable"
* {{para|author-link}}
|+Parameters combined to make wikilinks
* {{para|contributor-link}}
!Link-holding parameter !! title-/name-holding parameter(s)
* {{para|editor-link}}
|-
* {{para|episode-link}}
| {{para|author-link}}{{dagger}} || {{para|author}}, {{para|last}}, {{para|last}} + {{para|first}}
* {{para|interviewer-link}}
|-
* {{para|series-link}}
| {{para|contributor-link}}{{dagger}} || {{para|contributor}}, {{para|contributor-last}}, {{para|contributor-last}} + {{para|contributor-first}}
* {{para|subject-link}}
|-
* {{para|title-link}}
| {{para|editor-link}}{{dagger}} || {{para|editor}}, {{para|editor-last}}, {{para|editor-last}} + {{para|editor-first}}
* {{para|translator-link}}
|-
* {{para|author}}
| {{para|episode-link}} || {{para|episode}}
* {{para|contributor}}
|-
* {{para|editor}}
| {{para|interviewer-link}}{{dagger}} || {{para|interviewer}}, {{para|interviewer-last}}, {{para|interviewer-last}} + {{para|interviewer-first}}
* {{para|episode}}
|-
* {{para|interviewer}}
| {{para|series-link}} || {{para|series}}
* {{para|series}}
|-
* {{para|subject}}
| {{para|subject-link}}{{dagger}} || {{para|subject}}
* {{para|title}}
|-
* {{para|translator}}
| {{para|title-link}} || {{para|title}}
{{div col end}}
|-
 
| {{para|translator-link}}{{dagger}} || {{para|translator}}, {{para|translator-last}}, {{para|translator-last}} + {{para|translator-first}}
(Parameters checked for this error may also be of the form {{para|author-link{{var|n}}}} or {{para|author{{var|n}}-link}}.)
|-
|colspan="2"|{{dagger}} Parameters checked for this error may also have the enumerated forms: {{para|author-link{{var|n}}}} or {{para|author{{var|n}}-link}} etc.
|}


This error occurs when any of these {{para|&lt;param>-link}} parameters contain a wikilink or a URL, or they contain any of the characters not permitted in Wikipedia article titles per [[WP:TITLESPECIALCHARACTERS]] (except <code>_</code> (underscore), used as a replacement for spaces, and <code>#</code>, used as a [[fragment identifier]] when linking to article sections).  The prohibited characters are: <code>&lt; > [ ] | { }</code>.
This error occurs when any of these {{para|&lt;param>-link}} parameters contain a wikilink or a URL, or they contain any of the characters not permitted in Wikipedia article titles per [[WP:TITLESPECIALCHARACTERS]] (except <code>_</code> (underscore), used as a replacement for spaces, and <code>#</code>, used as a [[fragment identifier]] when linking to article sections).  The prohibited characters are: <code>&lt; > [ ] | { }</code>.
Line 531: Line 620:
: <code><nowiki>[[:fr:Période d'exil de Caravage]]</nowiki></code>
: <code><nowiki>[[:fr:Période d'exil de Caravage]]</nowiki></code>


This error can also be caused when there is a {{para|&lt;param>-link}} value and the matching {{para|&lt;param>}} parameter contains a wikilink.<!--formatting template such as {{tl|smallcaps}} or {{tl|IAST}}, which should not be used in CS1 or CS2 templates.-->
This error can also be caused when:
* there is a {{para|&lt;param>-link}} value and the matching {{para|&lt;param>}} parameter contains a wikilink.<!--formatting template such as {{tl|smallcaps}} or {{tl|IAST}}, which should not be used in CS1 or CS2 templates.-->
* {{para|first}} and {{para|&lt;param>-first}} (and enumerated forms) contain a wikilink


To resolve this error, do one of the following:
To resolve this error, do one of the following:
Line 547: Line 638:
|}-->
|}-->


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_paramlink}}.<ref group="lower-alpha" name="categories" /><section end="bad_paramlink_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_paramlink|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_paramlink_help_text" />


==<span id="bad_pmc">Check |pmc= value</span>==
==<span id="bad_pmc">Check |pmc= value</span>==
Line 558: Line 649:
If the value is correct and larger than the currently configured limit of {{#invoke:Cs1 documentation support|id_limits_get|pmc}}, please report this at [[Help talk:Citation Style 1]], so that the limit can be updated.
If the value is correct and larger than the currently configured limit of {{#invoke:Cs1 documentation support|id_limits_get|pmc}}, please report this at [[Help talk:Citation Style 1]], so that the limit can be updated.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_pmc}}.<ref group="lower-alpha" name="categories" /><section end="bad_pmc_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_pmc|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_pmc_help_text" />


==<span id="bad_pmid">Check |pmid= value</span>==
==<span id="bad_pmid">Check |pmid= value</span>==
Line 569: Line 660:
If the value is correct and larger than the currently configured limit of {{#invoke:Cs1 documentation support|id_limits_get|pmid}}, please report this at [[Help talk:Citation Style 1]], so that the limit can be updated.
If the value is correct and larger than the currently configured limit of {{#invoke:Cs1 documentation support|id_limits_get|pmid}}, please report this at [[Help talk:Citation Style 1]], so that the limit can be updated.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_pmid}}.<ref group="lower-alpha" name="categories" /><section end="bad_pmid_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_pmid|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_pmid_help_text" />


==<span id="bad_rfc">Check |rfc= value</span>==
==<span id="bad_rfc">Check |rfc= value</span>==
<section begin="bad_rfc_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_rfc}}
<section begin="bad_rfc_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_rfc}}


The {{para|rfc}} parameter is for the Internet Engineering Task Force (IETF) [[IETF RFC|RFC]] identifier (unrelated to Wikipedia's internal RfCs). IETF RFCs are checked to ensure that the identifier is a simple number without punctuation or spaces with a value between 1 and {{#invoke:Cs1 documentation support|id_limits_get|rfc}}<!-- value will show after the next update -->. Further validation is not performed.
The {{para|rfc}} parameter is for the Internet Engineering Task Force (IETF) [[IETF RFC|RFC]] identifier (unrelated to Wikipedia's internal RfCs). IETF RFCs are checked to ensure that the identifier is a simple number without punctuation or spaces with a value between 1 and {{#invoke:Cs1 documentation support|id_limits_get|rfc}}. Further validation is not performed.
 
A common error is to include the RFC ''URL'' (<code><nowiki>https://dx.doi.org/10.17487/</nowiki>{{red|&lt;{{var|RFC>}}}}</code>), or the RFC ''DOI'' (<code>10.17487/{{red|&lt;{{var|RFC>}}}}</code>).


To resolve this error, ensure that the {{para|rfc}} value is correct.
To resolve this error, ensure that the {{para|rfc}} value is correct.


If the value is correct and larger than the currently configured limit of {{#invoke:Cs1 documentation support|id_limits_get|rfc}}<!-- value will show after the next update -->, please report this at [[Help talk:Citation Style 1]], so that the limit can be updated.
If the value is correct and larger than the currently configured limit of {{#invoke:Cs1 documentation support|id_limits_get|rfc}}, please report this at [[Help talk:Citation Style 1]], so that the limit can be updated.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_rfc}}.<ref group="lower-alpha" name="categories" /><section end="bad_rfc_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_rfc|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_rfc_help_text" />


==<span id="bad_sbn">Check |sbn= value</span>==
==<span id="bad_sbn">Check |sbn= value</span>==
Line 603: Line 692:
In very rare cases, publishers have released books with malformed SBNs. If you are certain that a non-conforming SBN truly corresponds to the published work, then you can add [[Help:Citation_Style_1#Accept-this-as-written_markup|accept-this-as-written markup]] around the identifier to suppress the error message. In many cases, books may have been reissued with a corrected SBN. Use a corrected SBN when possible.
In very rare cases, publishers have released books with malformed SBNs. If you are certain that a non-conforming SBN truly corresponds to the published work, then you can add [[Help:Citation_Style_1#Accept-this-as-written_markup|accept-this-as-written markup]] around the identifier to suppress the error message. In many cases, books may have been reissued with a corrected SBN. Use a corrected SBN when possible.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_sbn}}.<ref group="lower-alpha" name="categories" /><section end="bad_sbn_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_sbn|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_sbn_help_text" />


==<span id="bad_ssrn">Check |ssrn= value</span>==
==<span id="bad_ssrn">Check |ssrn= value</span>==
Line 614: Line 703:
If the value is correct and larger than the currently configured limit of {{#invoke:Cs1 documentation support|id_limits_get|ssrn}}, please report this at [[Help talk:Citation Style 1]], so that the limit can be updated.
If the value is correct and larger than the currently configured limit of {{#invoke:Cs1 documentation support|id_limits_get|ssrn}}, please report this at [[Help talk:Citation Style 1]], so that the limit can be updated.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_ssrn}}.<ref group="lower-alpha" name="categories" /><section end="bad_ssrn_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_ssrn|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_ssrn_help_text" />


==<span id="bad_s2cid">Check |s2cid= value</span>==
==<span id="bad_s2cid">Check |s2cid= value</span>==
<section begin="bad_s2cid_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|bad_s2cid_err}}<!-- should be err_bad_s2cid -->
<section begin="bad_s2cid_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_s2cid}}


The {{para|s2cid}} parameter is for the [[Semantic Scholar]] corpus identifier. S2CIDs are checked to ensure that the identifier is a simple number without punctuation or spaces with a value between 1 and {{#invoke:Cs1 documentation support|id_limits_get|s2cid}}. Further validation is not performed.
The {{para|s2cid}} parameter is for the [[Semantic Scholar]] corpus identifier. S2CIDs are checked to ensure that the identifier is a simple number without punctuation or spaces with a value between 1 and {{#invoke:Cs1 documentation support|id_limits_get|s2cid}}. Further validation is not performed.
Line 625: Line 714:
If the value is correct and larger than the currently configured limit of {{#invoke:Cs1 documentation support|id_limits_get|s2cid}}, please report this at [[Help talk:Citation Style 1]], so that the limit can be updated.
If the value is correct and larger than the currently configured limit of {{#invoke:Cs1 documentation support|id_limits_get|s2cid}}, please report this at [[Help talk:Citation Style 1]], so that the limit can be updated.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|bad_s2cid_err}}.<ref group="lower-alpha" name="categories" /><section end="bad_s2cid_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_s2cid|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_s2cid_help_text" />


==<span id="bad_url">Check |url= value</span>==
==<span id="bad_url">Check |url= value</span>==
<section begin="bad_url_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_url|$1=<code class="cs1-code">{{pipe}}url=</code>}}
<section begin="bad_url_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_url|$1=<code class="cs1-code">{{pipe}}url=</code>}}


External links in {{cs1}} and {{cs2}} templates are made from two parts: the ''title'' ({{para|title}}, {{para|chapter}}, etc.) and the ''URL'' ({{para|url}}, {{para|archive-url}}, {{para|chapter-url}}, {{para|lay-url}}, etc.). The {{para|url}} parameter and other URL parameters must begin with a supported [[URI scheme]]. The URI schemes <code>http://</code>, <code>https://</code> and the protocol relative scheme <code>//</code> are most commonly used; <code>irc://</code>, <code>ircs://</code>, <code>ftp://</code>, <code>news:</code>, <code>mailto:</code> and <code>gopher://</code> are also supported.
External links in {{cs1}} and {{cs2}} templates are made from two parts: the ''title'' ({{para|title}}, {{para|chapter}}, etc.) and the ''URL'' ({{para|url}}, {{para|archive-url}}, {{para|chapter-url}}, {{para|lay-url}}, etc.). The {{para|url}} parameter and other URL parameters must begin with a supported [[URI scheme]]. The URI schemes <code>http://</code>, <code>https://</code>, and the protocol relative scheme <code>//</code> are most commonly used; <code>irc://</code>, <code>ircs://</code>, <code>ftp://</code>, <code>news:</code>, <code>mailto:</code> and <code>gopher://</code> are also supported.


The URL field is checked to ensure that it contains only Latin characters and does not contain spaces.  The URL may be protocol relative (begins with <code>//</code>).  If there are no spaces and the URL is not protocol relative, then the scheme must comply with <nowiki>RFC 3986</nowiki>.<ref>{{citation |mode=cs1 |contribution-url=http://tools.ietf.org/html/std66#section-3.1 |contribution=Scheme |title=Uniform Resource Identifier (URI): Generic Syntax |publisher=[[Internet Engineering Task Force]] |date=January 2005 |rfc=3986}}</ref>   
The URL field is checked to ensure that it contains only Latin characters and does not contain spaces.  The URL may be protocol relative (begins with <code>//</code>).  If there are no spaces and the URL is not protocol relative, then the scheme must comply with <nowiki>RFC 3986</nowiki>.<ref>{{citation |mode=cs1 |contribution-url=http://tools.ietf.org/html/std66#section-3.1 |contribution=Scheme |title=Uniform Resource Identifier (URI): Generic Syntax |publisher=[[Internet Engineering Task Force]] |date=January 2005 |rfc=3986}}</ref>  This error may arise when a copy-pasted URL omits the URI scheme.


Top- and second-level domain names are checked for proper form.  Generally, top-level domain names must be two or more letters; second-level domain names must be two or more letters, digits, or hyphens (first and last character must be a letter or digit).  [[Single-letter second-level domain]]s are supported for:
Top- and second-level domain names are checked for proper form.  Generally, top-level domain names must be two or more letters; second-level domain names must be two or more letters, digits, or hyphens (first and last character must be a letter or digit).  [[Single-letter second-level domain]]s are supported for:
Line 640: Line 729:
* certain letters of the [[.net]] TLD (i, q)
* certain letters of the [[.net]] TLD (i, q)
Third- and subsequent-level domain names are not checked.  The path portion of the URL is not checked.
Third- and subsequent-level domain names are not checked.  The path portion of the URL is not checked.
{{#invoke:Cs1 documentation support|help_text_error_messages|err_bad_url|$1=<code class="cs1-code">{{pipe}}archive-url=</code>}}
The cs1|2 templates expect that {{para|archive-url}} will hold a unique URL for an archived snapshot of the source identified by {{para|url}} or {{para|chapter-url}} (or any of its aliases).  This error message is emitted when the value assigned to {{para|archive-url}} is the same as the matching title or chapter URL. 


To resolve this error, ensure that {{para|url}} and other URL parameters contain valid URLs.  Online tools are available to [[Internationalized domain name|internationalize]] URLs that are written in non-Latin scripts:
To resolve this error, ensure that {{para|url}} and other URL parameters contain valid URLs.  Online tools are available to [[Internationalized domain name|internationalize]] URLs that are written in non-Latin scripts:
* {{cite web |url=https://www.verisign.com/en_US/channel-resources/domain-registry-products/idn/idn-conversion-tool/index.xhtml?loc=en_US |title=IDN Conversion Tool |website=Verisign }}
* {{cite web |url=https://www.verisign.com/en_US/channel-resources/domain-registry-products/idn/idn-conversion-tool/index.xhtml?loc=en_US |title=IDN Conversion Tool |website=Verisign }}


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_url}}.<ref group="lower-alpha" name="categories" /><section end="bad_url_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_url|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_url_help_text" />


==<span id="bad_zbl">Check |zbl= value</span>==
==<span id="bad_zbl">Check |zbl= value</span>==
Line 653: Line 746:
To resolve this error, ensure that the {{para|zbl}} value is correct.
To resolve this error, ensure that the {{para|zbl}} value is correct.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_zbl}}.<ref group="lower-alpha" name="categories" /><section end="bad_zbl_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_bad_zbl|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="bad_zbl_help_text" />


==<span id="param_unknown_empty">Cite has empty unknown parameter: &lt;param></span>==
==<span id="param_unknown_empty">Cite has empty unknown parameter: &lt;param></span>==
Line 668: Line 761:
To resolve this error, remove the extra pipe, correct the parameter name, or remove the parameter from the CS1|2 template.
To resolve this error, remove the extra pipe, correct the parameter name, or remove the parameter from the CS1|2 template.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_param_unknown_empty}}.<ref group="lower-alpha" name="categories" /><section end="param_unknown_empty_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_param_unknown_empty|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="param_unknown_empty_help_text" />


==<span id="missing_periodical"></span>Cite &lt;template> requires |&lt;param>===
==<span id="missing_periodical"></span>Cite &lt;template> requires |&lt;param>===
<section begin="missing_periodical_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_missing_periodical|$1=&lt;template>|$2=&lt;param></code>}}
<section begin="missing_periodical_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_missing_periodical|$1=&lt;template>|$2=&lt;param>}}


This error message is hidden.  To show this error message see [[Help:CS1 errors#Controlling error message display|Controlling error message display]].
This error message is hidden.  To show this error message see [[Help:CS1 errors#Controlling error message display|Controlling error message display]].
Line 690: Line 783:
In some cases, an incorrect template has been used (e.g. {{tlx|cite journal}} for a web page, book, or standalone document). The appropriate resolution in these cases is to change the incorrect template to {{tlx|cite web}}, {{tlx|cite book}}, or a different, more appropriate template.
In some cases, an incorrect template has been used (e.g. {{tlx|cite journal}} for a web page, book, or standalone document). The appropriate resolution in these cases is to change the incorrect template to {{tlx|cite web}}, {{tlx|cite book}}, or a different, more appropriate template.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_missing_periodical}}.<ref group="lower-alpha" name="categories" /><section end="missing_periodical_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_missing_periodical|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="missing_periodical_help_text" />


==<span id="deprecated_params"></span>Cite uses deprecated parameter |&lt;param>= ==
==<span id="deprecated_params"></span>Cite uses deprecated parameter |&lt;param>= ==
<section begin="deprecated_params_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_deprecated_params|$1=&lt;param></code>}}
<section begin="deprecated_params_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_deprecated_params|$1=&lt;param>}}


Over time, some parameters have become obsolete or unnecessary. When this happens, the parameters are identified as deprecated. Editors are encouraged to use other parameters that accomplish the same purpose as those that have been deprecated. The CS1|2 deprecated parameters are listed in the following table, along with recommended replacement parameters. Parameter names are case-sensitive. Editors should expect that support for deprecated parameters will be withdrawn.
Over time, some parameters have become obsolete or unnecessary. When this happens, the parameters are identified as deprecated. Editors are encouraged to use other parameters that accomplish the same purpose as those that have been deprecated. The CS1|2 deprecated parameters are listed in the following table, along with recommended replacement parameters. Parameter names are case-sensitive. Editors should expect that support for deprecated parameters will soon be withdrawn.


To resolve this error, use a supported parameter.
To resolve this error, use a supported parameter.


Plan for the future: All non-hyphenated, multiword parameter names are aliases of hyphenated multiword parameter names.  The non-hyphenated aliases exist only for legacy support.  Editors should expect that support for non-hyphenated parameter names will be withdrawn.  Choose the hyphenated form when adding parameters to a citation template.  Consider replacing non-hyphenated parameters with the hyphenated equivalents at the same time.
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_deprecated_params|pages=yes}}.<ref group="lower-alpha" name="categories" /><section begin="deprecated_params_table" />
 
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_deprecated_params}}.<ref group="lower-alpha" name="categories" /><section begin="deprecated_params_table" />
{|class="wikitable"  
{|class="wikitable"  
|+ Deprecated CS1/CS2 parameters
|+ Deprecated CS1/CS2 parameters
! Deprecated parameter
! style="width: 12em;" | Deprecated parameter
! Replace with
! Replace with
! style="width: 110px;" | Date
! style="width: 6em;" | Date
<!-- |-
| none deprecated at present
| -->
|-
| {{para|authormask}}
| {{para|author-mask}}
| October 2020
|-
|-
| {{para|authormask{{var|n}}}}
| {{para|lay-date}}<!-- none deprecated at present -->|| rowspan="4" | if the source named by these parameters is important to the Wikipedia article, create a cs1|2 template for that source with all of the appropriate bibliographic information<!-- --> || rowspan="4" |2021-01-03
| {{para|author-mask{{var|n}}}}
| October 2020
|-
|-
| {{para|author{{var|n}}mask}}
| {{para|lay-format}}
| {{para|author{{var|n}}-mask}}
| October 2020
|-
|-
| {{para|displayauthors}}
| {{para|lay-source}}
| {{para|display-authors}}
| October 2020
|-
|-
| {{para|editorlink}}
| {{para|lay-url}}
| {{para|editor-link}}
| October 2020
|-
|-
| {{para|editorlink{{var|n}}}}
| {{para|transcripturl}} || {{para|transcript-url}} || 2022-01-22
| {{para|editor-link{{var|n}}}}
|}<section end="deprecated_params_table" /><section end="deprecated_params_help_text" /><section begin="deleted_params_table" />
| October 2020
<!-- Support for the following parameter aliases was recently removed. Usage in mainspace should be about zero, and hints for them added to the suggestion list. However, as they may occasionally pop up again through copy&paste or usage of old scripts for some while, list them here as well for users coming here searching for help. -->
|-
{|class="wikitable"
| {{para|editor{{var|n}}link}}
| {{para|editor{{var|n}}-link}}
| October 2020
|-
| {{para|editors}}
| {{para|editor}} (1 editor) or {{para|editor{{var|n}}}} (more than 1 editor) or {{para|veditors}} (for Vancouver style editors). Consider {{para|editor-mask{{var|n}}}} if annotation is required.
| October 2020
|-
| {{para|ignore-isbn-error}}
| {{para|isbn|((&lt;{{var|isbn}}>))}}
| October 2020
|-
| {{para|last-author-amp}}
| {{para|name-list-style|amp}}
| October 2020
|-
| {{para|lastauthoramp}}
| {{para|name-list-style|amp}}
| October 2020
|-
| {{para|subjectlink}}
| {{para|subject-link}}
| October 2020
|-
| {{para|subjectlink{{var|n}}}}
| {{para|subject-link{{var|n}}}}
| October 2020
|-
| {{para|subject{{var|n}}link}}
| {{para|subject{{var|n}}-link}}
| October 2020
|}
<!-- Support for the following parameter aliases was recently removed. Usage in mainspace should be about zero, and hints for them added to the suggestion list. However, as they may occasionally pop up again through copy&paste or usage of old scripts for some while, list them here as well for users coming here searching for help. -->{|class="wikitable"
|+ Recently removed CS1/CS2 parameters
|+ Recently removed CS1/CS2 parameters
! Removed parameter !! Replace with !! Date
! style="width: 12em;" | Removed parameter !! Replace with !! style="width: 6em;" | Date
<!-- |-
<!-- |-
| none removed at present
| none removed at present
Line 776: Line 819:
| {{para|authorfirst}}
| {{para|authorfirst}}
| {{para|author-first}}
| {{para|author-first}}
| October 2020
| rowspan="9" | October 2020
|-
|-
| {{para|authorfirst{{var|n}}}}
| {{para|authorfirst{{var|n}}}}
| {{para|author-first{{var|n}}}}
| {{para|author-first{{var|n}}}}
| October 2020
|-
|-
| {{para|author{{var|n}}first}}
| {{para|author{{var|n}}first}}
| {{para|author{{var|n}}-first}}
| {{para|author{{var|n}}-first}}
| October 2020
|-
| {{para|authorgiven}}
| {{para|author-given}}
|-
| {{para|authorgiven{{var|n}}}}
| {{para|author-given{{var|n}}}}
|-
| {{para|author{{var|n}}given}}
| {{para|author{{var|n}}-given}}
|-
|-
| {{para|authorlast}}
| {{para|authorlast}}
| {{para|author-last}}
| {{para|author-last}}
| October 2020
|-
|-
| {{para|authorlast{{var|n}}}}
| {{para|authorlast{{var|n}}}}
| {{para|author-last{{var|n}}}}
| {{para|author-last{{var|n}}}}
| October 2020
|-
|-
| {{para|author{{var|n}}last}}
| {{para|author{{var|n}}last}}
| {{para|author{{var|n}}-last}}
| {{para|author{{var|n}}-last}}
| October 2020
|-
|-
| {{para|authorgiven}}
| {{para|authormask}}
| {{para|author-given}}
| {{para|author-mask}}
| October 2020
| January 2021
|-
|-
| {{para|authorgiven{{var|n}}}}
| {{para|authormask{{var|n}}}}
| {{para|author-given{{var|n}}}}
| {{para|author-mask{{var|n}}}}
| October 2020
| January 2021
|-
|-
| {{para|author{{var|n}}given}}
| {{para|author{{var|n}}mask}}
| {{para|author{{var|n}}-given}}
| {{para|author{{var|n}}-mask}}
| October 2020
| January 2021
|-
|-
| {{para|authorsurname}}
| {{para|authorsurname}}
| {{para|author-surname}}
| {{para|author-surname}}
| October 2020
| rowspan="3" | October 2020
|-
|-
| {{para|authorsurname{{var|n}}}}
| {{para|authorsurname{{var|n}}}}
| {{para|author-surname{{var|n}}}}
| {{para|author-surname{{var|n}}}}
| October 2020
|-
|-
| {{para|author{{var|n}}surname}}
| {{para|author{{var|n}}surname}}
| {{para|author{{var|n}}-surname}}
| {{para|author{{var|n}}-surname}}
| October 2020
|-
|-
| {{para|deadurl|yes}} <!-- deprecation already some while ago, but gets reinserted into mainspace by old scripts, so continue to list until resolved -->
| {{para|booktitle}}
| {{para|url-status|dead}}
| {{para|book-title}}
| September 2019
| May 2021
|-
| {{para|chapterurl}}
| {{para|chapter-url}}
| May 2021
|-
| {{para|conferenceurl}}
| {{para|conference-url}}
| April 2021
|-
| {{para|contributionurl}}
| {{para|contribution-url}}
| April 2021
|-
| {{para|deadurl|yes}}<!-- deprecation already some while ago, but gets reinserted into mainspace by old scripts, so continue to list until resolved -->
| rowspan="2" | {{para|url-status|dead}}
| rowspan="2" | September&nbsp;2019
|-
| {{para|dead-url|yes}}<!-- deprecation already some while ago, but gets reinserted into mainspace by old scripts, so continue to list until resolved -->
|-
|-
| {{para|dead-url|yes}} <!-- deprecation already some while ago, but gets reinserted into mainspace by old scripts, so continue to list until resolved -->
| {{para|displayauthors}}
| {{para|url-status|dead}}
| {{para|display-authors}}
| September 2019
| January 2021
|-
|-
| {{para|displayeditors}}
| {{para|displayeditors}}
| {{para|display-editors}}
| {{para|display-editors}}
| October 2020
| rowspan="12" | October 2020
|-
|-
| {{para|doi-broken}}
| {{para|doi-broken}}
| {{para|doi-broken-date}}
| {{para|doi-broken-date}}
| October 2020
|-
|-
| {{para|doi-inactive-date}}
| {{para|doi-inactive-date}}
| {{para|doi-broken-date}}
| {{para|doi-broken-date}}
| October 2020
|-
|-
| {{para|editorfirst}}
| {{para|editorfirst}}
| {{para|editor-first}}
| {{para|editor-first}}
| October 2020
|-
|-
| {{para|editorfirst{{var|n}}}}
| {{para|editorfirst{{var|n}}}}
| {{para|editor-first{{var|n}}}}
| {{para|editor-first{{var|n}}}}
| October 2020
|-
|-
| {{para|editor{{var|n}}first}}
| {{para|editor{{var|n}}first}}
| {{para|editor{{var|n}}-first}}
| {{para|editor{{var|n}}-first}}
| October 2020
|-
| {{para|editorgiven}}
| {{para|editor-given}}
|-
| {{para|editorgiven{{var|n}}}}
| {{para|editor-given{{var|n}}}}
|-
| {{para|editor{{var|n}}given}}
| {{para|editor{{var|n}}-given}}
|-
|-
| {{para|editorlast}}
| {{para|editorlast}}
| {{para|editor-last}}
| {{para|editor-last}}
| October 2020
|-
|-
| {{para|editorlast{{var|n}}}}
| {{para|editorlast{{var|n}}}}
| {{para|editor-last{{var|n}}}}
| {{para|editor-last{{var|n}}}}
| October 2020
|-
|-
| {{para|editor{{var|n}}last}}
| {{para|editor{{var|n}}last}}
| {{para|editor{{var|n}}-last}}
| {{para|editor{{var|n}}-last}}
| October 2020
|-
|-
| {{para|editorgiven}}
| {{para|editorlink}}
| {{para|editor-given}}
| {{para|editor-link}}
| October 2020
| January 2021
|-
| {{para|editorlink{{var|n}}}}
| {{para|editor-link{{var|n}}}}
| January 2021
|-
|-
| {{para|editorgiven{{var|n}}}}
| {{para|editor{{var|n}}link}}
| {{para|editor-given{{var|n}}}}
| {{para|editor{{var|n}}-link}}
| October 2020
| January 2021
|-
|-
| {{para|editor{{var|n}}given}}
| {{para|editors}}
| {{para|editor{{var|n}}-given}}
| {{para|editor}} (one editor) or {{para|editor{{var|n}}}} (more than one editor) or {{para|veditors}} (for Vancouver style editors). Consider splitting {{para|editor{{var|n}}}} into {{para|editor-first{{var|n}}}} and {{para|editor-last{{var|n}}}}, if possible. Consider {{para|editor-mask{{var|n}}}}, if annotation is required.
| October 2020
| January 2021
|-
|-
| {{para|editorsurname}}
| {{para|editorsurname}}
| {{para|editor-surname}}
| {{para|editor-surname}}
| October 2020
| rowspan="7" | October 2020
|-
|-
| {{para|editorsurname{{var|n}}}}
| {{para|editorsurname{{var|n}}}}
| {{para|editor-surname{{var|n}}}}
| {{para|editor-surname{{var|n}}}}
| October 2020
|-
|-
| {{para|editor{{var|n}}surname}}
| {{para|editor{{var|n}}surname}}
| {{para|editor{{var|n}}-surname}}
| {{para|editor{{var|n}}-surname}}
| October 2020
|-
|-
| {{para|editormask}}
| {{para|editormask}}
| {{para|editor-mask}}
| {{para|editor-mask}}
| October 2020
|-
|-
| {{para|editormask{{var|n}}}}
| {{para|editormask{{var|n}}}}
| {{para|editor-mask{{var|n}}}}
| {{para|editor-mask{{var|n}}}}
| October 2020
|-
|-
| {{para|editor{{var|n}}mask}}
| {{para|editor{{var|n}}mask}}
| {{para|editor{{var|n}}-mask}}
| {{para|editor{{var|n}}-mask}}
| October 2020
|-
|-
| {{para|embargo}}
| {{para|embargo}}
| {{para|pmc-embargo-date}}
| {{para|pmc-embargo-date}}
| October 2020
|-
| {{para|episodelink}}
| {{para|episode-link}}
| May 2021
|-
| {{para|event-format}}
| (delete)
| rowspan="3" | January 2021
|-
| {{para|eventurl}}
| (delete)
|-
| {{para|event-url}}
| (delete)
|-
|-
| {{para|ignoreisbnerror}}
| {{para|ignoreisbnerror}}
| {{para|isbn|((&lt;{{var|isbn}}>))}}
| {{para|isbn|((&lt;{{var|isbn}}>))}}
| October 2020
| October 2020
|-
| {{para|ignore-isbn-error}}
| {{para|isbn|((&lt;{{var|isbn}}>))}}
| January 2021
|-
|-
| {{para|interviewerlink}}
| {{para|interviewerlink}}
| {{para|interviewer-link}}
| {{para|interviewer-link}}
| October 2020
| rowspan="6" | October 2020
|-
|-
| {{para|interviewerlink{{var|n}}}}<!-- for completeness only -->
| {{para|interviewerlink{{var|n}}}}<!-- for completeness only -->
| {{para|interviewer-link{{var|n}}}}
| {{para|interviewer-link{{var|n}}}}
| October 2020
|-
|-
| {{para|interviewer{{var|n}}link}}<!-- for completeness only -->
| {{para|interviewer{{var|n}}link}}<!-- for completeness only -->
| {{para|interviewer{{var|n}}-link}}
| {{para|interviewer{{var|n}}-link}}
| October 2020
|-
|-
| {{para|interviewermask}}
| {{para|interviewermask}}
| {{para|interviewer-mask}}
| {{para|interviewer-mask}}
| October 2020
|-
|-
| {{para|interviewermask{{var|n}}}}<!-- for completeness only -->
| {{para|interviewermask{{var|n}}}}<!-- for completeness only -->
| {{para|interviewer-mask{{var|n}}}}
| {{para|interviewer-mask{{var|n}}}}
| October 2020
|-
|-
| {{para|interviewer{{var|n}}mask}}<!-- for completeness only -->
| {{para|interviewer{{var|n}}mask}}<!-- for completeness only -->
| {{para|interviewer{{var|n}}-mask}}
| {{para|interviewer{{var|n}}-mask}}
| October 2020
|-
| {{para|last-author-amp}}
| {{para|name-list-style|amp}}
| rowspan="2" | January 2021
|-
| {{para|lastauthoramp}}
| {{para|name-list-style|amp}}
|-
| {{para|laydate}}
| {{para|lay-date}}
| rowspan="3" | April 2021
|-
| {{para|laysource}}
| {{para|lay-source}}
|-
| {{para|layurl}}
| {{para|lay-url}}
|-
| {{para|mailinglist}}
| {{para|mailing-list}}
| rowspan="2" | May 2021
|-
| {{para|mapurl}}
| {{para|map-url}}
|-
| {{para|name-list-format}}
| {{para|name-list-style}}
| April 2021
|-
| {{para|nocat}}
| {{para|no-tracking}}
| January 2021
|-
|-
| {{para|no-cat}}
| {{para|no-cat}}
| {{para|no-tracking}}
| {{para|no-tracking}}
| October 2020
| October 2020
|-
| {{para|nopp}}
| {{para|no-pp}}
| May 2021
|-
|-
| {{para|notracking}}
| {{para|notracking}}
Line 942: Line 1,053:
| October 2020
| October 2020
|-
|-
| {{para|registration}} <!-- deprecation already some while ago, but gets reinserted into mainspace by old scripts, so continue to list until resolved -->
| {{para|publicationdate}}
| {{para|publication-date}}
| rowspan="2" | May 2021
|-
| {{para|publicationplace}}
| {{para|publication-place}}
|-
| {{para|registration}}<!-- deprecation already some while ago, but gets reinserted into mainspace by old scripts, so continue to list until resolved -->
| {{para|url-access|registration}}
| {{para|url-access|registration}}
| January 2020
| January 2020
|-
| {{para|sectionurl}}
| {{para|section-url}}
| April 2021
|-
| {{para|serieslink}}
| {{para|series-link}}
| May 2021
|-
| {{para|seriesno}}
| {{para|series-no}}
| April 2021
|-
| {{para|seriesnumber}}
| {{para|series-number}}
| January 2021
|-
|-
| {{para|series-separator}}
| {{para|series-separator}}
Line 950: Line 1,084:
| October 2020
| October 2020
|-
|-
| {{para|subscription}} <!-- deprecation already some while ago, but gets reinserted into mainspace by old scripts, so continue to list until resolved -->
| {{para|subjectlink}}
| {{para|subject-link}}
| rowspan="3" | January 2021
|-
| {{para|subjectlink{{var|n}}}}
| {{para|subject-link{{var|n}}}}
|-
| {{para|subject{{var|n}}link}}
| {{para|subject{{var|n}}-link}}
|-
| {{para|subscription}}<!-- deprecation already some while ago, but gets reinserted into mainspace by old scripts, so continue to list until resolved -->
| {{para|url-access|subscription}}
| {{para|url-access|subscription}}
| January 2020
| January 2020
|}<section end="deprecated_params_table" />
|-
<section end="deprecated_params_help_text" />
| {{para|timecaption}}
| {{para|time-caption}}
| April 2021
|-
| {{para|titlelink}}
| {{para|title-link}}
| April 2021
|-
| <s>{{para|transcripturl}}</s>
| <s>{{para|transcript-url}}</s> restored January 2022 as deprecated
| <s>May 2021</s>
|}<section end="deleted_params_table" />
 
==<span id="generic_name">Cite uses generic name</span>==
<section begin="generic_name_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_generic_name|$1=&lt;param>}}
 
Articles are listed in this category when [[Module:Citation/CS1]] identifies template author or editor name parameters that use place-holder names.  Such names may have been provided by bots or other tools that are unable to identify the source's correct names.  Pages in this category should only be added by Module:Citation/CS1.
 
CS1|2 maintains a short list of 'names' that are typically not the correct names for the cited source.  Some examples are:
{{div col begin |colwidth=15em}}
*<code>about us</code>
*<code>author</code>
*<code>collaborator</code>
*<code>contributor</code>
*<code>contact us</code>
*<code>directory</code>
*<code>editor</code>
*<code>email</code>
*<code>facebook</code>
*<code>google</code>
*<code>home page</code>
*<code>instagram</code>
*<code>interviewer</code>
*<code>linkedIn</code>
*<code>pinterest</code>
*<code>policy</code>
*<code>privacy</code>
*<code>translator</code>
*<code>tumblr</code>
*<code>twitter</code>
*<code>site name</code>
*<code>statement</code>
*<code>submitted</code>
*<code>super user</code>
*<code>user</code>
*<code>verfasser</code>
{{div col end}}
If you are aware of other common place-holder names, please report them at [[Help talk:Citation Style 1]], so that they can be added to the list.
 
To resolve this error, replace the place-holder name with the source's actual author or editor name, or use a more appropriate parameter.
 
Example fixes:
* Replace {{para|author|Smith, Jane, editor}} with {{para|editor|Smith, Jane}}
* Replace <code><nowiki>|author=[[Jane Smith (author)|Jane Smith]]</nowiki></code> with <code><nowiki>|first=Jane |last=Smith |author-link=Jane Smith (author)</nowiki></code> (preferably) or <code><nowiki>|author=Jane Smith |author-link=Jane Smith (author)</nowiki></code>
 
False positives are possible. When the name is valid, wrap the parameter value in the [[Help:Citation_Style_1#Accept-this-as-written_markup|accept-this-as-written markup]]:
:{{para|author|((Super User))}}
Please do not use this markup when it is not appropriate.
 
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_generic_name|pages=yes}}.<ref group="lower-alpha" name="categories" />
 
See also the error category [[:Category:CS1 errors: generic title]].<section end="generic_name_help_text" />


==<span id="generic_title">Cite uses generic title</span>==
==<span id="generic_title">Cite uses generic title</span>==
Line 962: Line 1,167:


CS1|2 maintains a short list of 'titles' that are typically not the title of the cited source.  Some examples are:
CS1|2 maintains a short list of 'titles' that are typically not the title of the cited source.  Some examples are:
* Wayback machine
{{div col begin |colwidth=15em}}
* This website is for sale
*<code>404</code>
* Are you a robot?
*<code>are you a robot</code>
*<code>hugedomains.com</code>
*<code>internet archive wayback machine</code>
*<code>log into facebook</code>
*<code>login • instagram</code>
*<code>no title</code> – various forms
*<code>page not found</code>
*<code>redirecting...</code>
*<code>subscribe to read</code>
*<code>unknown</code> – various forms
*<code>usurped title</code>
*<code>wayback machine</code>
*<code>webcite query result</code>
*<code>website is for sale</code>
*<code>wikiwix's cache</code>
{{div col end}}
If you are aware of other common place-holder titles, please report them at [[Help talk:Citation Style 1]], so that they can be added to the list.


To resolve this error, replace the place-holder title with the source's actual title.
To resolve this error, replace the place-holder title with the source's actual title.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_generic_title}}.<ref group="lower-alpha" name="categories" />
False positives are possible. When the name is valid, wrap the parameter value in the [[Help:Citation_Style_1#Accept-this-as-written_markup|accept-this-as-written markup]]:
:{{para|title|((404th Fighter Aviation Regiment))}}
Please do not use this markup when it is not appropriate.
 
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_generic_title|pages=yes}}.<ref group="lower-alpha" name="categories" />


See also the maintenance category [[:Category:CS1 maint: archived copy as title]].<section end="generic_title_help_text" />
See also the maintenance category [[:Category:CS1 maint: archived copy as title]] and the similar error category [[:Category:CS1 errors: generic name]].<section end="generic_title_help_text" />


==<span id="citeseerx_missing">|citeseerx= required</span>==  
==<span id="citeseerx_missing">|citeseerx= required</span>==  
Line 979: Line 1,204:
To resolve this error, ensure that the template has {{para|citeseerx}} with a properly constructed value.
To resolve this error, ensure that the template has {{para|citeseerx}} with a properly constructed value.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_citeseerx_missing}}.<ref group="lower-alpha" name="categories" /><section end="citeseerx_missing_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_citeseerx_missing|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="citeseerx_missing_help_text" />


==<span id="class_ignored">|class= ignored</span>==
==<span id="class_ignored">|class= ignored</span>==
Line 988: Line 1,213:
To resolve this error, remove {{para|class}}.
To resolve this error, remove {{para|class}}.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_class_ignored}}.<ref group="lower-alpha" name="categories" /><section end="class_ignored_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_class_ignored|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="class_ignored_help_text" />


==<span id="contributor_ignored">|contributor= ignored</span>==
==<span id="contributor_ignored">|contributor= ignored</span>==
Line 995: Line 1,220:
Only used in book citations, {{para|contributor}} identifies the author of a contribution, typically an afterword, foreword, introduction, preface, etc., to another (primary) author's work.  This error occurs when {{para|contributor}} is used in a template that is not {{tlx|cite book}} or {{tlx|citation}} or is one of these two templates and one of the {{para|work}} parameter aliases is set.   
Only used in book citations, {{para|contributor}} identifies the author of a contribution, typically an afterword, foreword, introduction, preface, etc., to another (primary) author's work.  This error occurs when {{para|contributor}} is used in a template that is not {{tlx|cite book}} or {{tlx|citation}} or is one of these two templates and one of the {{para|work}} parameter aliases is set.   


To resolve this error, choose a more appropriate CS1 or CS2 template or remove {{para|contributor}}.
To resolve this error, consider the {{para|others}} parameter, choose a more appropriate CS1 or CS2 template or remove {{para|contributor}}.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_contributor_ignored}}.<ref group="lower-alpha" name="categories" /><section end="contributor_ignored_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_contributor_ignored|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="contributor_ignored_help_text" />


==<span id="contributor_missing_required_param">|contributor= requires |&lt;param>= </span>==
==<span id="contributor_missing_required_param">|contributor= requires |&lt;param>= </span>==
Line 1,006: Line 1,231:
Only used in book citations, {{para|contributor}} identifies the author of a contribution, typically an afterword, foreword, introduction, preface, etc., to another (primary) author's work.  As such, the primary author is required ({{para|author}} or appropriate alias) as is the title of the contribution ({{para|contribution}}).   
Only used in book citations, {{para|contributor}} identifies the author of a contribution, typically an afterword, foreword, introduction, preface, etc., to another (primary) author's work.  As such, the primary author is required ({{para|author}} or appropriate alias) as is the title of the contribution ({{para|contribution}}).   


To resolve this error, include the book's primary author in {{para|author1}}, or {{para|last1}}, {{para|first1}}, or {{para|vauthors}} and include the contribution title in {{para|contribution}}; or remove {{para|contributor}}.
To resolve this error, include the book's primary author in {{para|author1}}, or {{para|last1}}, {{para|first1}}, or {{para|vauthors}} and include the contribution title in {{para|contribution}}; or consider the {{para|others}} parameter or remove {{para|contributor}}.
 
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_contributor_missing_required_param|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="contributor_missing_required_param_help_text" />
 
==<span id="doibroken_missing_doi">|doi-broken-date= requires |doi=</span>==
<section begin="doibroken_missing_doi_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_doibroken_missing_doi|$1=doi-broken-date}}
 
When {{para|doi-broken-date}} is used in a CS1|2 template, {{para|doi}} (with value) must also be present.
 
To resolve this error, either add the missing DOI or remove the 'broken' parameter.
 
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_doibroken_missing_doi|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="doibroken_missing_doi_help_text" />
 
==<span id="extra_text_edition">|edition= has extra text </span>==
<section begin="extra_text_edition_help_text" />{{help desk}}
{{#invoke:Cs1 documentation support|help_text_error_messages|err_extra_text_edition}}
 
The templates are responsible for static text rendered in the citation.  When {{para|edition}} is used in a template, cs1|2 adds the abbreviation 'ed.' to the value in the parameter so:
:{{para|edition|1st}}
renders as:
:1st ed.
The templates emit this error message when various forms of <code>ed</code>, <code>edn</code>, or <code>edition</code> are found in the value assigned to {{para|edition}}.
 
To resolve this error, remove the extraneous text from the parameter value.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_contributor_missing_required_param}}.<ref group="lower-alpha" name="categories" /><section end="contributor_missing_required_param_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_extra_text_edition|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="extra_text_edition_help_text" />


==<span id="empty_citation">Empty citation</span>==
==<span id="empty_citation">Empty citation</span>==
Line 1,025: Line 1,273:
To resolve this error, add appropriate parameter identifiers, translate foreign language parameter names to their English equivalents, or replace the CS1/CS2 template with a more appropriate template.
To resolve this error, add appropriate parameter identifiers, translate foreign language parameter names to their English equivalents, or replace the CS1/CS2 template with a more appropriate template.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_empty_citation}}.<ref group="lower-alpha" name="categories" /><section end="empty_citation_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_empty_citation|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="empty_citation_help_text" />


== <span id="explicit_et_al">Explicit use of et al.</span> ==
== <span id="explicit_et_al">Explicit use of et al.</span> ==
Line 1,036: Line 1,284:
Use the {{para|display-authors}} parameter instead (or other applicable {{para|display-''<names>''}} parameter), as documented at [[Help:Citation Style 1#Display options]].
Use the {{para|display-authors}} parameter instead (or other applicable {{para|display-''<names>''}} parameter), as documented at [[Help:Citation Style 1#Display options]].


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_etal}}.<ref group="lower-alpha" name="categories" /><section end="explicit_etal_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_etal|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="explicit_etal_help_text" />


==<span id="param_has_ext_link">External link in |&lt;param>=</span>==
==<span id="param_has_ext_link">External link in |&lt;param>=</span>==
<section begin="param_has_ext_link_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_param_has_ext_link|$1={{pipe}}&lt;param>=}}
<section begin="param_has_ext_link_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_param_has_ext_link|$1={{pipe}}&lt;param>=}}


This error occurs when any of the [[Help:Citation Style 1|CS1]] or [[Help:Citation Style 2|CS2 citation]] title-holding parameters {{para|title}}, {{para|chapter}}, {{para|publisher}}, {{para|work}} or any of its aliases: {{para|journal}}, {{para|magazine}}, {{para|newspaper}}, {{para|periodical}} and {{para|website}} – hold an external link (URL). External links in these parameters corrupt the citation's metadata and can be the source of a variety of other error messages.
This error occurs when a URL is found in any parameter that is not one of these URL-holding parameters:
 
{{div col begin}}
*{{para|archive-url}}
*{{para|article-url}}
*{{para|chapter-url}}
*{{para|conference-url}}
*{{para|contribution-url}}
*{{para|entry-url}}
*{{para|{{xtd|lay-url}}}} deprecated
*{{para|map-url}}
*{{para|section-url}}
*{{para|transcript-url}}
*{{para|url}}
{{div col end}}
or any of these insource locator parameters:
{{div col begin}}
*{{para|page}}
*{{para|p}}
*{{para|pages}}
*{{para|pp}}
*{{para|at}}
*{{para|quote-page}}
*{{para|quote-pages}}
{{div col end}}
To resolve this error, remove the external link from the identified parameter.  Consider placing the external link in a more appropriate parameter:
To resolve this error, remove the external link from the identified parameter.  Consider placing the external link in a more appropriate parameter:
* for {{para|chapter}}, the URL may belong in {{para|chapter-url}}.
* for {{para|chapter}}, the URL may belong in {{para|chapter-url}}.
* for other parameters, it may belong in {{para|url}}.
* for other parameters, it may belong in {{para|url}}.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_param_has_ext_link}}.<ref group="lower-alpha" name="categories" /><section end="param_has_ext_link_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_param_has_ext_link|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="param_has_ext_link_help_text" />


==<span id="first_missing_last">|&lt;first>''n''= missing |&lt;last>''n''=</span>==
==<span id="first_missing_last">|&lt;first>''n''= missing |&lt;last>''n''=</span>==
Line 1,058: Line 1,328:
To resolve this error, ensure that each {{para|&lt;first>''n''}} has a corresponding {{para|&lt;last>''n''}}.  
To resolve this error, ensure that each {{para|&lt;first>''n''}} has a corresponding {{para|&lt;last>''n''}}.  


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_first_missing_last}}.<ref group="lower-alpha" name="categories" /><section end="first_missing_last_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_first_missing_last|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="first_missing_last_help_text" />


==<span id="format_missing_url">|format= requires |url= </span>==
==<span id="format_missing_url">|format= requires |url= </span>==
Line 1,074: Line 1,344:
To resolve this error, remove {{para|format}} or {{para|chapter-format}}; define {{para|url}} or {{para|chapter-url}}; or change {{para|format}} to {{para|type}} (or to {{para|chapter-format}} if {{para|chapter-url}} is used without {{para|url}}.
To resolve this error, remove {{para|format}} or {{para|chapter-format}}; define {{para|url}} or {{para|chapter-url}}; or change {{para|format}} to {{para|type}} (or to {{para|chapter-format}} if {{para|chapter-url}} is used without {{para|url}}.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_format_missing_url}}.<ref group="lower-alpha" name="categories" /><section end="format_missing_url_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_format_missing_url|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="format_missing_url_help_text" />


==<span id="disp_name">Invalid |display-&lt;names>=&lt;value></span>==
==<span id="disp_name">Invalid |display-&lt;names>=&lt;value></span>==
<section begin="disp_name_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_disp_name|$1=&lt;names>|$2=&lt;value>}}
<section begin="disp_name_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_disp_name|$1=&lt;names>|$2=&lt;value>}}


These error messages are emitted when [[Module:Citation/CS1]] identifies citations that use one or more of the {{para|display-&lt;names>}} parameters with an invalid assigned <code>&lt;value></code>.  An invalid assigned <code>&lt;value></code> is a number that is greater than or equal to the number of <code>&lt;names></code> in the associated name-list or it is non-numeric text that Module:Citation/CS1 cannot recognize as a form of the keyword <code>etal</code>.
These error messages are emitted when [[Module:Citation/CS1]] identifies citations that use one or more of the {{para|display-&lt;names>}} parameters with an invalid assigned <code>&lt;value></code>.  An invalid assigned <code>&lt;value></code> is a number that is greater than or equal to the number of <code>&lt;names></code> in the associated name-list or it is non-numeric text that Module:Citation/CS1 cannot recognize as a form of the keyword <code>etal</code>.


To resolve this error, do one of the following:
To resolve this error, do one of the following:
* Remove the {{para|display-&lt;names>}} parameter from the citation (because "et al." is not appropriate in the citation)
* Remove the {{para|display-&lt;names>}} parameter from the citation (typically because "et al." is not appropriate in the citation)
* Change the <code>&lt;value></code> of the {{para|display-&lt;names>}} parameter such that it is less than the number of <code>&lt;names></code> in the name-list (thereby truncating the displayed list to the number)
* Change the <code>&lt;value></code> of the {{para|display-&lt;names>}} parameter such that it is less than the number of <code>&lt;names></code> in the name-list (thereby truncating the displayed list to the number)
* Change the <code>&lt;value></code> of the {{para|display-&lt;names>}} parameter to <code>etal</code>, which will cause "et al" to display after the last <code>&lt;name></code>.
* Change the <code>&lt;value></code> of the {{para|display-&lt;names>}} parameter to <code>etal</code>, which will cause "et al" to display after the last <code>&lt;name></code>.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_disp_name}}.<ref group="lower-alpha" name="categories" /><section end="disp_name_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_disp_name|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="disp_name_help_text" />


==<span id="invalid_param_val">Invalid &lt;param>=&lt;value></span>==
==<span id="invalid_param_val">Invalid &lt;param>=&lt;value></span>==
Line 1,101: Line 1,370:
|-
|-
| {{para|df}} ||<code>dmy</code>, <code>dmy-all</code>, <code>mdy</code>, <code>mdy-all</code>, <code>ymd</code>, <code>ymd-all</code>
| {{para|df}} ||<code>dmy</code>, <code>dmy-all</code>, <code>mdy</code>, <code>mdy-all</code>, <code>ymd</code>, <code>ymd-all</code>
|-
| {{para|ignore-isbn-error}}<br />(deprecated)||rowspan=2|<code>true</code>, <code>y</code>, <code>yes</code>
|-
| {{para|last-author-amp}}<br />(deprecated)
|-
|-
| {{para|mode}}||<code>cs1</code>, <code>cs2</code>
| {{para|mode}}||<code>cs1</code>, <code>cs2</code>
|-
|-
| {{para|name-list-format}}<br />(deprecated)||<code>vanc</code>
| {{para|name-list-style}} || <code>amp</code>, <code>ampersand</code>, <code>and</code>, <code>&</code>, <code>serial</code>, <code>vanc</code>
|-
| {{para||name-list-style}} || <code>amp</code>, <code>ampersand</code>, <code>and</code>, <code>&</code>, <code>serial</code>, <code>vanc</code>
|-
|-
| {{para|no-pp}}||rowspan=2|<code>true</code>, <code>y</code>, <code>yes</code>
| {{para|no-pp}}||rowspan=2|<code>true</code>, <code>y</code>, <code>yes</code>
Line 1,116: Line 1,379:
| {{para|no-tracking}}
| {{para|no-tracking}}
|-
|-
| {{para|bibcode-access}}||rowspan=7|<code>free</code>
| {{para|bibcode-access}}||rowspan=8|<code>free</code>
|-
|-
| {{para|doi-access}}
| {{para|doi-access}}
Line 1,127: Line 1,390:
|-
|-
| {{para|osti-access}}
| {{para|osti-access}}
|-
| {{para|ssrn-access}}
|-
|-
| {{para|s2cid-access}}
| {{para|s2cid-access}}
Line 1,144: Line 1,409:
| {{para|section-url-access}}
| {{para|section-url-access}}
|-
|-
| {{para|url-status}}||<code>dead</code>, <code>live</code>, <code>unfit</code>, <code>usurped</code>
| {{para|url-status}}||<code>dead</code>, <code>live</code>, <code>deviated</code>, <code>unfit</code>, <code>usurped</code>
|}
|}


To resolve this error, use an appropriate value.
To resolve this error for the parameters in the table, use an appropriate value.
 
Support for {{para|ref|harv}} is withdrawn because cs1|2 templates now automatically create the <code>CITEREF</code> anchor value that {{para|ref|harv}} controlled.  To resolve this error, remove {{para|ref|harv}}.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_invalid_param_val}}.<ref group="lower-alpha" name="categories" /><section end="invalid_param_val_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_invalid_param_val|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="invalid_param_val_help_text" />


==<span id="script_parameter">Invalid |script-&lt;param>=: &lt;type></span>==
==<span id="script_parameter">Invalid |script-&lt;param>=: &lt;type></span>==
Line 1,161: Line 1,428:
{{#invoke:Cs1 documentation support|script_lang_lister}}<!-- makes a language code: name list from the master list in [[Module:Citation/CS1/Configuration]] -->
{{#invoke:Cs1 documentation support|script_lang_lister}}<!-- makes a language code: name list from the master list in [[Module:Citation/CS1/Configuration]] -->


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_script_parameter}}.<ref group="lower-alpha" name="categories" /><section end="script_parameter_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_script_parameter|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="script_parameter_help_text" />
 
==<span id="extra_text_issue">|issue=/|number= has extra text</span>==
<section begin="extra_text_issue_help_text" />{{help desk}}
{{#invoke:Cs1 documentation support|help_text_error_messages|err_extra_text_issue|$1=issue}}<br/>
{{#invoke:Cs1 documentation support|help_text_error_messages|err_extra_text_issue|$1=number}}
 
The templates are responsible for static text rendered in the citation. When {{para|issue}} or {{para|number}} is used in a template, cs1|2 formats the issue number according to the style corresponding with the publication type associated with the used citation template.
 
The templates emit this error message when various forms of issue or number prefixes (like <code>Iss.</code> or <code>No.</code>) are found in the value assigned to {{para|issue}} or {{para|number}}.
 
To resolve this error, remove the extraneous text from the parameter value. If the extraneous text removed is related to issues, please use the {{para|issue}} parameter rather than {{para|number}} for this, and vice versa. At present, the output is the same for both parameters, but this may not hold true in future versions, therefore it is important that issues and number values are used with the proper parameter as per what nomenclature is used in the actual publication.
 
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_extra_text_issue|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="extra_text_issue_help_text" />


==<span id="apostrophe_markup">Italic or bold markup not allowed in: |&lt;param>=</span>==
==<span id="apostrophe_markup">Italic or bold markup not allowed in: |&lt;param>=</span>==
Line 1,176: Line 1,456:
To resolve this error, remove wiki markup from the named parameter's value and ensure that the template is using the correct parameters; when citing a newspaper, use {{para|newspaper}} for the newspaper's name, not {{para|publisher}}, etc.
To resolve this error, remove wiki markup from the named parameter's value and ensure that the template is using the correct parameters; when citing a newspaper, use {{para|newspaper}} for the newspaper's name, not {{para|publisher}}, etc.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_apostrophe_markup}}.<ref group="lower-alpha" name="categories" /><section end="apostrophe_markup_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_apostrophe_markup|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="apostrophe_markup_help_text" />


==<span id="missing_name">Missing |&lt;name>''n''=</span>==
==<span id="missing_name">Missing |&lt;name>''n''=</span>==
Line 1,187: Line 1,467:
To resolve this error, ensure that the numbering of the {{para|&lt;last>{{var|n}}}} parameters increments properly.  
To resolve this error, ensure that the numbering of the {{para|&lt;last>{{var|n}}}} parameters increments properly.  


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_missing_name}}.<ref group="lower-alpha" name="categories" /><section end="missing_name_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_missing_name|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="missing_name_help_text" />


==<span id="missing_title">Missing or empty |title= </span>==
==<span id="missing_title">Missing or empty |title= </span>==
Line 1,240: Line 1,520:
|}
|}


A unique case exists: if {{para|pmc}} has a value and {{para|url}} is omitted or empty, then {{para|title}} is linked with the same URL as the PMC.
A unique case exists for {{tl|cite journal}}: if {{para|pmc}} or {{para|doi}} has a value, {{para|url}} is omitted or empty, and {{para|title-link}} does not point to an article, then {{para|title}} is automatically linked with the same URL as the PMC or DOI. This default behaviour can be overridden using {{para|title-link|none/pmc/doi}}.


Because URLs are ugly and generally uninformative, it is expected that editors should provide a meaningful title for each URL. In most cases this can be accomplished by using the {{para|title}} parameter.
Because URLs are ugly and generally uninformative, it is expected that editors should provide a meaningful title for each URL. In most cases this can be accomplished by using the {{para|title}} parameter.
Line 1,256: Line 1,536:


{{tlx|cite episode}} will show this error if {{para|series}} is omitted or left blank (even if a {{para|title}} is provided).
{{tlx|cite episode}} will show this error if {{para|series}} is omitted or left blank (even if a {{para|title}} is provided).
{{tlx|cite encyclopedia}} will show this error if {{para|encyclopedia}} has a value but {{para|entry}} (or another {{para|chapter}} alias) is omitted or left blank.


Sometimes this error occurs because an editor has used a CS1|2 citation as a [[Help:Shortened footnotes|shortened footnote]] when {{tlx|sfn}} or one of the {{tlx|harv}} family of templates would have been more appropriate. This error also occurs when an editor used {{tlx|citation}} but intended to use {{tlx|citation needed}}.
Sometimes this error occurs because an editor has used a CS1|2 citation as a [[Help:Shortened footnotes|shortened footnote]] when {{tlx|sfn}} or one of the {{tlx|harv}} family of templates would have been more appropriate. This error also occurs when an editor used {{tlx|citation}} but intended to use {{tlx|citation needed}}.
Line 1,279: Line 1,561:
Some legitimate titles will contain a CS1|2 parameter name followed by an equal sign. In that case, enclose the equal sign in nowiki tags, like this: {{tag|nowiki|content={{=}}}}.  For most other cases, simply add the missing pipe.
Some legitimate titles will contain a CS1|2 parameter name followed by an equal sign. In that case, enclose the equal sign in nowiki tags, like this: {{tag|nowiki|content={{=}}}}.  For most other cases, simply add the missing pipe.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_missing_pipe}}.<ref group="lower-alpha" name="categories" /><section end="missing_pipe_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_missing_pipe|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="missing_pipe_help_text" />


==<span id="redundant_parameters">More than one of |&lt;param1>=, |&lt;param2>=, and |&lt;param3>= specified</span>==
==<span id="redundant_parameters">More than one of |&lt;param1>=, |&lt;param2>=, and |&lt;param3>= specified</span>==
Line 1,295: Line 1,577:
: {{para|author''n''}} and {{para|last''n''}} / {{para|first''n''}} (and their various aliases), {{para|vauthors}}, and {{para|authors}}
: {{para|author''n''}} and {{para|last''n''}} / {{para|first''n''}} (and their various aliases), {{para|vauthors}}, and {{para|authors}}
and similarly, three editor-name-list styles:
and similarly, three editor-name-list styles:
: {{para|editor''n''}} and {{para|editor-last''n''}} / {{para|editor-first''n''}} (and their various aliases), {{para|veditors}}, and {{para|editors}}
: {{para|editor''n''}} and {{para|editor-last''n''}} / {{para|editor-first''n''}} (and their various aliases) as well as {{para|veditors}}


To resolve this error, choose one name-list-style.  Use the chosen style for both of the author and editor name-lists.
To resolve this error, choose one name-list-style.  Use the chosen style for both of the author and editor name-lists.


Pages with these errors are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_redundant_parameters}}.<ref group="lower-alpha" name="categories" /><section end="redundant_parameters_help_text" />
Pages with these errors are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_redundant_parameters|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="redundant_parameters_help_text" />
 
==<span id="extra_text_pages">|page(s)= has extra text</span>==
<section begin="extra_text_pages_help_text" />{{help desk}}
{{#invoke:Cs1 documentation support|help_text_error_messages|err_extra_text_pages|$1=&lt;param>}}
 
The templates are responsible for static text rendered in the citation.  When {{para|page}}/{{para|p}}, {{para|pages}}/{{para|pp}}, {{para|quote-page}} or {{para|quote-pages}} is used in a template, cs1|2 inserts the appropriate pagination prefix 'p.' or 'pp.' ahead of the value in the parameter so:
:{{para|page|123}}
renders as:
:p. 123
and:
:{{para|page|123–125}}
renders as:
:pp. 123–125
The templates emit this error message when various forms of <code>p</code>, <code>pp</code>, <code>pg</code>, <code>pgs</code>, <code>page</code>, or <code>pages</code> are found in the value assigned to {{para|page}}/{{para|p}}, {{para|pages}}/{{para|pp}}, {{para|quote-page}} or {{para|quote-pages}}.
 
To resolve this error, remove the extraneous text from the parameter value.
 
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_extra_text_pages|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="extra_text_pages_help_text" />


==<span id="param_access_requires_param">&#124;&lt;param>-access= requires &#124;&lt;param>=</span>==
==<span id="param_access_requires_param">&#124;&lt;param>-access= requires &#124;&lt;param>=</span>==
Line 1,342: Line 1,642:
To resolve this error, either provide a value for the parameter, or remove the access level specification.
To resolve this error, either provide a value for the parameter, or remove the access level specification.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_param_access_requires_param}}.<ref group="lower-alpha" name="categories" /><section end="param_access_requires_param_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_param_access_requires_param|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="param_access_requires_param_help_text" />


==<span id="doibroken_missing_doi">&#124;&lt;param>= requires &#124;doi=</span>==
==<span id="embargo_missing_pmc">|pmc-embargo-date= requires |pmc=</span>==
<section begin="doibroken_missing_doi_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_doibroken_missing_doi|$1=&lt;param>}}
<section begin="embargo_missing_pmc_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_embargo_missing_pmc|$1=pmc-embargo-date}}


When {{para|doi-broken-date}} is used in a CS1|2 template, {{para|doi}} or {{para|DOI}} (with value) must also be present.
When {{para|pmc-embargo-date}} is used in a CS1|2 template, {{para|pmc}} (with value) must also be present.


To resolve this error, either add the missing DOI or remove the 'broken' parameter.
To resolve this error, either add the missing PMC or remove the 'broken' parameter.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_doibroken_missing_doi}}.<ref group="lower-alpha" name="categories" /><section end="doibroken_missing_doi_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_embargo_missing_pmc|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="embargo_missing_pmc_help_text" />


==<span id="ssrn_missing">|ssrn= required</span>==  
==<span id="ssrn_missing">|ssrn= required</span>==  
Line 1,360: Line 1,660:
To resolve this error, ensure that the template has {{para|ssrn}} with a properly constructed value.
To resolve this error, ensure that the template has {{para|ssrn}} with a properly constructed value.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_ssrn_missing}}.<ref group="lower-alpha" name="categories" /><section end="ssrn_missing_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_ssrn_missing|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="ssrn_missing_help_text" />


==<span id="text_ignored">Text "????" ignored</span>==
==<span id="text_ignored">Text "????" ignored</span>==
Line 1,371: Line 1,671:
To resolve this error, remove the extraneous text, add '=', add an appropriate parameter name from the template you're using to complete the parameter, or properly encode vertical bars in URLs and titles.
To resolve this error, remove the extraneous text, add '=', add an appropriate parameter name from the template you're using to complete the parameter, or properly encode vertical bars in URLs and titles.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_text_ignored}}.<ref group="lower-alpha" name="categories" /><section end="text_ignored_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_text_ignored|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="text_ignored_help_text" />


==<span id="trans_missing_title">|trans-&lt;param>= requires |&lt;param>= or |script-&lt;param></span>==
==<span id="trans_missing_title">|trans-&lt;param>= requires |&lt;param>= or |script-&lt;param>=</span>==
<section begin="trans_missing_title_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_trans_missing_title|$1=&lt;param>|$2=&lt;param>|$3=&lt;param>}}
<section begin="trans_missing_title_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_trans_missing_title|$1=&lt;param>|$2=&lt;param>|$3=&lt;param>}}


Line 1,380: Line 1,680:
To resolve this error, provide the original language title for {{para|title}} or chapter title for {{para|chapter}}. Consider adding {{para|language}} if not already part of the citation.
To resolve this error, provide the original language title for {{para|title}} or chapter title for {{para|chapter}}. Consider adding {{para|language}} if not already part of the citation.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_trans_missing_title}}.<ref group="lower-alpha" name="categories" /><section end="trans_missing_title_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_trans_missing_title|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="trans_missing_title_help_text" />


==<span id="parameter_ignored">Unknown parameter |=&lt;param>= ignored<span id="parameter_ignored_suggest"> </span></span>==
==<span id="parameter_ignored">Unknown parameter |&lt;param>= ignored<span id="parameter_ignored_suggest"> </span></span>==
<section begin="parameter_ignored_help_text" />{{help desk}}{{plainlist|
<section begin="parameter_ignored_help_text" />{{help desk}}{{plainlist|
*{{#invoke:Cs1 documentation support|help_text_error_messages|err_parameter_ignored|$1=&lt;param>}}
*{{#invoke:Cs1 documentation support|help_text_error_messages|err_parameter_ignored|$1=&lt;param>}}
Line 1,397: Line 1,697:
To resolve this error, replace the erroneous parameter name with a correct one, possibly using the suggested name. Ensure that the parameter's name is correctly spelled and that there are no characters except spaces between the parameter's name and the leading vertical bar (|) or trailing equals sign (=). A list of valid parameters can be found by consulting [[Help:Citation Style 1]] or visiting the description page of the specific template being used, such as {{tlx|cite web}}, {{tlx|cite book}}, {{tlx|cite journal}}, etc. Consider moving information associated with the unknown parameter into an appropriate parameter or to a section of the article's talk page for preservation.
To resolve this error, replace the erroneous parameter name with a correct one, possibly using the suggested name. Ensure that the parameter's name is correctly spelled and that there are no characters except spaces between the parameter's name and the leading vertical bar (|) or trailing equals sign (=). A list of valid parameters can be found by consulting [[Help:Citation Style 1]] or visiting the description page of the specific template being used, such as {{tlx|cite web}}, {{tlx|cite book}}, {{tlx|cite journal}}, etc. Consider moving information associated with the unknown parameter into an appropriate parameter or to a section of the article's talk page for preservation.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_parameter_ignored}}.<ref group="lower-alpha" name="categories" /><section end="parameter_ignored_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_parameter_ignored|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="parameter_ignored_help_text" />


==<span id="wikilink_in_url">URL–wikilink conflict</span>==
==<span id="wikilink_in_url">URL–wikilink conflict</span>==
Line 1,404: Line 1,704:
External links in a rendered citation are a combination of url-holding parameters, {{para|url}}, {{para|chapter-url}}, etc., with title-holding parameters, {{para|title}}, {{para|chapter}}, etc. Title-holding parameters may be [[wikilink]]ed to another Wikipedia article but not when there is a matching url-holding parameter in the citation. When this condition occurs, the wikilink is suppressed, the wiki markup ignored, and the rendered citation links to the external site.
External links in a rendered citation are a combination of url-holding parameters, {{para|url}}, {{para|chapter-url}}, etc., with title-holding parameters, {{para|title}}, {{para|chapter}}, etc. Title-holding parameters may be [[wikilink]]ed to another Wikipedia article but not when there is a matching url-holding parameter in the citation. When this condition occurs, the wikilink is suppressed, the wiki markup ignored, and the rendered citation links to the external site.


Some [[Help:Template|templates]] will also cause this error if they are part of a title-holding parameter. The error occurs when the template produces wikilinked content. For example, {{tlx|lang}} templates output a wikilinked category. Templates in url-holding parameters may also corrupt the citation's [[WP:COinS|COinS]] metadata. As a general rule, avoid using templates in title-holding parameters unless you know that the template's effects are entirely visual ({{tlx|!}} and the like).
With {{tlx|cite journal}}, auto-linking of the {{para|pmc}} or {{para|doi}} parameter value can cause this condition to occur implicitly without a specific url-holding parameter.
 
Some [[Help:Template|templates]] will also cause this error if they are part of a title-holding parameter. The error occurs when the template produces wikilinked content. For example, {{tlx|lang}} templates output a wikilinked category. Templates in title-holding parameters may also corrupt the citation's [[WP:COinS|COinS]] metadata. As a general rule, avoid using templates in title-holding parameters unless you know that the template's effects are entirely visual ({{tlx|!}} and the like).


This type of error may also occur in identifier-based templates ({{tlx|cite doi}}, etc.). When this happens, the error message is shown in the article but the error is actually located in the identifier-based citation template.
This type of error may also occur in identifier-based templates ({{tlx|cite doi}}, etc.). When this happens, the error message is shown in the article but the error is actually located in the identifier-based citation template.


To resolve this error, remove wikilinks from title-holding parameters that are intended to be externally linked or remove the external URL, which will allow the internal wikilinks to work as expected. If wikilink-producing templates are important to the citation, move them out of the CS1 template but leave them inside the citation's {{tag|ref}} tags. Some of the functionality provided by templates may also be available through CS1 parameters.
To resolve this error, remove wikilinks from title-holding parameters that are intended to be externally linked or remove the external URL, which will allow the internal wikilinks to work as expected. If the conflict is implicitly caused through auto-linking (see above), this can be disabled using {{para|title-link|none}}. If wikilink-producing templates are important to the citation, move them out of the CS1 template but leave them inside the citation's {{tag|ref}} tags. Some of the functionality provided by templates may also be available through CS1 parameters.


To resolve errors in identifier-based citation templates, the template must be edited to correct the error. Exercise caution when editing these templates because identifier-based citation templates are often used in multiple articles.
To resolve errors in identifier-based citation templates, the template must be edited to correct the error. Exercise caution when editing these templates because identifier-based citation templates are often used in multiple articles.


Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_wikilink_in_url}}.<ref group="lower-alpha" name="categories" /><section end="wikilink_in_url_help_text" />
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_wikilink_in_url|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="wikilink_in_url_help_text" />


==<span id="vancouver">Vancouver style error</span>==
==<span id="vancouver">Vancouver style error</span>==
<section begin="vancouver_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_vancouver|$1=&lt;type>}}
<section begin="vancouver_help_text" />{{help desk}}{{#invoke:Cs1 documentation support|help_text_error_messages|err_vancouver|$1=&lt;type>|$2=&lt;number>}}


This error is reported for citations that use {{para|vauthors}}, {{para|veditors}}, {{para|name-list-style|vanc}}.
This error is reported for citations that use {{para|vauthors}}, {{para|veditors}}, {{para|name-list-style|vanc}}.


[[Vancouver style]] restricts author or editor names to the Latin alphabet. For the purposes of this test, [[Module:Citation/CS1]] defines the Latin alphabet as the letters defined in the [[Unicode]] Latin character sets:
[[Vancouver style]] restricts author or editor names to the Latin alphabet. For the purposes of this test, [[Module:Citation/CS1]] defines the Latin alphabet as the letters defined in the [[Unicode]] Latin character sets:
: C0 Controls and Basic Latin<ref>{{cite web |url=https://www.unicode.org/charts/PDF/U0000.pdf |title=C0 Controls and Basic Latin |website=[[Unicode]] |access-date=2015-04-19}}</ref> (0041–005A, 0061–007A)
: C0 Controls and Basic Latin<ref>{{cite web |title=C0 Controls and Basic Latin |website=[[Unicode]] |url=https://www.unicode.org/charts/PDF/U0000.pdf |access-date=2015-04-19}}</ref> (0041–005A, 0061–007A)
: C1 Controls and Latin-1 Supplement<ref>{{cite web |url=https://www.unicode.org/charts/PDF/U0080.pdf |title=C1 Controls and Latin-1 Supplement |website=Unicode |access-date=2015-04-19}}</ref> (00C0–00D6, 00D8–00F6, 00F8–00FF)
: C1 Controls and Latin-1 Supplement<ref>{{cite web |title=C1 Controls and Latin-1 Supplement |website=Unicode |url=https://www.unicode.org/charts/PDF/U0080.pdf |access-date=2015-04-19}}</ref> (00C0–00D6, 00D8–00F6, 00F8–00FF)
: Latin Extended-A<ref>{{cite web |url=https://www.unicode.org/charts/PDF/U0100.pdf |title=Latin Extended-A |website=Unicode |access-date=2015-04-19}}</ref> (0100–017F)
: Latin Extended-A<ref>{{cite web |title=Latin Extended-A |website=Unicode |url=https://www.unicode.org/charts/PDF/U0100.pdf |access-date=2015-04-19}}</ref> (0100–017F)
: Latin Extended-B<ref>{{cite web |url=https://www.unicode.org/charts/PDF/U0180.pdf |title=Latin Extended-B |website=Unicode |access-date=2015-04-19}}</ref> (0180–01BF, 01C4–024F)
: Latin Extended-B<ref>{{cite web |title=Latin Extended-B |website=Unicode |url=https://www.unicode.org/charts/PDF/U0180.pdf |access-date=2015-04-19}}</ref> (0180–01BF, 01C4–024F)


This error is also reported when more than two initials are used: in case of more than two initials, list only the first two.
This error is also reported when more than two initials are used: in case of more than two initials, list only the first two.
Line 1,430: Line 1,732:
: {{para|vauthors|First Surname FM, Surname AB, {{green|((}}Corporate or institutional Author{{green|))}}, Last Surname XY}}
: {{para|vauthors|First Surname FM, Surname AB, {{green|((}}Corporate or institutional Author{{green|))}}, Last Surname XY}}


While normally correct, sometimes the names listed on a PMID page contain errors when the author surname has a lowercase [[nobiliary particle]].  For example, {{PMID|17726700}} lists Magnus von Knebel Doeberitz as Doeberitz Mv which is not correct.  This author's name should be listed as {{para|vauthors|von Knebel Doeberitz M}}.<ref>{{cite web |url=https://www.ncbi.nlm.nih.gov/books/NBK7282/box/A33081/ |title=Other surname rules |website=National Center for Biotechnology Information |date=2018-05-18}}</ref>
While normally correct, sometimes the names listed on a PMID page contain errors when the author surname has a lowercase [[nobiliary particle]].  For example, {{PMID|17726700}} lists Magnus von Knebel Doeberitz as Doeberitz Mv which is not correct.  This author's name should be listed as {{para|vauthors|von Knebel Doeberitz M}}.<ref>{{cite web |title=Other surname rules |website=National Center for Biotechnology Information |date=2018-05-18 |url=https://www.ncbi.nlm.nih.gov/books/NBK7282/box/A33081/}}</ref>


Certain punctuation will be flagged as an error.  For example, Unicode U+2019, right single quotation mark, causes an error because it is not a member of the Latin character sets identified above: {{para|vauthors|Van{{red|’}}t Veer M}}.  Replace this character with the straight (or typewriter) apostrophe: {{para|vauthors|Van{{green|'}}t Veer M}}.
Certain punctuation will be flagged as an error.  For example, Unicode U+2019, right single quotation mark, causes an error because it is not a member of the Latin character sets identified above: {{para|vauthors|Van{{red|’}}t Veer M}}.  Replace this character with the straight (or typewriter) apostrophe: {{para|vauthors|Van{{green|'}}t Veer M}}.


To resolve this error, Romanize author and editor names.<ref>{{cite book |author-last=Patrias |author-first=K. |editor-last=Wendling |editor-first=D. |location=Bethesda, MD, USA |publisher=National Library of Medicine |date=2007 |chapter=Names in non-roman alphabets or character-based languages |chapter-url=https://www.ncbi.nlm.nih.gov/books/NBK7258/box/A48818/ |title=Citing Medicine: The NLM Style Guide for Authors, Editors, and Publishers [Internet]. |edition=2nd}}</ref>  Romanizing can result in two-letter initials, for example, the Greek letter 'Θ' Romanizes to 'Th'.<ref>{{cite web |url=https://www.loc.gov/catdir/cpso/romanization/greek.pdf |title=Greek |website=Library of Congress}}</ref> When author names have this kind of initial, Module:Citation/CS1 can't know if this kind of initial is a typo or a legitimate Romanized character so it will emit the Vancouver error.  To suppress the error after determining that the two-character initial is correct and not a typo, treat the name as if it were a corporate name by wrapping it in [[Help:Citation_Style_1#Accept-this-as-written_markup|doubled parentheses]]: {{para|vauthors|...,  Tatarinov IuS, ...}} → {{para|vauthors|...,  ((Tatarinov IuS)), ...}}
To resolve this error, Romanize author and editor names.<ref>{{cite book |chapter=Names in non-roman alphabets or character-based languages |title=Citing Medicine: The NLM Style Guide for Authors, Editors, and Publishers |author-last=Patrias |author-first=Karen |editor-last=Wendling |editor-first=Dan |location=Bethesda, Maryland, USA |publisher=[[National Library of Medicine]] |date=2007 |edition=2nd |chapter-url=https://www.ncbi.nlm.nih.gov/books/NBK7258/box/A48818/}}</ref>  Romanizing can result in two-letter initials, for example, the Greek letter 'Θ' Romanizes to 'Th'.<ref>{{cite web |title=Greek |website=Library of Congress |url=https://www.loc.gov/catdir/cpso/romanization/greek.pdf}}</ref> When author names have this kind of initial, Module:Citation/CS1 can't know if this kind of initial is a typo or a legitimate Romanized character so it will emit the Vancouver error.  To suppress the error after determining that the two-character initial is correct and not a typo, treat the name as if it were a corporate name by wrapping it in [[Help:Citation_Style_1#Accept-this-as-written_markup|doubled parentheses]]: {{para|vauthors|...,  Tatarinov IuS, ...}} → {{para|vauthors|...,  ((Tatarinov IuS)), ...}}


Similarly, Chinese hyphenated given names may appear in PubMed listings.  For example: 'Wang Hsien-yu' may be listed on PubMed as 'Wang Hy' which will result in a Vancouver error.  When this occurs, and upon verification that such names are correct, wrap them in doubled parentheses.
Similarly, Chinese hyphenated given names may appear in PubMed listings.  For example: 'Wang Hsien-yu' may be listed on PubMed as 'Wang Hy' which will result in a Vancouver error.  When this occurs, and upon verification that such names are correct, wrap them in doubled parentheses.


Specific Rules for Names:<ref>{{cite book |url=https://www.ncbi.nlm.nih.gov/books/NBK7282/ |title=Citing Medicine: The NLM Style Guide for Authors, Editors, and Publishers [Internet] |edition=2nd |author-first=K. |author-last=Patrias |editor-first=D. |editor-last=Wendling |location=Bethesda, MD, USA |publisher=National Library of Medicine (US) |date=2007 |access-date=2019-03-31}}</ref>
Specific rules for names:<ref>{{cite book |title=Citing Medicine: The NLM Style Guide for Authors, Editors, and Publishers [Internet] |edition=2nd |author-first=Karen |author-last=Patrias |editor-first=Dan |editor-last=Wendling |location=Bethesda, Maryland, USA |publisher=National Library of Medicine |date=2007 |url=https://www.ncbi.nlm.nih.gov/books/NBK7282/ |access-date=2019-03-31}}</ref>
* [https://www.ncbi.nlm.nih.gov/books/NBK7282/box/A33071/?report=objectonly Surnames with hyphens and other punctuation in them]
* [https://www.ncbi.nlm.nih.gov/books/NBK7282/box/A33071/?report=objectonly Surnames with hyphens and other punctuation in them]
* [https://www.ncbi.nlm.nih.gov/books/NBK7282/box/A33081/?report=objectonly Other surname rules]
* [https://www.ncbi.nlm.nih.gov/books/NBK7282/box/A33081/?report=objectonly Other surname rules]
Line 1,447: Line 1,749:
* [https://www.ncbi.nlm.nih.gov/books/NBK7282/box/A33152/?report=objectonly Organizations as author]
* [https://www.ncbi.nlm.nih.gov/books/NBK7282/box/A33152/?report=objectonly Organizations as author]
** CS1|2 does not obey the semicolon-as-separator rule.  Separate corporate and organizational names from each other and from individual names with a comma; wrap corporate and organizational names in doubled parentheses as described above.
** CS1|2 does not obey the semicolon-as-separator rule.  Separate corporate and organizational names from each other and from individual names with a comma; wrap corporate and organizational names in doubled parentheses as described above.
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_vancouver}}.<ref group="lower-alpha" name="categories" /><section end="vancouver_help_text" /><!--
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_vancouver|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="vancouver_help_text" />
When moving this section keep the following attached to the Notes section below --><section begin="notes_help_text" />
 
==<span id="extra_text_volume">|volume= has extra text</span>==
<section begin="extra_text_volume_help_text" />{{help desk}}
{{#invoke:Cs1 documentation support|help_text_error_messages|err_extra_text_volume|$1=volume}}
 
The templates are responsible for static text rendered in the citation. When {{para|volume}} is used in a template, cs1|2 formats the volume value according to the style corresponding with the publication type associated with the used citation template.
 
The templates emit this error message when some form of the word "volume" ("volume", "vol.") is found in the value assigned to {{para|volume}}.
 
To resolve this error, remove the extraneous text from the parameter value.
 
Pages with this error are automatically placed in {{#invoke:cs1 documentation support|help_text_cats|err_extra_text_volume|pages=yes}}.<ref group="lower-alpha" name="categories" /><section end="extra_text_volume_help_text" /><!--When moving this section keep the following attached to the Notes section below --><section begin="notes_help_text" />


==Notes==
==Notes==
<!-- When moving this section keep <section begin="notes_help_text"> (located above this section header) attacted -->
<!-- When moving this section keep <section begin="notes_help_text"> (located above this section header) attacted -->
{{reflist |group=lower-alpha |refs=
{{reflist |group=lower-alpha |refs=
<ref group="lower-alpha" name="categories">Pages in the Book talk, Category talk, Draft talk, Education Program talk, File talk, Help talk, MediaWiki talk, Module talk, Portal talk, Talk, Template talk, User, User talk, and Wikipedia talk namespaces are not included in the error tracking categories.</ref>
<ref group="lower-alpha" name="categories">Pages in the Book talk, Category talk, Draft talk, File talk, Help talk, MediaWiki talk, Module talk, Portal talk, Talk, Template talk, User, User talk, and Wikipedia talk namespaces are not included in the tracking categories. In addition, pages with names matching the patterns '/[Ss]andbox', '/[Tt]estcases', '/[^/]*[Ll]og', and '/[Aa]rchive' are not included in the tracking categories.<!--See Module:Citation/CS1/Configuration in uncategorized_namespaces{}--></ref>
}}<section end="notes_help_text" /><!--
}}<section end="notes_help_text" /><!--
When moving this section keep the following attached to the References section below --><section begin="references_help_text" />
When moving this section keep the following attached to the References section below --><section begin="references_help_text" />
Anonymous user