Quelltext der Seite Vorlage:Tweet/Doku

{{Documentation subpage}}
<!-- Add categories where indicated at the bottom of this page and interwikis at Wikidata -->
{{Tweet|name=Example|username=example|text=Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nunc dignissim, dolor vitae ullamcorper aliquet, velit mi sagittis metus.|date=12 Jul 2017|reference={{dummy reference}}}}

This template allows relevant tweets to be easily quoted within articles with a citation automatically generated, using {{tlx|cite tweet}}.

Using this template is better than a screen-shot of a tweet because the text is [[Wikipedia:Manual of Style/Accessibility|accessible]] to screen readers.

It is an alternative to standard quotation templates because it displays all relevant information about the tweet (date of posting, user's name, user's handle, etc). For quote tweets, use {{tl|quote tweet}}; alternatively, simply pass the quoted tweet, as a second Tweet template, to the <code>|reference=</code> parameter in this template.

==Usage==
=== Full blank syntax ===
<pre style="overflow:auto;">
{{Tweet
| name = 
| username = 
| replyto = 
| lang = 
| text = 
| translation = 
| date = 
| ID = 
| reference = 
| archive-url = 
| archive-date = 
| url-status = 
| image = 
| block = 
| left = 
| width = 
}}
</pre>

===Parameters===
* {{para|name}} user's name as it appears at the top of the tweet
* {{para|username}} user's @ handle (without the @)
* {{para|replyto}} optional: username tweet is replying to
* {{para|lang}} optional: language code of the tweet if non-English
* {{para|text}} content of the tweet
* {{para|translation}} optional: English translation of tweet if original tweet non-English
* {{para|date}} date of the tweet formatted according to MOS:DATE, should be used with tweets posted before November 4, 2010
* {{para|ID}} number at the end of the tweet URL
* {{para|reference}} optional: the template automatically creates a reference, but one can be provided to use instead. See 2nd example.
* {{para|archive-url}} optional: URL of an archived copy of the tweet. Ignored if {{para|reference}} is used.
* {{para|archive-date}} optional: date of the archived copy. Ignored if {{para|reference}} is used.
* {{para|url-status}}  optional: if set to 'live', the title displays as the live link; if set to 'dead', the title displays as the archive link. Ignored if {{para|reference}} is used.
* {{para|image}} optional: image or logo associated with Twitter account
* {{para|block}} optional: any value displays tweet as block with 500px width as default (text above and below, doesn't flow around).
* {{para|left}} optional: any value makes tweet aligned left
* {{para|width}} optional: custom tweet width, default is 220px

== Examples ==
===Tweets in english===
{{nowiki template demo|code=<nowiki>{{Tweet
| name = NASA
| username = NASA
| replyto = WilliamShatner
| text = @WilliamShatner Good day, Captain. #ISS is in standard orbit and Commander Swanson has the conn. Hope you're having a great weekend!
| date = Aug 2, 2014
| ID = 495719809695621121
| image = NASA logo.svg
| left = yes
}}</nowiki>}}
{{clear}}

{{nowiki template demo|code=<nowiki>{{Tweet
| name = René Descartes
| username = descartes
| lang = la
| text = Dubito, ergo cogito, ergo sum
| translation = I doubt, therefore I think, therefore I am
| date = 1 January 1637
| ref = {{dummy reference|2}}
| block = yes
}}</nowiki>}}
{{clear}}

===Tweets in another language===
It is possible to include tweets written in another language other than English by adding the <code>language</code> parameter and including the [[List of ISO 639-1 codes]] of the language.

{{nowiki template demo|code=<nowiki>{{Tweet
| name = Wikipédia em português
| username = wikipt
| text = Você sabia que... ...são necessárias de 1300 a 2000 azeitonas para produzir apenas 250 mililitros de azeite? Leia mais na Wikipédia: https://pt.wikipedia.org/wiki/Azeite
| date = 8 February 2022
| ID = 1491109619363729410
| image = Wikipedia-logo-v2-pt.svg
| left = yes
| width= 240px
| language = pt
}}
</nowiki>}}
{{clear}}

It's also possible to translate the tweet.

{{nowiki template demo|code=<nowiki>{{Tweet
| name = Wikipédia em português
| username = wikipt
| text = Você sabia que... ...são necessárias de 1300 a 2000 azeitonas para produzir apenas 250 mililitros de azeite? Leia mais na Wikipédia: https://pt.wikipedia.org/wiki/Azeite
| translation = Did you know... that it is necessary to have 1300 to 2000 olives to produce only 250 mililiters of olive oil? Read more about it on Wikipedia: https://pt.wikipedia.org/wiki/Azeite
| date = 8 February 2022
| ID = 1491109619363729410
| image = Wikipedia-logo-v2-pt.svg
| left = yes
| width= 240px
| language = pt
}}
</nowiki>}}
{{clear}}

==TemplateData==
<templatedata>
{
	"params": {
		"block": {
			"label": "block",
			"description": "Any value displays tweet as block (text above and below, doesn't flow around). Overrides left parameter",
			"type": "string"
		},
		"width": {
			"label": "width",
			"description": "Custom tweet width",
			"example": "300px",
			"type": "string"
		},
		"left": {
			"label": "left",
			"description": "Any value makes tweet aligned left",
			"type": "string"
		},
		"name": {
			"label": "name",
			"description": "User's name as it appears at the top of the tweet",
			"type": "string",
			"required": true
		},
		"username": {
			"label": "username",
			"description": "User's Twitter handle. Do not include the @ symbol.",
			"required": true
		},
		"date": {
			"label": "date",
			"description": "Date of the tweet formatted according to MOS:DATE",
			"type": "date",
			"required": true
		},
		"text": {
			"label": "text",
			"description": "Content of the tweet",
			"type": "string",
			"required": true
		},
		"ID": {
			"aliases": [
				"id"
			],
			"label": "ID",
			"description": "The number at the end of the tweet URL",
			"type": "number",
			"suggested": true
		},
		"reference": {
			"label": "reference",
			"description": "A custom reference can be provided to use instead of the automatically generated one",
			"example": "<ref>custom reference</ref>",
			"aliases": [
				"ref"
			],
			"type": "string"
		},
		"image": {
			"label": "image",
			"description": "Image or logo associated with twitter account",
			"type": "wiki-file-name"
		},
		"replyto": {
			"label": "replyto",
			"description": "Username the tweet is replying to",
			"type": "string"
		},
		"lang": {
			"label": "lang",
			"description": "language code of original tweet",
			"example": "de",
			"type": "string",
			"aliases": [
				"language"
			]
		},
		"translation": {
			"label": "translation",
			"description": "english translation of the tweet"
		},
		"nocategory": {},
		"archive-url": {},
		"archive-date": {},
		"url-status": {}
	},
	"description": "This template allows relevant tweets to be easily quoted within articles, with a citation automatically generated using the template, \"cite tweet\".\n\nUsing this template is better than a screen-shot of a tweet because the text is accessible to screen readers.\n\nIt is an alternative to standard quotation templates because it displays all relevant information about the tweet (date of posting, user's name, user's handle, etc) in a way that reflects Twitter's design language. For quote tweets use Template:Quote tweet.",
	"format": "block"
}
</templatedata>

==See also==
* {{tl|Cite tweet}} – for citing tweets
* {{tl|Quote tweet}} – for tweets that quote another tweet

== References ==
{{Reflist}}

<includeonly>{{sandbox other||
<!-- Categories below this line; interwikis at Wikidata -->
[[Category:Quotation templates]]
}}</includeonly>