Changes
Jump to navigation
Jump to search
Template:Free-content attribution/doc (view source)
Revision as of 13:12, 11 December 2021
, 3 years ago→See also: typo
{{Documentation subpage}}
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. -->
== Usage ==
To learn how to use this template to incorporate open license text on Wikipedia please see [[Wikipedia:Adding open license text to Wikipedia]]<br>
This template should be placed in the [[WP:LAYOUT#References|References section]] of an article if the article incorporates text from a source that is protected by a [[free content]] license and there is no source-specific template listed in [[:Category:Attribution templates]].
This template takes one required parameter and up to two optional parameters:
<syntaxhighlight lang="html">
{{Free-content attribution
|title= <!-- The title of the work -->
|author = <!-- The author of the work -->
|publisher = <!-- The publisher of the work -->
|source= <!-- The source of the work if not from the publisher or the author -->
|documentURL= <!-- The URL of the work -->
|license statement URL= <!-- The URL of the license statement of the work if not included within the document -->
|license= <!-- The license of the work -->
|howto= <!-- Only necessary if the template is used multiple times on the same page. Any value here will hide the last two sentences about instructions. -->
}}
</syntaxhighlight>
=== Using the built-in parameters ===
<code><nowiki>{{Free-content attribution |title=UNESCO - MAB Biosphere Reserves Directory |author=A.N. Author |publisher=UNESCO |source= |license = CC BY-SA IGO 3.0 |documentURL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/europe-north-america/france/fontainebleau-et-du-gatinais/ |license statement URL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/world-network-wnbr/wnbr/}}</nowiki></code>
:Result without using {{para|howto}}:
::{{Free-content attribution |title=UNESCO - MAB Biosphere Reserves Directory |author=A.N. Author |publisher=UNESCO |source= |license = CC BY-SA IGO 3.0 |documentURL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/europe-north-america/france/fontainebleau-et-du-gatinais/ |license statement URL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/world-network-wnbr/wnbr/}}
----
<code><nowiki>{{Free-content attribution |title=UNESCO - MAB Biosphere Reserves Directory |author=A.N. Author |publisher=UNESCO |source= |license = CC BY-SA IGO 3.0 |documentURL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/europe-north-america/france/fontainebleau-et-du-gatinais/ |license statement URL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/world-network-wnbr/wnbr/ |howto=no}}</nowiki></code>
:Result when using {{para|howto}}:
::{{Free-content attribution |title=UNESCO - MAB Biosphere Reserves Directory |author=A.N. Author |publisher=UNESCO |source= |license = CC BY-SA IGO 3.0 |documentURL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/europe-north-america/france/fontainebleau-et-du-gatinais/ |license statement URL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/world-network-wnbr/wnbr/ |howto=no}}
== Hidden category ==
This template includes a hidden category — {{clc|Free-content attribution}} — which does not appear at the bottom of an article page (unless hidden categories are set to display, in the user's settings), but does contain any article page that contains this template.
== TemplateData ==
{{TemplateData header}}
<templatedata>
{
"params": {
"1": {
"label": "1",
"description": "A string or template to be used instead of the built-in parameters",
"example": "{{cite book |last1=Doe |first1=J. |title=Some Work |volume=Vol. 1, Part 2. |year=2000 |publisher=Foo Publishing House}}",
"type": "string"
},
"license": {
"suggested": true,
"label": {
"en": "License",
"en-gb": "Licence"
},
"description": {
"en": "The license covering the referred work(s); may be linked",
"en-gb": "The licence covering the referred work(s); may be linked"
},
"type": "string",
"example": "CC BY-SA",
"aliases": [
"License"
]
},
"author": {
"label": "Author",
"description": "The author or authors of the work",
"type": "string",
"suggested": true,
"aliases": [
"Author"
]
},
"title": {
"label": "Title",
"description": "The title of the work",
"type": "string",
"required": true,
"suggested": true,
"aliases": [
"Title"
]
},
"page numbers": {
"label": "Page numbers",
"description": "The page numbers used if applicable",
"type": "string",
"suggested": true,
"aliases": [
"Page numbers"
]
},
"documentURL": {
"label": "Document URL",
"description": "The URL of the document",
"type": "url",
"suggested": true,
"aliases": [
"DocumentURL"
]
},
"publisher": {
"label": "Publisher",
"description": "The publisher of the work",
"type": "string",
"suggested": true,
"aliases": [
"Publisher"
]
},
"license statement URL": {
"label": "License statement URL",
"description": "The URL of the license statement if not stated in the document",
"type": "url",
"suggested": true,
"aliases": [
"License statement URL"
]
},
"source": {
"label": "Source",
"description": "The source of the text e.g a third party website hosting the document",
"type": "string",
"suggested": true,
"aliases": [
"Source"
]
},
"howto": {
"label":"Howto",
"description": "Any value in this parameter will suppress the last two sentences of the template about instructions. This is only necessary if the template is used multiple times on the same page.",
"type": "string",
"suggested": false,
"aliases": [
"Howto",
"how-to",
"How-to"
]
}
},
"format": "block",
"description": {
"en": "Explain that an article incorporates text from a source that is protected by a free-content license. Place in the article's references section.",
"en-gb": "Explain that an article incorporates text from a source that is protected by a free-content licence. Place in the article's references section."
},
"paramOrder": [
"title",
"author",
"publisher",
"page numbers",
"source",
"documentURL",
"license statement URL",
"license",
"1",
"howto"
]
}
</templatedata>
== See also ==
*{{tl|Wikia content}}
*{{tl|source-attribution}} - a template that can be placed in the [[WP:LAYOUT#References|References section]] of an article if the article incorporates text from a source that is not under copyright and there is no source specific template listed in Category:Attribution templates.
*{{tl|citation-attribution}} - a template that can be placed at the end of a sentence, sentences or a paragraph that incorporates text from a source that is not under copyright. It is an alternative to this template if only a few sentences or a paragraph has been copied.
*{{tl|Academic peer reviewed}} - a template that is used for articles adapted from peer reviewed academic publications ([[:Category:Wikipedia articles published in peer-reviewed literature|category]])
<includeonly>{{Sandbox other||
<!-- Categories go here, and interwikis go in Wikidata -->
[[Category:Attribution templates|*{{PAGENAME}}]]
}}</includeonly>
<!-- Categories go at the bottom of this page and interwikis go in Wikidata. -->
== Usage ==
To learn how to use this template to incorporate open license text on Wikipedia please see [[Wikipedia:Adding open license text to Wikipedia]]<br>
This template should be placed in the [[WP:LAYOUT#References|References section]] of an article if the article incorporates text from a source that is protected by a [[free content]] license and there is no source-specific template listed in [[:Category:Attribution templates]].
This template takes one required parameter and up to two optional parameters:
<syntaxhighlight lang="html">
{{Free-content attribution
|title= <!-- The title of the work -->
|author = <!-- The author of the work -->
|publisher = <!-- The publisher of the work -->
|source= <!-- The source of the work if not from the publisher or the author -->
|documentURL= <!-- The URL of the work -->
|license statement URL= <!-- The URL of the license statement of the work if not included within the document -->
|license= <!-- The license of the work -->
|howto= <!-- Only necessary if the template is used multiple times on the same page. Any value here will hide the last two sentences about instructions. -->
}}
</syntaxhighlight>
=== Using the built-in parameters ===
<code><nowiki>{{Free-content attribution |title=UNESCO - MAB Biosphere Reserves Directory |author=A.N. Author |publisher=UNESCO |source= |license = CC BY-SA IGO 3.0 |documentURL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/europe-north-america/france/fontainebleau-et-du-gatinais/ |license statement URL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/world-network-wnbr/wnbr/}}</nowiki></code>
:Result without using {{para|howto}}:
::{{Free-content attribution |title=UNESCO - MAB Biosphere Reserves Directory |author=A.N. Author |publisher=UNESCO |source= |license = CC BY-SA IGO 3.0 |documentURL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/europe-north-america/france/fontainebleau-et-du-gatinais/ |license statement URL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/world-network-wnbr/wnbr/}}
----
<code><nowiki>{{Free-content attribution |title=UNESCO - MAB Biosphere Reserves Directory |author=A.N. Author |publisher=UNESCO |source= |license = CC BY-SA IGO 3.0 |documentURL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/europe-north-america/france/fontainebleau-et-du-gatinais/ |license statement URL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/world-network-wnbr/wnbr/ |howto=no}}</nowiki></code>
:Result when using {{para|howto}}:
::{{Free-content attribution |title=UNESCO - MAB Biosphere Reserves Directory |author=A.N. Author |publisher=UNESCO |source= |license = CC BY-SA IGO 3.0 |documentURL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/europe-north-america/france/fontainebleau-et-du-gatinais/ |license statement URL=http://www.unesco.org/new/en/natural-sciences/environment/ecological-sciences/biosphere-reserves/world-network-wnbr/wnbr/ |howto=no}}
== Hidden category ==
This template includes a hidden category — {{clc|Free-content attribution}} — which does not appear at the bottom of an article page (unless hidden categories are set to display, in the user's settings), but does contain any article page that contains this template.
== TemplateData ==
{{TemplateData header}}
<templatedata>
{
"params": {
"1": {
"label": "1",
"description": "A string or template to be used instead of the built-in parameters",
"example": "{{cite book |last1=Doe |first1=J. |title=Some Work |volume=Vol. 1, Part 2. |year=2000 |publisher=Foo Publishing House}}",
"type": "string"
},
"license": {
"suggested": true,
"label": {
"en": "License",
"en-gb": "Licence"
},
"description": {
"en": "The license covering the referred work(s); may be linked",
"en-gb": "The licence covering the referred work(s); may be linked"
},
"type": "string",
"example": "CC BY-SA",
"aliases": [
"License"
]
},
"author": {
"label": "Author",
"description": "The author or authors of the work",
"type": "string",
"suggested": true,
"aliases": [
"Author"
]
},
"title": {
"label": "Title",
"description": "The title of the work",
"type": "string",
"required": true,
"suggested": true,
"aliases": [
"Title"
]
},
"page numbers": {
"label": "Page numbers",
"description": "The page numbers used if applicable",
"type": "string",
"suggested": true,
"aliases": [
"Page numbers"
]
},
"documentURL": {
"label": "Document URL",
"description": "The URL of the document",
"type": "url",
"suggested": true,
"aliases": [
"DocumentURL"
]
},
"publisher": {
"label": "Publisher",
"description": "The publisher of the work",
"type": "string",
"suggested": true,
"aliases": [
"Publisher"
]
},
"license statement URL": {
"label": "License statement URL",
"description": "The URL of the license statement if not stated in the document",
"type": "url",
"suggested": true,
"aliases": [
"License statement URL"
]
},
"source": {
"label": "Source",
"description": "The source of the text e.g a third party website hosting the document",
"type": "string",
"suggested": true,
"aliases": [
"Source"
]
},
"howto": {
"label":"Howto",
"description": "Any value in this parameter will suppress the last two sentences of the template about instructions. This is only necessary if the template is used multiple times on the same page.",
"type": "string",
"suggested": false,
"aliases": [
"Howto",
"how-to",
"How-to"
]
}
},
"format": "block",
"description": {
"en": "Explain that an article incorporates text from a source that is protected by a free-content license. Place in the article's references section.",
"en-gb": "Explain that an article incorporates text from a source that is protected by a free-content licence. Place in the article's references section."
},
"paramOrder": [
"title",
"author",
"publisher",
"page numbers",
"source",
"documentURL",
"license statement URL",
"license",
"1",
"howto"
]
}
</templatedata>
== See also ==
*{{tl|Wikia content}}
*{{tl|source-attribution}} - a template that can be placed in the [[WP:LAYOUT#References|References section]] of an article if the article incorporates text from a source that is not under copyright and there is no source specific template listed in Category:Attribution templates.
*{{tl|citation-attribution}} - a template that can be placed at the end of a sentence, sentences or a paragraph that incorporates text from a source that is not under copyright. It is an alternative to this template if only a few sentences or a paragraph has been copied.
*{{tl|Academic peer reviewed}} - a template that is used for articles adapted from peer reviewed academic publications ([[:Category:Wikipedia articles published in peer-reviewed literature|category]])
<includeonly>{{Sandbox other||
<!-- Categories go here, and interwikis go in Wikidata -->
[[Category:Attribution templates|*{{PAGENAME}}]]
}}</includeonly>