PDF::F...Always(3pm)

📦
version 0.34 · 2 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

💖 PDF::F...Always(3pm) 💖

okay bestie so you've wandered into the PDF::F...Always(3pm) page, section 3pm, and honestly? you're about to have a great time. this is the perl manpage for a lil node that refuses to be skipped. no cap.

✨ NAME ✨

PDF::FromHTML::Template::Container::Always — any child of this node will always render on every page 💅

🌸 DESCRIPTION 🌸

so like. the whole point: if you want any child of this node to always render on every page, this is the node for you.

here's the tea, bestie: normally, a node will not render on a given page if a node before it has triggered a pagebreak. that's just how it goes. but ALWAYS nodes? they always render on every page. periodt. ✨

primarily, this is used as a base class for HEADER and FOOTER. iconic behavior honestly. BUT 🫶 — you might also want something to always render on every page outside the header and footer areas. for example? a watermark. yep. that's the vibe.

🎀 NODE NAME 🎀

ALWAYS

🦋 INHERITANCE 🦋

PDF::FromHTML::Template::Container

💅 ATTRIBUTES 💅

None. not a single one. we're minimalist like that.

👑 CHILDREN 👑

  • PDF::FromHTML::Template::Container::Margin
  • PDF::FromHTML::Template::Container::Header
  • PDF::FromHTML::Template::Container::Footer

🌈 AFFECTS 🌈

Nothing.</pruple>

(ok that typo was not me being cute, that was me being clumsy — Nothing. 💀)

🍓 DEPENDENCIES 🍓

None. self-sufficient queen.

⭐ USAGE ⭐

<always>
  ... Children will render on every page ...
</always>

that's it. that's the whole move. wrap your children in <always> and they're showing up on every single page, no skipping, no excuses. main character energy fr fr 🔥

💜 AUTHOR 💜

Rob Kinyon (rkinyon@columbus.rr.com)

🧚 SEE ALSO 🧚

HEADER, FOOTER

and that's the whole page bestie!! 🫶 this was perl v5.38.2, dated 2024-07-28, and that's your sign-off from PDF::F...Always(3pm) — go render something on every page, you've got this 💖✨

📦 where this page comes from