From 867e0b7dc6e8927a6d3fcf5cf21f36310cf13112 Mon Sep 17 00:00:00 2001 From: Dwev <46626050+Dwev@users.noreply.github.com> Date: Mon, 15 Apr 2024 13:58:49 +0200 Subject: [PATCH] Update brand/logo info, depreciate itunes namespace owner tag --- README.md | 8 ++- contributors.txt | 1 + images/pc20badgered.svg | 155 ++++++++++++++++++++++++++++++++++++++++ itunes_reference.md | 3 +- 4 files changed, 163 insertions(+), 4 deletions(-) create mode 100644 images/pc20badgered.svg diff --git a/README.md b/README.md index d075311..4dd5182 100644 --- a/README.md +++ b/README.md @@ -233,6 +233,10 @@ section [here](https://github.com/Podcastindex-org/podcast-namespace/labels/prop

-## Badges and Media +## Branding -![Podcast Namespace](images/podcastindex-namespace-final.svg) +[Podcasting2.org](https://podcasting2.org) + +[Podcasting 2.0 Brand Guide](https://live.standards.site/podcasting20/) + +Podcasting 2.0 Badge (red) diff --git a/contributors.txt b/contributors.txt index 9fd3cd0..984c350 100644 --- a/contributors.txt +++ b/contributors.txt @@ -35,4 +35,5 @@ Steven Bell CTHTC @kenCode @Agorise +@Dwev ... add your name as you contribute! diff --git a/images/pc20badgered.svg b/images/pc20badgered.svg new file mode 100644 index 0000000..877daa5 --- /dev/null +++ b/images/pc20badgered.svg @@ -0,0 +1,155 @@ + + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/itunes_reference.md b/itunes_reference.md index f74289d..1a14fab 100644 --- a/itunes_reference.md +++ b/itunes_reference.md @@ -9,7 +9,6 @@ Official: [iTunes Namespace Reference](https://help.apple.com/itc/podcasts_conn - `` - `` - `` -- `` - `` - `` - `` @@ -58,7 +57,7 @@ In the table below, Required tags must be present in your RSS feed or it won’t Podcasts. Recommended tags aren’t required but are highly encouraged because they provide useful information to users. Situational tags are important in certain circumstances. -

Show tags

Usage

Parent tag

Required tags

<title>

The show title.

It’s important to have a clear, concise name for your podcast. Make your title specific. A show titled Our Community Bulletin is too vague to attract many subscribers, no matter how compelling the content.

Pay close attention to the title as Apple Podcasts uses this field for search.

If you include a long list of keywords in an attempt to game podcast search, your show may be removed from the Apple directory.

<channel>

<description>

The show description.

Where description is text containing one or more sentences describing your podcast to potential listeners. The maximum amount of text allowed for this tag is 4000 bytes.

To include links in your description or rich HTML, adhere to the following technical guidelines: enclose all portions of your XML that contain embedded HTML in a CDATA section to prevent formatting issues, and to ensure proper link functionality. For example:

<![CDATA[ <a href="http://www.apple.com">Apple</a> ]]>

<channel>

<itunes:image>

The artwork for the show.

Specify your show artwork by providing a URL linking to it.

Depending on their device, subscribers see your podcast artwork in varying sizes. Therefore, make sure your design is effective at both its original size and at thumbnail size. You should include a show title, brand, or source name as part of your podcast artwork. Here are additional marketing best practices. For examples of podcast artwork, see the Top Podcasts chart. To avoid technical issues when you update your podcast artwork, be sure to:

  • Change the artwork file name and URL at the same time

  • Verify the web server hosting your artwork allows HTTP head requests

Artwork must be a minimum size of 1400 x 1400 pixels and a maximum size of 3000 x 3000 pixels, in JPEG or PNG format, 72 dpi, with appropriate file extensions (.jpg, .png), and in the RGB colorspace. These requirements are different from the standard RSS image tag specifications.

Make sure the file type in the URL matches the actual file type of the image file.

<channel>

<language>

The language spoken on the show.

Because Apple Podcasts is available in territories around the world, it is critical to specify the language of a podcast. Apple Podcasts only supports values from the ISO 639 list (two-letter language codes, with some possible modifiers, such as "en-us").

Invalid language codes will cause your feed to fail Apple validation.

<channel>

<itunes:category>

The show category information. For a complete list of categories and subcategories, see Apple Podcast categories.

Select the category that best reflects the content of your show. If available, you can also define a subcategory.

Although you can specify more than one category and subcategory in your RSS feed, Apple Podcasts only recognizes the first category and subcategory.

When specifying categories and subcategories, be sure to properly escape ampersands. For example:

Single category:

<itunes:category text="History" />

Category with ampersand:

<itunes:category text="Kids &amp; Family" />

Category with subcategory:

<itunes:category text="Society &amp; Culture"> <itunes:category text="Documentary" /> </itunes:category>

Multiple categories:

<itunes:category text="Society &amp; Culture"> <itunes:category text="Documentary" /> </itunes:category> <itunes:category text="Health"> <itunes:category text="Mental Health" /> </itunes:category>

<channel>

<itunes:explicit>

The podcast parental advisory information.

The explicit value can be one of the following:

  • True. If you specify true, indicating the presence of explicit content, Apple Podcasts displays an Explicit parental advisory graphic for your podcast.

    Podcasts containing explicit material aren’t available in some Apple Podcasts territories.

  • False. If you specify false, indicating that your podcast doesn’t contain explicit language or adult content, Apple Podcasts displays a Clean parental advisory graphic for your podcast.

<channel>

Recommended tags

<itunes:author>

The group responsible for creating the show.

Show author most often refers to the parent company or network of a podcast, but it can also be used to identify the host(s) if none exists.

Author information is especially useful if a company or organization publishes multiple podcasts.

<channel>

<link>

The website associated with a podcast.

Typically a home page for a podcast or a dedicated portion of a larger website. For example:

<link> http://www.mypodcast.com</link>

or

<link> http://www.mediacompany.com/podcast</link>

<channel>

<itunes:owner>

The podcast owner contact information.

Include the email address of the owner in a nested <itunes:email> tag and the name of the owner in a nested <itunes:name> tag.

Note: The <itunes:owner> tag information is for administrative communication about the podcast and isn’t displayed in Apple Podcasts. Please make sure the email address is active and monitored.

<channel>

Situational tags

<itunes:title>

The show title specific for Apple Podcasts.

<itunes:title> is a string containing a clear concise name of your show on Apple Podcasts.

<channel>

<itunes:type>

The type of show.

If your show is Serial you must use this tag.

Its values can be one of the following:

  • Episodic (default). Specify episodic when episodes are intended to be consumed without any specific order. Apple Podcasts will present newest episodes first and display the publish date (required) of each episode. If organized into seasons, the newest season will be presented first - otherwise, episodes will be grouped by year published, newest first.

    For new subscribers, Apple Podcasts adds the newest, most recent episode in their Library.

  • Serial. Specify serial when episodes are intended to be consumed in sequential order. Apple Podcasts will present the oldest episodes first and display the episode numbers (required) of each episode. If organized into seasons, the newest season will be presented first and <itunes:episode> numbers must be given for each episode.

    For new subscribers, Apple Podcasts adds the first episode to their Library, or the entire current season if using seasons.

<channel>

<copyright>

The show copyright details.

If your show is copyrighted you should use this tag. For example:

<copyright>Copyright 1995-2019 John John Appleseed</copyright>

<channel>

<itunes:new-feed-url>

The new podcast RSS Feed URL.

If you change the URL of your podcast feed, you should use this tag in your new feed.

Use the <itunes:new-feed-url> tag to manually change the URL where your podcast is located.

<itunes:new-feed-url> https://newlocation.com/example.rss</itunes:new-feed-url>

You should maintain your old feed until you have migrated your existing subscribers. Learn how to update your podcast RSS feed URL.

Note: The <itunes:new-feed-url> tag reports new feed URLs to Apple Podcasts and isn’t displayed in Apple Podcasts.

<channel>

<itunes:block>

The podcast show or hide status.

If you want your show removed from the Apple directory, use this tag.

Specifying the <itunes:block> tag with a Yes value, prevents the entire podcast from appearing in Apple Podcasts.

Specifying any value other than Yes has no effect.

<channel>

<itunes:complete>

The podcast update status.

If you will never publish another episode to your show, use this tag.

Specifying the <itunes:complete> tag with a Yes value indicates that a podcast is complete and you will not post any more episodes in the future.

Specifying any value other than Yes has no effect.

<channel>

+

Show tags

Usage

Parent tag

Required tags

<title>

The show title.

It’s important to have a clear, concise name for your podcast. Make your title specific. A show titled Our Community Bulletin is too vague to attract many subscribers, no matter how compelling the content.

Pay close attention to the title as Apple Podcasts uses this field for search.

If you include a long list of keywords in an attempt to game podcast search, your show may be removed from the Apple directory.

<channel>

<description>

The show description.

Where description is text containing one or more sentences describing your podcast to potential listeners. The maximum amount of text allowed for this tag is 4000 bytes.

To include links in your description or rich HTML, adhere to the following technical guidelines: enclose all portions of your XML that contain embedded HTML in a CDATA section to prevent formatting issues, and to ensure proper link functionality. For example:

<![CDATA[ <a href="http://www.apple.com">Apple</a> ]]>

<channel>

<itunes:image>

The artwork for the show.

Specify your show artwork by providing a URL linking to it.

Depending on their device, subscribers see your podcast artwork in varying sizes. Therefore, make sure your design is effective at both its original size and at thumbnail size. You should include a show title, brand, or source name as part of your podcast artwork. Here are additional marketing best practices. For examples of podcast artwork, see the Top Podcasts chart. To avoid technical issues when you update your podcast artwork, be sure to:

  • Change the artwork file name and URL at the same time

  • Verify the web server hosting your artwork allows HTTP head requests

Artwork must be a minimum size of 1400 x 1400 pixels and a maximum size of 3000 x 3000 pixels, in JPEG or PNG format, 72 dpi, with appropriate file extensions (.jpg, .png), and in the RGB colorspace. These requirements are different from the standard RSS image tag specifications.

Make sure the file type in the URL matches the actual file type of the image file.

<channel>

<language>

The language spoken on the show.

Because Apple Podcasts is available in territories around the world, it is critical to specify the language of a podcast. Apple Podcasts only supports values from the ISO 639 list (two-letter language codes, with some possible modifiers, such as "en-us").

Invalid language codes will cause your feed to fail Apple validation.

<channel>

<itunes:category>

The show category information. For a complete list of categories and subcategories, see Apple Podcast categories.

Select the category that best reflects the content of your show. If available, you can also define a subcategory.

Although you can specify more than one category and subcategory in your RSS feed, Apple Podcasts only recognizes the first category and subcategory.

When specifying categories and subcategories, be sure to properly escape ampersands. For example:

Single category:

<itunes:category text="History" />

Category with ampersand:

<itunes:category text="Kids &amp; Family" />

Category with subcategory:

<itunes:category text="Society &amp; Culture"> <itunes:category text="Documentary" /> </itunes:category>

Multiple categories:

<itunes:category text="Society &amp; Culture"> <itunes:category text="Documentary" /> </itunes:category> <itunes:category text="Health"> <itunes:category text="Mental Health" /> </itunes:category>

<channel>

<itunes:explicit>

The podcast parental advisory information.

The explicit value can be one of the following:

  • True. If you specify true, indicating the presence of explicit content, Apple Podcasts displays an Explicit parental advisory graphic for your podcast.

    Podcasts containing explicit material aren’t available in some Apple Podcasts territories.

  • False. If you specify false, indicating that your podcast doesn’t contain explicit language or adult content, Apple Podcasts displays a Clean parental advisory graphic for your podcast.

<channel>

Recommended tags

<itunes:author>

The group responsible for creating the show.

Show author most often refers to the parent company or network of a podcast, but it can also be used to identify the host(s) if none exists.

Author information is especially useful if a company or organization publishes multiple podcasts.

<channel>

<link>

The website associated with a podcast.

Typically a home page for a podcast or a dedicated portion of a larger website. For example:

<link> http://www.mypodcast.com</link>

or

<link> http://www.mediacompany.com/podcast</link>

<channel>

Situational tags

<itunes:title>

The show title specific for Apple Podcasts.

<itunes:title> is a string containing a clear concise name of your show on Apple Podcasts.

<channel>

<itunes:type>

The type of show.

If your show is Serial you must use this tag.

Its values can be one of the following:

  • Episodic (default). Specify episodic when episodes are intended to be consumed without any specific order. Apple Podcasts will present newest episodes first and display the publish date (required) of each episode. If organized into seasons, the newest season will be presented first - otherwise, episodes will be grouped by year published, newest first.

    For new subscribers, Apple Podcasts adds the newest, most recent episode in their Library.

  • Serial. Specify serial when episodes are intended to be consumed in sequential order. Apple Podcasts will present the oldest episodes first and display the episode numbers (required) of each episode. If organized into seasons, the newest season will be presented first and <itunes:episode> numbers must be given for each episode.

    For new subscribers, Apple Podcasts adds the first episode to their Library, or the entire current season if using seasons.

<channel>

<copyright>

The show copyright details.

If your show is copyrighted you should use this tag. For example:

<copyright>Copyright 1995-2019 John John Appleseed</copyright>

<channel>

<itunes:new-feed-url>

The new podcast RSS Feed URL.

If you change the URL of your podcast feed, you should use this tag in your new feed.

Use the <itunes:new-feed-url> tag to manually change the URL where your podcast is located.

<itunes:new-feed-url> https://newlocation.com/example.rss</itunes:new-feed-url>

You should maintain your old feed until you have migrated your existing subscribers. Learn how to update your podcast RSS feed URL.

Note: The <itunes:new-feed-url> tag reports new feed URLs to Apple Podcasts and isn’t displayed in Apple Podcasts.

<channel>

<itunes:block>

The podcast show or hide status.

If you want your show removed from the Apple directory, use this tag.

Specifying the <itunes:block> tag with a Yes value, prevents the entire podcast from appearing in Apple Podcasts.

Specifying any value other than Yes has no effect.

<channel>

<itunes:complete>

The podcast update status.

If you will never publish another episode to your show, use this tag.

Specifying the <itunes:complete> tag with a Yes value indicates that a podcast is complete and you will not post any more episodes in the future.

Specifying any value other than Yes has no effect.

<channel>

The figure below depicts a “Show view” from the Apple Podcasts app and labels how tags map to episode information. It’s important to note that the `` show tag listed above affects how episodes are displayed.