View source for Template:Ytv/doc

<noinclude>{{doc subpage}}[[Category:Template documentation]]</noinclude>
== Documentation ==

This template forms external links to YouTube videos. [[#See also|Other templates exist]] for linking to playlists, channels, etc.

The name of the template is based on the phrase "{{tt|<u>y</u>ou<u>t</u>ube <u>v</u>ideo}}".

=== Usage ===

* <code><nowiki>{{ytv</nowiki>|<var>video id</var>|<var>text to be linked</var>}}</code>
* <code><nowiki>{{ytv</nowiki>|<var>video id</var>|<var>text to be linked</var>|t=<var>timepoint</var>}}</code>
* <code><nowiki>{{ytv</nowiki>|v=<var>video id</var>|linktext=<var>text to be linked</var>}}</code>
* <code><nowiki>{{ytv</nowiki>|v=<var>video id</var>|t=<var>timepoint</var>|linktext=<var>text to be linked</var>}}</code>

Note that the {{tp|t}} named parameter can actually appear between the {{tpvv|video id}} and {{tpvv|text to be linked}} positional parameters, (as it is in the last example using all named parameters), but that order just looks weird when not all the parameters are named.

=== Examples ===

* <code><nowiki>{{ytv|nwFloCPXzCs|Angelina Jordan - I Put A Spell On You}}</nowiki></code> ⇒ {{ytv|nwFloCPXzCs|Angelina Jordan - I Put A Spell On You}}
* <code><nowiki>{{ytv|v=nwFloCPXzCs|linktext=Angelina Jordan - I Put A Spell On You}}</nowiki></code> ⇒ {{ytv|v=nwFloCPXzCs|linktext=Angelina Jordan - I Put A Spell On You}}
* <code><nowiki>{{ytv|v=nwFloCPXzCs|t=36s|linktext=Angelina Jordan - I Put A Spell On You}}</nowiki></code> ⇒ {{ytv|v=nwFloCPXzCs|t=36s|linktext=Angelina Jordan - I Put A Spell On You}}

==== Errors ====

* <code><nowiki>{{ytv}}</nowiki></code> ⇒ {{ytv}}
* <code><nowiki>{{ytv|linktext=Not actually a YouTube video}}</nowiki></code> ⇒ {{ytv|linktext=Not actually a YouTube video}}

These are equivalent in terms of the link target they use, which is YouTube's homepage — but if you wanted to link to that, you should have used {{tl|ytl}}:

* <code><nowiki>{{ytl}}</nowiki></code> ⇒ {{ytl}}

=== See also ===

{{List of similar yt templates}}

<includeonly>
[[Category:Templates]]
[[Category:Templates for linking to YouTube]]
[[Category:Templates that can be called with or without input]]
</includeonly>