سانچو:COinS safe

This template is safe for use in citation templates that produce COinS metadata; see COinS in Wikipedia. If HTML or other markup is added, then the template must be reevaluated.

دستاويز سانچو[نمائش] [سنواريو] [تاريخچو] [تطهير]

This template is used on 650 pages, and changes to it will be widely noticed. Please test any changes in the template's /sandbox or /testcases subpages, or in a user subpage, and consider discussing changes at the talk page before implementing them.

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 زمرو: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. `<span class="citation book" >Sam Drucker. ''Title''.</span><span class="Z3988" title="ctx_ver=Z39.88-2004&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&rft.genre=book&rft.btitle=Title&rft.aulast=Sam+Drucker&rft.au=Sam+Drucker&rfr_id=info:sid/en.wikipedia.org:%D8%B3%D8%A7%D9%86%DA%86%D9%88:COinS_safe"><span style="display: none;"> </span></span>`
{{cite book \|author={{smallcaps\|Sam Drucker}} \|title=Title}}	Sam Drucker. Title. <span class="citation book" ><span class="smallcaps" style="font-variant:small-caps;">Sam Drucker</span>. ''Title''.</span><span class="Z3988" title="ctx_ver=Z39.88-2004&rft_val_fmt=info%3Aofi%2Ffmt%3Akev%3Amtx%3Abook&rft.genre=book&rft.btitle=Title&rft.aulast=%3Cspan+class%3D%22smallcaps%22+style%3D%22font-variant%3Asmall-caps%3B%22%3ESam+Drucker%3C%2Fspan%3E&rft.au=%3Cspan+class%3D%22smallcaps%22+style%3D%22font-variant%3Asmall-caps%3B%22%3ESam+Drucker%3C%2Fspan%3E&rfr_id=info:sid/en.wikipedia.org:%D8%B3%D8%A7%D9%86%DA%86%D9%88:COinS_safe"><span style="display: none;"> </span></span>

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.

Usage

Issue

See also