{"id":24672067,"url":"https://github.com/nealrs/devpostcommit","last_synced_at":"2025-03-21T14:43:10.220Z","repository":{"id":36073061,"uuid":"40372639","full_name":"nealrs/devpostcommit","owner":"nealrs","description":"The Devpost Commit video podcast!","archived":false,"fork":false,"pushed_at":"2016-10-27T16:34:48.000Z","size":1284,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":5,"default_branch":"gh-pages","last_synced_at":"2025-01-26T10:12:34.243Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://commit.devpost.com","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nealrs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-08-07T17:33:04.000Z","updated_at":"2016-10-27T16:34:50.000Z","dependencies_parsed_at":"2022-09-03T11:01:28.844Z","dependency_job_id":null,"html_url":"https://github.com/nealrs/devpostcommit","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nealrs%2Fdevpostcommit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nealrs%2Fdevpostcommit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nealrs%2Fdevpostcommit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nealrs%2Fdevpostcommit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nealrs","download_url":"https://codeload.github.com/nealrs/devpostcommit/tar.gz/refs/heads/gh-pages","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244815971,"owners_count":20515023,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-01-26T10:12:48.693Z","updated_at":"2025-03-21T14:43:10.187Z","avatar_url":"https://github.com/nealrs.png","language":"HTML","readme":"# A Jekyll template for iTunes podcast feed\nAn easy way to add a podcast to your Jekyll-based blog and publish it on iTunes is to:\n\n1. Adjust `_config.yml` to add some podcast-specific static data.\n2. Mark all the posts that are related to podcast with a certain category (sa, `podcast`).\n3. Add podcast-specific attributes to each post that is related to podcast.\n\n## Prepare\n\n### Put static data to config\n\nYou can either hard-code podcast-specific data into layout file, or put this data into site config. I personally prefer the second approach since it's scalable and allows us use that data in other different ways.\n\nSo, to your `_config.yml` add several properties, like:\n\n```\n# Misc\nlicence: CC-BY-CA\n# Podcast\npodcast:\n  title: My Cool Podcast\n  art: http://link/to/cover/art.png\n  category: Education\n  subcategories:\n  - Training\n  subtitle: The subtitle that shows in \"Description\" column on desktop iTunes\n  summary: \u003e\n    A long long description of your podcast\n    that a listener can read in Podcast View.\n```\n\nIf you host a cover art image somewhere outside the current site, `podcast.art` would be useful; otherwise, it's unnecessary since the link can be obtained via `base_url` and `url` properties of site config.\n\n### Use a category to filter posts\n\nTo add a new item to the podcast feed, you simply create a new post in `_posts` folder and then in the top section, among layout (which can be any) and post date, you should specify a category, like\n\n```\ncategory: podcast\n```\n\nBut it's not enough. iTunes demands specific data to be present in the feed, like file size in bytes or duration in `hh:mm:ss` format. These properties must be added to post's config, too, so it basically looks like\n\n```\n---\nlayout: post\ntitle:  \"Hello, World\"\ndate:   2015-01-01 12:00:00\ncategories: podcast\nnumber: 1\nduration: 15:00\nlength: 1065610\nmp3: http://link/to/mp3\n---\n```\n\nFew points to pay attention to:\n\n* `number` isn't necessary and is used just for subscribers' convenience.\n* `mp3` links to the `audio/mpeg` file which contains the episode of podcast, and in this example is considered to be hosted elsewhere outside current site.\n* `title` and `date` are conventional to Jekyll and are used by feed layout template, too.\n* `duration` and `length` are what you should calculate by hand (via file attributes).\n\nAfter post's config session goes post's content which is used in the feed generation process, too.\n\n## Create a page for the feed\n\nSince each page in Jekyll is actually a post or a page that is processed using template, the former is needed. So what you should do is basically create a `feed.md` file in root of site's folder and make it be transformed using iTunes feed template. Also, provide the permalink:\n\n```\n---\nlayout: itunes-feed-layout\npermalink: /podcast/feed/\n---\n```\n\nMake sure you put a trailing slash at the end of permalink. Without that, Jekyll will throw an error each time you want to generate the site.\n\n## Put template into layouts folder\n\nNext step is to put the template into `_layouts` folder. Just copy and paste.\n\n## Adjust layout to meet your needs\n\nFinally, make sure the layout, which soon will generate RSS feed for iTunes, uses existing properties from site config and post attributes. You may want to change the language of podcast\n(which is hardcoded `en-us`),\nchange category name in item enumeration, or mark your podcast as safe for all ages.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnealrs%2Fdevpostcommit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnealrs%2Fdevpostcommit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnealrs%2Fdevpostcommit/lists"}