PRIORITY! SPHINX book: Create rss feed of pyOS tutorials

[lwasser]

GOAL: We have a list of tutorials published in the pyopensci package guide which is a sphinx book. We would also like to cross post tutorials on our website in the learn section. .

Right now to create this list on that page, i'm. manually adding stub md pages here.

Ideally we could parse a list of tutorials from either a RSS feed or the package guide sitemap.

The problem with using the sitemap is that there is no description of the file or title just a url. so that is why i think we'd want to create a custom sphinx feed for tutorials that the website could ingest.

I posted on fosstodon about generating RSS feeds of content - Hugo responded with the example from their PEP work

I don't know of such a tool, but it's not too complex: generate some static XML of the last X things and stick it online.

The main bit of code to generate https://peps.python.org/peps.rss is at https://github.com/python/peps/blob/main/pep_sphinx_extensions/generate_rss.py

It's now hooked up to the Sphinx build, previously it was a standalone script called during the build.
https://github.com/python/peps/pull/32

I think we can take this example and create a feed of tutorials that then we can read into the website to generate cards for each tutorial and critical packaging sections in our learn section (when we create that section).

[lwasser]

This is a high priority issue. I need to be able to cross-post content from our Sphinx books on our website to make it easier for people to discover. If we had a feed of tutorials and content, I could then generate stubs automatically on our website. We'd ideally want:

title, description and link to the content in the feed but maybe more! If we need to add yaml metadata with authors and keywords, we could do that too.

[sneakers-the-rat]

got it #488

[lwasser]

Oh wow!! thank you. I've wanted this for a long time. i'll check out the PR soon!! It's really hard to add things and keep it up to date manually.