Difference between revisions of "Template:COinS safe/doc"
imported>Trappist the monk m (Copyedit;) |
imported>SpikeToronto (→Issue: For tablets. Should have no detrimental effect on desktops/laptops.) |
||
| Line 20: | Line 20: | ||
Compare the rendered HTML for {{tl|cite book}} with {{para|author}} using no template and using {{tl|smallcaps}}. | Compare the rendered HTML for {{tl|cite book}} with {{para|author}} using no template and using {{tl|smallcaps}}. | ||
| + | <div style="overflow:auto;"> | ||
{{markup | {{markup | ||
|<nowiki>{{cite book |author=Sam Drucker |title=Title}}</nowiki> | |<nowiki>{{cite book |author=Sam Drucker |title=Title}}</nowiki> | ||
| Line 31: | Line 32: | ||
{{code|{{cite book |author={{smallcaps|Sam Drucker}} |title=Title}}}} | {{code|{{cite book |author={{smallcaps|Sam Drucker}} |title=Title}}}} | ||
}} | }} | ||
| + | </div> | ||
The author metadata is in the {{code|rft.aulast}} field. In this case, it is percent-encoded and is rendered as <code><nowiki><span class="smallcaps" style="font-variant:small-caps;">Sam Drucker</span></nowiki></code> | The author metadata is in the {{code|rft.aulast}} field. In this case, it is percent-encoded and is rendered as <code><nowiki><span class="smallcaps" style="font-variant:small-caps;">Sam Drucker</span></nowiki></code> | ||
Revision as of 19:43, 28 August 2015
| File:Edit-copy green.svg | 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 Wikipedia:COinS. |
|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.
|
{{cite book |author={{smallcaps|Sam Drucker}} |title=Title}}
|
Template:Smallcaps. Title.
|
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.