{"id":31282315,"url":"https://github.com/matt-goldman/blakeplugin.rss","last_synced_at":"2026-01-20T17:03:33.099Z","repository":{"id":310411758,"uuid":"1039703905","full_name":"matt-goldman/BlakePlugin.RSS","owner":"matt-goldman","description":"An RSS feed generator for Blake sites","archived":false,"fork":false,"pushed_at":"2025-09-01T23:14:10.000Z","size":131,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-01T23:42:41.780Z","etag":null,"topics":["blake","blazor","rss","ssg","static-site-generator"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matt-goldman.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-17T20:02:57.000Z","updated_at":"2025-09-01T23:14:00.000Z","dependencies_parsed_at":"2025-08-18T00:19:38.866Z","dependency_job_id":"6b43f5fb-316a-4b9f-89dc-731975dd0287","html_url":"https://github.com/matt-goldman/BlakePlugin.RSS","commit_stats":null,"previous_names":["matt-goldman/blakeplugin.rss"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/matt-goldman/BlakePlugin.RSS","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matt-goldman%2FBlakePlugin.RSS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matt-goldman%2FBlakePlugin.RSS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matt-goldman%2FBlakePlugin.RSS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matt-goldman%2FBlakePlugin.RSS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matt-goldman","download_url":"https://codeload.github.com/matt-goldman/BlakePlugin.RSS/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matt-goldman%2FBlakePlugin.RSS/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276689011,"owners_count":25686611,"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","status":"online","status_checked_at":"2025-09-24T02:00:09.776Z","response_time":97,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["blake","blazor","rss","ssg","static-site-generator"],"created_at":"2025-09-24T03:54:40.188Z","updated_at":"2025-09-24T03:54:42.402Z","avatar_url":"https://github.com/matt-goldman.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Blake RSS Feed Plugin\n\nA zero-configuration RSS feed generator plugin for [Blake](https://github.com/matt-goldman/blake) static sites.\n\n## What it does\n\nThis plugin automatically generates an RSS feed for your Blake static site. Simply add a template file, and the plugin will create a complete RSS feed (`feed.xml`) with all your posts, properly formatted with absolute URLs, valid dates, and metadata.\n\nPerfect for blogs, news sites, or any content site where you want readers to subscribe to updates via RSS.\n\n## Installation\n\n1. **Install the NuGet package** in your Blake site project:\n   ```bash\n   dotnet add package BlakePlugin.RSS\n   ```\n\n2. **Create a feed template** at `wwwroot/feed.template.xml`:\n   ```xml\n   \u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n   \u003crss version=\"2.0\" xmlns:content=\"http://purl.org/rss/1.0/modules/content/\"\u003e\n     \u003cchannel\u003e\n       \u003ctitle\u003e{{Title}}\u003c/title\u003e\n       \u003clink\u003e{{Link}}\u003c/link\u003e\n       \u003cdescription\u003e{{Description}}\u003c/description\u003e\n       \u003clastBuildDate\u003e{{LastBuildDate}}\u003c/lastBuildDate\u003e\n\n       \u003cItems\u003e\n         \u003citem\u003e\n           \u003ctitle\u003e{{Item.Title}}\u003c/title\u003e\n           \u003clink\u003e{{Item.Link}}\u003c/link\u003e\n           \u003cguid isPermaLink=\"true\"\u003e{{Item.Guid}}\u003c/guid\u003e\n           \u003cpubDate\u003e{{Item.PubDate}}\u003c/pubDate\u003e\n           \u003cdescription\u003e\u003c![CDATA[{{Item.Description}}]]\u003e\u003c/description\u003e\n           {{Item.CategoriesXml}}\n         \u003c/item\u003e\n       \u003c/Items\u003e\n     \u003c/channel\u003e\n   \u003c/rss\u003e\n   ```\n\n3. **Exclude template from serving** (add to your `.csproj`):\n   ```xml\n   \u003cItemGroup\u003e\n     \u003cContent Remove=\"wwwroot\\feed.template.xml\" /\u003e\n   \u003c/ItemGroup\u003e\n   ```\n\n4. **Build your site**:\n   ```bash\n   blake bake --rss:Link=https://yoursite.com\n   ```\n   \n5. (Optional) Supply any additional metadata via command line options, such as:\n   ```bash\n   blake bake --rss:Title=\"My Blog\" --rss:Description=\"Latest posts about tech\"\n   ```\n\nThat's it! Your RSS feed will be generated at `wwwroot/feed.xml`.\n\n## Configuration\n\n### Basic placeholders\n\nThe template supports these placeholders that are automatically filled:\n\n**Feed level:**\n- `{{Title}}` - Your site title\n- `{{Link}}` - Your site URL (provide with `--rss:Link`)\n- `{{Description}}` - Your site description\n- `{{LastBuildDate}}` - Build timestamp (auto-generated)\n\n**Post level:**\n- `{{Item.Title}}` - Post title\n- `{{Item.Link}}` - Post URL (absolute)\n- `{{Item.Description}}` - Post description/excerpt\n- `{{Item.PubDate}}` - Post publication date\n- `{{Item.CategoriesXml}}` - Post tags as RSS categories\n\n### CLI options\n\nYou can set any placeholder value via command line:\n\n```bash\nblake bake --rss:Title=\"My Awesome Blog\" --rss:Description=\"Latest posts about web development\"\n```\n\nFor custom metadata, use any placeholder name:\n```bash\nblake bake --rss:author=\"Jane Doe\" --rss:language=\"en-us\"\n```\n\n**Content filtering and limiting:**\n\nControl which pages are included in your RSS feed:\n\n```bash\n# Ignore specific paths (no leading slash needed)\nblake bake --rss:ignore-paths=\"pages,drafts\"\n\n# Include only specific paths  \nblake bake --rss:include-paths=\"blog,news\"\n\n# Limit number of items (default: 20)\nblake bake --rss:max-items=10\n```\n\n**Path handling:**\n- Leading slashes are automatically handled - specify `pages` instead of `/pages`\n- Trailing slashes are honored - `page/` won't match `/pages/`  \n- Multiple paths can be separated by commas or semicolons\n- `ignore-paths` takes precedence if both include and ignore patterns match\n- Items are automatically sorted by publication date (newest first)\n\n**Backward compatibility:**\n- `--rss:ignore-path` (singular) still works for single path exclusions\n\n## Blake Resources\n\n- **Blake Repository**: [https://github.com/matt-goldman/blake](https://github.com/matt-goldman/blake)\n- **Blake Documentation**: [https://blake-ssg.org](https://blake-ssg.org)\n- **Blake Getting Started**: [https://blake-ssg.org/docs/getting-started](https://blake-ssg.org/docs/getting-started)\n\n## Roadmap\n\nPost-MVP features under consideration:\n- Support for RSS extensions (iTunes podcasting, media RSS)\n- ~~Custom feed item limits and filtering~~ ✅ **Implemented**\n- Multiple feed generation (e.g., category-specific feeds)\n- RSS 2.0 extensions for enhanced metadata\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatt-goldman%2Fblakeplugin.rss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatt-goldman%2Fblakeplugin.rss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatt-goldman%2Fblakeplugin.rss/lists"}