Template talk:Podcast: Difference between revisions

Latest revision as of 02:50, 9 March 2013

Guide

This is a guide on how to properly use this infobox template. Please note that this guide reveals fields that may not be found in the example on the template page.

Colors [color/bordercolor/corecolor]

The colors that are displayed in the infobox. They usually match colors found in the podcast's artwork. Specific colors are defined using their hex triplet codes.

Podcast name [podcastname]

Obviously, the name of the podcast goes here. The podcast's name is displayed in italics.

Affiliated website [mainsite/sitename]

If the podcast has an affiliated website which is significant enough to be mentioned in the podcast’s article, but not enough to have its own separate Bulbapedia article, then it should be mentioned. The website's name is below podcast's name in smaller, plain text. If the podcast does not have a significant affiliated website, or if it is part of a larger website that has its own Bulbapedia article (e.g. Bulbagarden’s Bulbacast), then enter no in mainsite and ignore the website’s name. If the website is significant, but shares the same name as the podcast, then ignore adding sitename.

Note that various fields are added or changed in the infobox if mainsite says yes. These fields are marked with [mainsite change] or [mainsite add] at the end of their sections in this how-to guide.

Slogan [slogan/sloganline]

If it has one, this will show either a phrase often repeated in the podcast or a slogan that appears in the podcast's description or website.

Image and caption [image/size/caption]

The podcast art should be displayed here in a given size (by width). The recommended size (width) is 240px (pixels), which is usually the size of podcast art as displayed on a portable device, such as an iPod or a Zune. If the image provided has a width smaller than 240px, either enter the image’s full width or provide a larger version of the image that is at least 240px wide.

The RSS feed icon is used as the displayed art for the fictional example podcast, with the caption saying that the actual art for the podcast is not available. The icon is used in the example mainly because the podcast simply doesn't exist. All podcasts mentioned on Bulbapedia will need to have their podcast art displayed in the infobox. The podcast also needs its own unique artwork; the usage of the RSS feed icon as the podcast image will not be accepted.

The image’s caption should say that the image displayed is (apparently) the podcast art, along with a small description of what's in the artwork, if possible.

Language [lang]

The language that the podcast is recorded in. This will normally be English, considering that all podcasts mentioned here are English language podcasts. This is not to say that there aren't any non-English Pokémon podcasts at all, but the amount of Pokémon podcasts that are not in English are so few and far between that they're not really going to have much of a presence on this site. You may have better luck finding articles on such podcasts on one of Bulbapedia's affiliate wikis.

Status

Podcast [podcast_status]

The production status of the podcast. This should be described as being "Active"/"Ongoing", "On hiatus", or "Ended"/"Defunct".

Active/Ongoing - Podcast is still producing new episodes on a regular basis.
On hiatus - Podcast is taking a break from production or has not updated for a long period of time.
Ended/Defunct - Podcast has stopped producing new episodes altogether. "Ended" will be used for podcasts that have decided and managed to produce a final episode, while "Defunct" will be used if the podcast did not announce that it was going to end, hasn’t updated for a long time, and is presumed to be dead. [mainsite change]

Website [site_status]

If necessary, this tells whether or not the website is active. This should be displayed as either "Active" or "Defunct". "Outdated" could also be used in conjunction if the site hasn’t received an significant update, such as a blog post, in a while. [mainsite add]

Run

Podcast [podcast_run]

Any and all of the podcast's separate runs, from the month and year of one run’s beginning to the month and year of that run’s end. If a podcast had more than one run, which is affected by the podcast officially ending a run or going into a long hiatus, please define the runs with line breaks and what episodes (or seasons) were a part of that run. If a podcast is still ongoing, then the last run period should end with "Present". [mainsite change]

Website [site_run]

If necessary, this will be similar to the above, but will usually have only one run. [mainsite add]

Podcast debuted [debut]

This shows the date when the first episode of the podcast was published, not recorded.

Last episode published [final]

If the podcast has ended or is on hiatus, enter the last episode's publish date in final.

Website opened [site_open]

If necessary, this will display the date that the website opened. This may include dates when the podcast changed its name and URL. [mainsite add]

Website closed [site_close]

If necessary, this will display the date that the podcast's website was permanently taken offline, if the website is closed. If the website is closed, enter the website closing date in site_close. Note that this field is not affected by mainsite.

Reason [reason]

If necessary, this tells the reason why the podcast has ended. If there is a reason, enter it in reason.

Creator(s) [creator]

Tells the name(s) and/or alias(es) of who made the podcast and, if necessary, website.

Host(s) [host]

Shows the name(s) or alias(es) of the current main podcast host(s). Also, it's usually the creator of the show who is always the host, but it may change over time. If the show has had multiple hosts, it's best to state et al. after the main host's name and, if possible, link to a list of other hosts or co-hosts in another section of the article. If the podcast has a wide variety of hosts (such as Bulbacast), enter "Various" instead.

Number of Episodes [noepisodes]

Displays the number of episodes that the podcast has published, obviously. If the podcast is still active or ongoing, or even if it's on hiatus, add an "as of" date.

For example:
noepisodes=51 <small>(as of December 21, 2012)</small>|

Will show in the infobox:

51 (as of December 21, 2012)

Forum [forum]

Provides a link to the podcast's or website's forums, if there are any. If there are forums for the podcast or its website, enter the forums' name as a weblink in forum.

Mascot [mascot]

If the podcast or its website has a mascot, enter the mascot's name in mascot. The mascot is pretty much going to be a Pokémon, so enter the name as a Pokémon shortlink. (See BP:LLT for more information on link templates.)

Website [weblink]

Goes to podcast's website, whether or not it's that important. As the technical name of this field shows, this is usually displayed as a weblink.

Feed

This is the most important field of the podcast infobox. As the name shows, this provides the podcast's RSS feed and other feed links. This is how people subscribe to podcasts. There are four parameters to the "Feed" field: RSS, iTunes, Zune, and Other.

With this field in mind, please remember that Bulbapedia is not a podcast directory for all Pokémon-focused podcasts; only Pokémon podcasts that are notable based on either their contributions to or popularity within the fandom. Bulbapedia originally rejected the now-popular It's Super Effective podcast from having an article here back in 2010 because it was only a relatively new Pokémon podcast at the time. It was about three months old when someone tried to make an article about that podcast twice and it wasn't well-known or very popular back then. A year later, they have now become more popular than the late WTPT - Pokémon Radio and earned their article, although the article name was moved from It's Super Effective (which now redirects to a section in damage modification) to its current name, It's Super Effective (podcast).

Simply put, if you've just started your podcast about a month ago, it's not going to be any worth mentioning here. If you've actually been holding your podcast for over a year now, but most fans haven't even heard of it or if it's considered just a typical, everyday, ho-hum, generic Pokémon podcast, then it's probably not going to appear here either.

RSS feed [rss]

All podcasts have an RSS feed. In rss, enter the most recent URL of the podcast's RSS feed, which usually ends in ".xml". (Feeds are stored and defined in XML files.) It needs to be entered even if the podcast has ended and even if there are no content in the feed.

The link is displayed as the RSS icon:

iTunes Store [itunes]

Virtually every podcast that's ever made is available on the iTunes Store, so a link to the popular online store and podcast directory is needed in the infobox as a de facto inclusion. In itunes, enter the URL of the podcast's entry on iTunes. The URL should show "itunes.apple.com" or "phobos.apple.com" at the beginning after the "http://". Like the above, it needs to be entered regardless of its status or amount of content.

The link is displayed as Apple's podcasting logo:

Zune Marketplace [zune]

Unlike the two above, this one is optional, as not all podcasts are available on the Zune Marketplace. The Zune Marketplace, while nowhere near as popular as iTunes, is considered a major online store and podcast directory. If the podcast is available on the Zune Marketplace, and Zune is using its current feed, enter yes in zune.

Previously, any Pokémon podcasts that were available on Zune required a link to "social.zune.net" using zune_link to prove its availability there. In October 2012, Microsoft has shut down Zune.net and any Zune podcast links here will redirect to the Zune service support site at Xbox.com. For that reason, we no longer have zune_link in the template code. We are currently not discontinuing the zune field of the template, but from now on, clicking on the Zune logo in the infobox will go directly to the new Zune web page on Xbox.com. (Note: Bulbapedia is not affiliated with Microsoft in any way and does not either support or oppose their services.) If you are able to find the podcast's current feed on Zune, you can still enter zune=yes; the Zune logo will appear with the new link, and the new tooltip text "podcastname can be found on the Zune Marketplace." will pop up when you hover your cursor over the logo.

@@ Line 1: / Line 1: @@
-==Usage notes==
+==Guide==
-Some of the notes found underneath may specifically relate to the example podcast on the template page, which is a fictional podcast:
+This is a guide on how to properly use this infobox template. Please note that this guide reveals fields that may not be found in the example on the template page.
-*The RSS feed icon is used as the displayed art for the fictional example podcast, with the caption saying that the actual art for the podcast is not available. The icon is used in the example mainly because the podcast simply doesn't exist. All podcasts mentioned on Bulbapedia will need to have their podcast art displayed in the infobox. The podcast also needs its own unique artwork; Bulbapedia will not accept the usage of the RSS feed icon as the podcast image.
-*Had the fictional podcast not ended, the "Number of Episodes" would show [http://tvtropes.org/pmwiki/pmwiki.php/Main/ExactlyWhatItSaysOnTheTin exactly what it sounds like] and, in parentheses, "as of [the nth episode's publish date]". Thus it would show, "51 (as of December 21, 2012)".
+===Colors [color/bordercolor/corecolor]===
+The colors that are displayed in the infobox. They usually match colors found in the podcast's artwork. Specific colors are defined using their {{wp|Web colors#Hex triplet|hex triplet}} codes.
+===Podcast name [podcastname]===
+Obviously, the name of the podcast goes here. The podcast's name is displayed in italics.
+===Affiliated website [mainsite/sitename]===
+If the podcast has an affiliated website which is significant enough to be mentioned in the podcast’s article, but not enough to have its own separate Bulbapedia article, then it should be mentioned. The website's name is below podcast's name in smaller, plain text. If the podcast does not have a significant affiliated website, or if it is part of a larger website that has its own Bulbapedia article (e.g. [[Bulbagarden]]’s ''[[Bulbacast]]''), then enter <code>no</code> in <code>mainsite</code> and ignore the website’s name. If the website is significant, but shares the same name as the podcast, then ignore adding <code>sitename</code>.
+Note that various fields are added or changed in the infobox if <code>mainsite</code> says <code>yes</code>. These fields are marked with <small><b>[<i>mainsite change</i>]</b></small> or <small><b>[<i>mainsite add</i>]</b></small> at the end of their sections in this how-to guide.
+===Slogan [slogan/sloganline]===
+If it has one, this will show either a phrase often repeated in the podcast or a slogan that appears in the podcast's description or website.
+===Image and caption [image/size/caption]===
+The podcast art should be displayed here in a given size (by width). The recommended size (width) is 240px (pixels), which is usually the size of podcast art as displayed on a portable device, such as an {{wp|iPod}} or a {{wp|Zune}}. If the image provided has a width smaller than 240px, either enter the image’s full width or provide a larger version of the image that is at least 240px wide.
+The RSS feed icon is used as the displayed art for the fictional example podcast, with the caption saying that the actual art for the podcast is not available. The icon is used in the example mainly because the podcast simply doesn't exist. All podcasts mentioned on Bulbapedia will need to have their podcast art displayed in the infobox. The podcast also needs its own unique artwork; the usage of the RSS feed icon as the podcast image will not be accepted.
+The image’s caption should say that the image displayed is (apparently) the podcast art, along with a small description of what's in the artwork, if possible.
+===Language [lang]===
+The language that the podcast is recorded in. This will normally be English, considering that all podcasts mentioned ''[[Bulbapedia|here]]'' are {{wp|English language}} podcasts. This is not to say that there aren't any non-English Pokémon podcasts ''at all'', but the amount of Pokémon podcasts that are not in English are so few and far between that they're not really going to have much of a presence on this site. You may have better luck finding articles on such podcasts on one of Bulbapedia's [[Encyclopædiæ Pokémonis|affiliate wikis]].
+===Status===
+====Podcast [podcast_status]====
+The production status of the podcast. This should be described as being "Active"/"Ongoing", "On hiatus", or "Ended"/"Defunct".
+* '''Active'''/'''Ongoing''' - Podcast is still producing new episodes on a regular basis.
+* '''On hiatus''' - Podcast is taking a break from production or has not updated for a long period of time.
+* '''Ended'''/'''Defunct''' - Podcast has stopped producing new episodes altogether. "Ended" will be used for podcasts that have decided and managed to produce a final episode, while "Defunct" will be used if the podcast did not announce that it was going to end, hasn’t updated for a ''long'' time, and is presumed to be dead. <small><b>[<i>mainsite change</i>]</b></small>
+====Website [site_status]====
+If necessary, this tells whether or not the website is active. This should be displayed as either "Active" or "Defunct". "Outdated" could also be used in conjunction if the site hasn’t received an significant update, such as a blog post, in a while. <small><b>[<i>mainsite add</i>]</b></small>
+===Run===
+====Podcast [podcast_run]====
+Any and all of the podcast's ''separate'' runs, from the month and year of one run’s beginning to the month and year of that run’s end. If a podcast had more than one run, which is affected by the podcast officially ending a run or going into a long hiatus, please define the runs with line breaks and what episodes (or [[Bulbacast|seasons]]) were a part of that run. If a podcast is still ongoing, then the last run period should end with "Present". <small><b>[<i>mainsite change</i>]</b></small>
+====Website [site_run]====
+If necessary, this will be similar to the above, but will usually have only one run. <small><b>[<i>mainsite add</i>]</b></small>
+===Podcast debuted [debut]===
+This shows the date when the first episode of the podcast was published, not recorded.
+===Last episode published [final]===
+If the podcast has ended or is on hiatus, enter the last episode's publish date in <code>final</code>.
+===Website opened [site_open]===
+If necessary, this will display the date that the website opened. This may include dates when the podcast changed its name and URL. <small><b>[<i>mainsite add</i>]</b></small>
+===Website closed [site_close]===
+If necessary, this will display the date that the podcast's website was permanently taken offline, if the website is closed. If the website is closed, enter the website closing date in <code>site_close</code>. '''Note that this field is not affected by <code>mainsite</code>.'''
+===Reason [reason]===
+If necessary, this tells the reason why the podcast has ended. If there is a reason, enter it in <code>reason</code>.
+===Creator(s) [creator]===
+Tells the name(s) and/or alias(es) of who made the podcast and, if necessary, website.
+===Host(s) [host]===
+Shows the name(s) or alias(es) of the current main podcast host(s). Also, it's usually the creator of the show who is always the host, but it may change over time. If the show has had multiple hosts, it's best to state ''et al.'' after the main host's name and, if possible, link to a list of other hosts or co-hosts in another section of the article. If the podcast has a wide variety of hosts (such as ''Bulbacast''), enter "Various" instead.
+===Number of Episodes [noepisodes]===
+Displays the number of episodes that the podcast has published, obviously. If the podcast is still active or ongoing, or even if it's on hiatus, add an "as of" date.
+For example:<br>
+<code><nowiki>noepisodes=51 <small>(as of December 21, 2012)</small>|</nowiki></code>
+Will show in the infobox:<br>
+<small>(as of December 21, 2012)</small>
+===Forum [forum]===
+Provides a link to the podcast's or website's forums, if there are any. If there are forums for the podcast or its website, enter the forums' name as a weblink in <code>forum</code>.
+===Mascot [mascot]===
+If the podcast or its website has a mascot, enter the mascot's name in <code>mascot</code>. The mascot is pretty much going to be a Pokémon, so enter the name as a Pokémon shortlink. ''(See [[BP:LLT]] for more information on link templates.)''
+===Website [weblink]===
+Goes to podcast's website, whether or not it's that important. As the technical name of this field shows, this is usually displayed as a weblink.
+===Feed===
+This is ''the'' most important field of the podcast infobox. As the name shows, this provides the podcast's {{wp|RSS}} feed and other feed links. This is how people subscribe to podcasts. There are four parameters to the "Feed" field: RSS, {{wp|iTunes}}, {{wp|Zune}}, and Other.
+With this field in mind, please remember that '''Bulbapedia is ''not'' a podcast directory for all Pokémon-focused podcasts;''' only Pokémon podcasts that are notable based on either their contributions to or popularity within the fandom. Bulbapedia originally rejected the now-popular [[It's Super Effective (podcast)|''It's Super Effective'' podcast]] from having an article here back in 2010 because it was only a relatively new Pokémon podcast at the time. It was about three months old when someone tried to make an article about that podcast ''twice'' and it wasn't well-known or very popular back then. A year later, they have now become more popular than the late ''[[WTPT - Pokémon Radio]]'' and ''earned'' their article, although the article name was moved from [[It's Super Effective]] (which now redirects to a section in [[damage modification]]) to its current name, [[It's Super Effective (podcast)]].
+Simply put, if you've just started your podcast about a month ago, it's not going to be any worth mentioning here. If you've actually been holding your podcast for over a year now, but most fans haven't even ''heard'' of it or if it's considered just a typical, everyday, ho-hum, generic Pokémon podcast, then it's probably not going to appear here either.
+====RSS feed [rss]====
+All podcasts have an RSS feed. In <code>rss</code>, enter the most recent URL of the podcast's RSS feed, which usually ends in ".xml". (Feeds are stored and defined in {{wp|XML}} files.) It needs to be entered even if the podcast has ended and '''even if there are ''no'' content in the feed'''.
+The link is displayed as the RSS icon: [[File:Feed-icon.png|16px]]
+====iTunes Store [itunes]====
+Virtually every podcast that's ever made is available on the {{wp|iTunes Store}}, so a link to the popular online store and podcast directory is needed in the infobox as a ''{{wp|de facto}}'' inclusion. In <code>itunes</code>, enter the URL of the podcast's entry on iTunes. The URL should show "itunes.apple.com" or "phobos.apple.com" at the beginning after the "http://". Like the above, it needs to be entered regardless of its status or amount of content.
+The link is displayed as Apple's podcasting logo: [[File:ITunesPodcastIcon.png|16px]]
+====Zune Marketplace [zune]====
+Unlike the two above, this one is optional, as not all podcasts are available on the {{wp|Zune Marketplace}}. The Zune Marketplace, while nowhere near as popular as iTunes, is considered a major online store and podcast directory. If the podcast is available on the Zune Marketplace, and Zune is using its current feed, enter <code>yes</code> in <code>zune</code>.
+Previously, any Pokémon podcasts that were available on Zune required a link to "social.zune.net" using <code>zune_link</code> to prove its availability there. In October 2012, Microsoft has shut down Zune.net and any Zune podcast links here will redirect to the Zune service support site at Xbox.com. For that reason, we no longer have <code>zune_link</code> in the template code. We are currently not discontinuing the <code>zune</code> field of the template, but from now on, clicking on the Zune logo [[File:Zune_logo.png|16px]] in the infobox will go directly to the new Zune web page on Xbox.com. ('''Note:''' ''Bulbapedia is not affiliated with Microsoft in any way and does not either support or oppose their services.'') If you are able to find the podcast's current feed on Zune, you can still enter <code>zune=yes</code>; the Zune logo will appear with the new link, and the new tooltip text "<code>podcastname</code> can be found on the Zune Marketplace." will pop up when you hover your cursor over the logo.
+====Other feed links [otherfeeds]====
+Like Zune, this is also optional. If the podcast is available on other services (e.g. {{wp|BitTorrent}}, {{wp|YouTube}}, {{wp|Vimeo}}), or if it has "sister podcasts" (like ''[[KTPT - Pokémon Radio]]'', a sister podcast to ''[[WTPT]]''), then provide any other URLs in here. If there aren't any other feeds or links, then forget about adding this field.