arxiv-to-rss

Create an RSS feed from a custom arXiv query and push to GitHub Pages.

With the queries.yaml file as below, the files feeds/feed.xml and feeds/author.xml will be created.

Markdown versions of the paper summaries will also be parsed and pushed to the pages feeds/feed.html and feeds/author.html.

feed:
  max_results: 64
  query: '(abs:JWST OR abs:James Webb) AND (cat:astro-ph.GA OR cat:astro-ph.CO)'

author:
  max_results: 64
  query: '(abs:JWST OR abs:James Webb) AND (cat:astro-ph.GA OR cat:astro-ph.CO) AND (au:Brammer)'
  1. Edit queries.yaml to set the queries you want. See the API documentation for more information on constructing queries. Note that () will be changed to HTML characters and spaces to + in the query strings before sending them to the API.
  2. Run python queries_to_feeds.py once locally and commit the xml and md files it generates in the ./feeds/ subdirectory to the repo.
  3. Enable Read and write permissions in Settings > Actions > General for the repository.
  4. Turn on Settings > Pages to deploy to GitHub Pages from the main branch.
  5. The feeds will be updated every weekday at 05:00 UT using the GitHub Action.