PFT-GEN-RSS(1)

📦
version 1.4.1 · 2 versions
, in fedora 43

💖 PFT-GEN-RSS(1) 💖

okay bestie, so this is one of the pages from the User Contributed Perl Documentation collection, and it's literally all about pft gen-rss — the lil command that makes your website a feed. no cap, it's giving very "set it and forget it" energy ✨

🌸 NAME 🌸

pft gen-rss — Generate a Feed RSS for the website 🦋

✨ SYNOPSIS ✨

pft gen-rss

that's it. that's the whole vibe. one command, zero drama 💅

🎀 DESCRIPTION 🎀

so this command straight up generates an XML file that follows the RSS (Really Simple Syndacation) specification. yes, we're being fancy and standards-compliant, as we should 💖

the default behaviour — the out-of-the-box main character energy — is that the generated file lands in the root of the build directory, and it's named feed.rss. cute, right? 🍓

and inside that feed? you get one item element for each of the last 10 blog entries. ten. that's the magic number, don't ask me why, it's just the default 👑

the global PFT configuration is where you can switch things up, though — it lets you change the default path of the file and the number of listed blog entries (go peek at pft-init(1) for that) 🌈

💅 OPTIONS 💅

  • --help — Show this guide 🫶 (yes bestie, it shows you this very page, how meta of it)

⭐ EXIT STATUS ⭐

like any self-respecting command, it tells you how it's feeling on the way out:

  1. 1 in case of option parsing failure 😭
  2. 2 if it was impossible to construct the filesystem tree 💀
  3. 3 in case of corrupt configuration 🙈

🧚 BUGS 🧚

okay so this is the part where we keep it real, because there's some stuff you should know:

  • in PFT, blog entries are timestamped with a day resolution. there's no obvious way to timestamp the publishing date (pubDate) of blog entries with a better time resolution, so the hour is rounded up to midnight. yeah. midnight. every time. it is what it is 😭
  • the generated RSS feed will use the publishing date of the most recent entry as lastBuildDate. this makes the implementation simple — and honestly, we love simple — but it yields inaccurate results should the user update an old blog entry. so like, if you go back and edit a post from three years ago, the feed won't clock it. noted 📝

🔥 SEE ALSO 🔥

and that's the whole page, bestie 💜 this one came to you courtesy of perl v5.42.0, dated 2025-07-25, and it's filed under PFT-GEN-RSS(1). go generate that feed, you icon 👑✨

📦 where this page comes from