Add RSS support for Blog entries

[msurdi]

🔗 Linked issue

❓ Type of change

• 🐞 Bug fix (a non-breaking change that fixes an issue)
• 👌 Enhancement (improving an existing functionality like performance)
• ✨ New feature (a non-breaking change that adds functionality)
• ⚠️ Breaking change (fix or feature that would cause existing functionality to change)

📚 Description

I wanted to subscribe to your blog using an RSS feed reader and noticed there was no feed for the blog. Here's a quick implementation for adding it.

📝 Checklist

• I have linked an issue or discussion.
• I have updated the documentation accordingly.

[Julien-R44]

Cool thing to have! Thanks for the PR

Looks good to me. @thetutlage any thoughts ?

[RomainLanz]

Hey @msurdi! 👋🏻

Thanks for this PR.

Since we are dumping the whole article content, the file will probably grow big.

Wouldn't it be better only to display the title and a summary?

[msurdi]

Hi @RomainLanz! Thanks a lot for taking some time to review this.

I think it's nice to have the full article, so that you can read the posts without leaving your news reader. But I agree the size of this can get quickly out of hand.

I've just pushed a commit where I instead limited the number of posts to the latest 20 available. Would that work?

I'm happy to truncate the content if you still think it's necessary and there's no way around that.

Thanks!

[thetutlage]

I think its fine to have all the contents for now, since we don't have many posts. Later we can see if we want to something different once we start to hit any sort of limits

[thetutlage]

We will also have to update the build:static command and write the blog.xml file on the disk, since the production site is a static output. https://github.com/adonisjs/adonisjs.com/blob/main/commands/build_static.ts

[RomainLanz]

I think its fine to have all the contents for now, since we don't have many posts.

Agreed.

One question though: do most RSS readers support JavaScript? Since we might have custom components in those articles, they could potentially break in RSS readers if JavaScript isn’t handled.

[thetutlage]

To be honest, I have not used any RSS readers recently. So yeah, we should give a test run once and see what the ideal experience will be

[msurdi]

@thetutlage I've just added the static generation step for the feed.

Let me know if there is anything else I can do here.

Thanks 🙏

[msurdi]

All suggested changes applied.

[RomainLanz]

LGTM

[RomainLanz]

Thanks!

[RomainLanz]

It looks like the generated feed has some issues: https://www.rssboard.org/rss-validator/check.cgi?url=https%3A%2F%2Fadonisjs.com%2F

Can you have a look at it? @msurdi

[msurdi]

Sure, I’ll check this over the weekend.

[msurdi]

@RomainLanz just opened #28 to address these issues.