Template:Selfref/doc: Difference between revisions
meta>Galobtter +text, on other templates |
m 73 revisions imported |
||
(20 intermediate revisions by 13 users not shown) | |||
Line 4: | Line 4: | ||
<!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE, AND INTERWIKIS TO WIKIDATA. --> | <!-- PLEASE ADD CATEGORIES AT THE BOTTOM OF THIS PAGE, AND INTERWIKIS TO WIKIDATA. --> | ||
The {{ | The {{tlf|Selfref|text}} template adds to a Wikipedia article a [[WP:HAT|hatnote]] (in this case, merely: ''text'') that will ''not appear'' in any [[WP:Reusing Wikipedia content|reuse of Wikipedia article content]]. In [[WP:Glossary|Wikipedia terminology]], self-references in an article usually mention Wikipedia directly or tell readers to take an action that has to take place on Wikipedia, such as editing the article. Typically, self-references within Wikipedia articles to the Wikipedia project should be avoided. Reading such information off-site would only cause confusion. | ||
With this template, you can safely make a self-reference ''where needed'', but that need is rare. Before using this template, make sure the self-reference that you're thinking of adding doesn't fall into one of the types listed at [[Wikipedia:Self-references to avoid]]. Most other hatnote templates, such as {{t|for}} and {{t|about}} support a {{para|selfref}} parameter which may be more convenient to use. | With this template, you can safely make a self-reference ''where needed'', but that need is rare. Before using this template, make sure the self-reference that you're thinking of adding doesn't fall into one of the types listed at [[Wikipedia:Self-references to avoid]]. Most other hatnote templates, such as {{t|for}} and {{t|about}} support a {{para|selfref}} parameter which may be more convenient to use. | ||
Line 11: | Line 11: | ||
== Usage == | == Usage == | ||
This template should not be [[WP:Template substitution|substituted]]. | This template should not be [[WP:Template substitution|substituted]]. | ||
Line 18: | Line 17: | ||
When using {{tlf|Selfref}} in this way, use the following format: | When using {{tlf|Selfref}} in this way, use the following format: | ||
<pre> | <pre> | ||
{{Selfref|The self-referential notice to display, including links.}} | {{Selfref|The self-referential notice to display, including [[MOS:LINK|links]].}} | ||
</pre> | </pre> | ||
which produces: | which produces: | ||
{{Selfref|The self-referential notice to display, including links.}} | {{Selfref|The self-referential notice to display, including [[MOS:LINK|links]].}} | ||
italicized (Wikipedia house style for self-referential notes), and both preceded and followed by a linebreak. | |||
For inline use (in body text, mid-sentence, and {{em|not}} in hatnotes), without the indentation and line breaking, use {{tlx|Selfref inline}}: | |||
<pre> | <pre> | ||
{{Selfref|the self-referential text to display, including links | {{Selfref inline|the self-referential text to display, including [[MOS:LINKS|links]]}} | ||
</pre> | </pre> | ||
which produces: {{Selfref inline|the self-referential text to display, including [[MOS:LINKS|links]]}} (illustrated here on the same line as other content). | |||
Template {{tnull|Selfref}} also has the parameter {{para||inline}}: | |||
<pre> | <pre> | ||
{{Selfref | {{Selfref|the self-referential text to display, including [[MOS:LINKS|links]]|inline}} | ||
</pre> | </pre> | ||
However, {{as of |alt=as of early 2019|2019|01|post=,}} it does not always function properly, and may cause a line break under some circumstances. | |||
===Unprintworthy content=== | === Unprintworthy content === | ||
Rarely, there is other, non-self-referential content which shouldn't appear in mirrors, print editions, or other off-Wikipedia reuses of Wikipedia content, and which shouldn't be italicized as a self-reference. | Rarely, there is other, non-self-referential content which shouldn't appear in mirrors, print editions, or other off-Wikipedia reuses of Wikipedia content, and which shouldn't be italicized as a self-reference. | ||
It is preferable to mark such unprintworthy content with the {{tl|Unprintworthy inline}} template (which includes the <code>noprint</code> CSS class, but not the <code>plainlinks</code> class, since links in such content will not be internal self-references). Although not all [[WP:Mirrors and forks|mirror sites]] do so, the content in question can be removed by reusers of WP content, without any reformatting, by ignoring or removing content marked up by this template, or more accurately by the <code>selfreference</code> CSS class that it (and some other templates) use. | It is preferable to mark such unprintworthy content with the {{tl|Unprintworthy inline}} template (which includes the <code>noprint</code> CSS class, but not the <code>plainlinks</code> class, since links in such content will not be internal self-references). Although not all [[WP:Mirrors and forks|mirror sites]] do so, the content in question can be removed by reusers of WP content, without any reformatting, by ignoring or removing content marked up by this template, or more accurately by the <code>selfreference</code> CSS class that it (and some other templates) use. | ||
'''Note: The following syntax has been obsolete since 2008, and if you see it, replace it as described below.''' | |||
There was a {{em|deprecated}}, pre-2008 legacy usage of {{tlf|Selfref}} that was used for such unprintworthy cases, and pre-dates the {{tl|Unprintworthy inline}} template. This is to simply end the template with a pipe character – <code>|</code>: | |||
{{dc2|1=<pre> | {{dc2|1=<pre> | ||
{{Selfref|the unprintworthy text to display without self-ref styling|}}</pre>}} | {{Selfref|the unprintworthy text to display without self-ref styling|}}</pre>}} | ||
This method cannot be depended upon | This method cannot be depended upon. For one thing, many editors would interpret the ending pipe as an error and remove it, turning the template into an indented self-ref hatnote! It also has not been used since 2008. Any remaining uses of it should be replaced with {{tl|Selfref inline}} (if real a self-references) or {{tl|Unprintworthy inline}} (if simply unprintworthy). | ||
== Example == | == Example == | ||
{|border=1 class="wikitable" | {|border=1 class="wikitable" | ||
! Code !! Page on Wikipedia !! Page on [some] mirrors | ! Code !! Page on Wikipedia !! Page on [some] mirrors | ||
Line 58: | Line 61: | ||
== See also == | == See also == | ||
*[[Wikipedia:Self-references to avoid]] | *[[Wikipedia:Self-references to avoid]] | ||
*{{tlx|srlink}}, for the opposite case when you want a link to the Wikipedia: namespace that ''does'' show in mirrors without breaking (for instance when writing an article about Wikipedia or something connected to it). | *{{tlx|srlink}}, for the opposite case when you want a link to the Wikipedia: namespace that ''does'' show in mirrors without breaking (for instance when writing an article about Wikipedia or something connected to it). | ||
*{{tlx|Printworthy selfref}} – for cases of self-references that are printworthy and may or may not be desired by reusers of WP content, depending upon whether they are mirroring or just using single articles | *{{tlx|Printworthy selfref}} – for cases of self-references that are printworthy and may or may not be desired by reusers of WP content, depending upon whether they are mirroring or just using single articles | ||
* {{tlx|Unprintworthy inline}} – for unprintworthy inline material that isn't technically a self-reference | *{{tlx|Unprintworthy inline}} – for unprintworthy inline material that isn't technically a self-reference | ||
* [[Wikipedia:Hatnote]] | *[[Wikipedia:Hatnote]] | ||
{{Navbox hatnote templates|state=collapsed}} | {{Navbox hatnote templates|state=collapsed}}<includeonly>{{sandbox other|| | ||
<!-- PLEASE ADD CATEGORIES BELOW THIS LINE, THANK YOU. --> | |||
<includeonly><!-- | |||
[[Category:Wikipedia self-reference templates]]<!--For both forms of this template.--> | [[Category:Wikipedia self-reference templates]]<!--For both forms of this template.--> | ||
[[Category:Disambiguation and redirection templates]]<!--For frequent use atop DAB pages; it's not actually a DAB/redir template, per se.--> | [[Category:Disambiguation and redirection templates]]<!--For frequent use atop DAB pages; it's not actually a DAB/redir template, per se.--> | ||
[[Category:Wikipedia page-section templates]]<!--For hatnote usage only.--> | [[Category:Wikipedia page-section templates]]<!--For hatnote usage only.--> | ||
[[Category:Cross-reference templates]]<!--For the inline usage.--> | [[Category:Cross-reference templates]]<!--For the inline usage.--> | ||
</includeonly> | }}</includeonly> |
Latest revision as of 13:45, 3 September 2020
This is a documentation subpage for Template:Selfref. It may contain usage information, categories and other content that is not part of the original template page. |
This template is used on approximately 2,400 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them. |
The {{Selfref|text}} template adds to a Wikipedia article a hatnote (in this case, merely: text) that will not appear in any reuse of Wikipedia article content. In Wikipedia terminology, self-references in an article usually mention Wikipedia directly or tell readers to take an action that has to take place on Wikipedia, such as editing the article. Typically, self-references within Wikipedia articles to the Wikipedia project should be avoided. Reading such information off-site would only cause confusion.
With this template, you can safely make a self-reference where needed, but that need is rare. Before using this template, make sure the self-reference that you're thinking of adding doesn't fall into one of the types listed at Wikipedia:Self-references to avoid. Most other hatnote templates, such as {{for}} and {{about}} support a |selfref=
parameter which may be more convenient to use.
To see this behavior, view a printable version of an article that has a self-reference hatnote, and notice how this template masks its content.
Usage
This template should not be substituted.
In most cases, {{Selfref}} is used to create a disambiguation link to a page in the "Wikipedia:" namespace from article-space; for instance, the page Objectivity (disambiguation) could have a self-referential "hatnote" link at the top: {{Selfref|For Wikipedia's policy on avoiding bias, see [[Wikipedia:Neutral point of view]].}}
.
When using {{Selfref}} in this way, use the following format:
{{Selfref|The self-referential notice to display, including [[MOS:LINK|links]].}}
which produces:
italicized (Wikipedia house style for self-referential notes), and both preceded and followed by a linebreak.
For inline use (in body text, mid-sentence, and not in hatnotes), without the indentation and line breaking, use {{Selfref inline}}
:
{{Selfref inline|the self-referential text to display, including [[MOS:LINKS|links]]}}
which produces: