PFT-LS(1)

💅 pft-ls — the manual, but make it cute

okay bestie, so this is PFT-LS(1) from the User Contributed Perl Documentation collection, and honestly? it's giving "let me just see what's in here" energy. iconic. let's go. 🎀

---

✨ NAME ✨

pft ls — list objects in your PFT site 🦋

---

✨ SYNOPSIS ✨

pft ls class [options]

---

✨ DESCRIPTION ✨

so basically: list objects. that's the whole vibe. 🫶

the general usage is that you hand it a class of objects to list. like, for instance:

pft ls tags

and that will list all the tags from all pages and entries. slay. ✨

---

✨ CLASSES ✨

there are many classes supported, and here's the short-and-sweet rundown of each. for better details (fr fr, the full lore) go check out pft(1). 💖

• pages — lists all regular pages in ROOT/content/pages. this class supports the --pretty argument. 👑
• blog — lists all blog pages in ROOT/content/blog. this includes daily entries and monthly entries. 💀 both. all of them. this class supports the --pretty argument. 👑
• tags — scans through all entries and lists all used tags. 🏷️
• tagpages — lists all tag pages, aka the pages that describe tags. this class supports the --pretty argument. 👑

---

✨ OPTIONS ✨

• --help | -h — show this help. simple as. 🙈
• --locate — shows paths and titles, which is just a quick lil alias for:

--pretty='%t:%p'

convenient? yes. obsessed? also yes. ✨

• --pretty=fmt — prints properties of the listed nodes according to the format you specify. the format supports a custom percent notation, similar in spirit to printf(2). 🧚

⚠️ heads up bestie: some placeholders get expanded with empty strings when the corresponding object property is void. for example, pages don't have a date. if that's the case, the placeholder just gets expanded with an empty string. no drama, just blank. 💀

the output is encoding depending on the locale. 🌈

• %t — Title
• %p — Path (might be void if the node is virtual)
• %g — Comma separated list of tags (possibly void)
• %a — Author (possibly void)
• %s — Slug (or name, if the node is virtual)
• %D — Date in yyyy-mm-dd format (possibly void)
• %y — Year (possibly void)
• %m — Month (possibly void)
• %d — Day (possibly void)
• %o — Comma separated value of option=value pairs (possibly void)

---

✨ SEE ALSO ✨

• pft(1) — go read it, iykyk 💜

---

and that's the whole page!! this one's from perl v5.42.0, dated 2025-07-25, and it's PFT-LS(1) forever and ever. stay hydrated, go list some objects, and remember: you're the main character of your own filesystem. periodt. 💅🌸🦋