Difference between revisions of "Template:COinS safe/doc"
en>Jonesey95 (Fix empty citation, unnamed or unsupported parameter, or invalid parameter value; see Help:CS1 errors) |
m (1 revision imported) |
(No difference)
| |
Latest revision as of 12:51, 2 January 2019
 | This is a documentation subpage for Template:COinS safe. It contains usage information, categories and other content that is not part of the original template page. |
Usage
This template is a notice for templates that may be used in citation templates. By default, it indicates the template is safe for use as shown above.
To indicate a template that should not be used in a citation template:
{{COinS safe|n}}
 | This template should not be used in citation templates such as Citation Style 1 and Citation Style 2, because it includes markup that will pollute the COinS metadata they produce; see COinS in Wikipedia. |
|addtext=— additional text shown after the main message
When the template is set to not safe, the page is placed into Category:Templates not safe for use in citation templates.
Issue
Citation templates such as Citation Style 1 and Citation Style 2 generate COinS metadata. If a template is used in a citation template field, then it may inject HTML into the metadata.
Compare the rendered HTML for {{cite book}} with |author= using no template and using {{smallcaps}}.
| Markup | Renders as |
|---|---|
{{cite book |author=Sam Drucker |title=Title}}
|
Sam Drucker. Title.<templatestyles src="Module:Citation/CS1/styles.css"></templatestyles>
|
{{cite book |author={{smallcaps|Sam Drucker}} |title=Title}}
|
<templatestyles src="smallcaps/styles.css"/>Sam Drucker. Title.<templatestyles src="Module:Citation/CS1/styles.css"></templatestyles>
|
The author metadata is in the rft.aulast field. In this case, it is percent-encoded and is rendered as <span class="smallcaps" style="font-variant:small-caps;">Sam Drucker</span>
Reference management software will interpret the entire span as the author name.
