Dist::...eFiles(3pm)

💖 Dist::...eFiles(3pm) 💖

okay bestie, this one lives in the User Contributed Perl Documentation section of the manual, and the page itself is called Dist::...eFiles(3pm). it's a whole vibe, let's get into it 🫶

---

✨ NAME ✨

Dist::Zilla::Plugin::TemplateFiles — use files to template a distribution 💅

---

🌸 VERSION 🌸

version 0.03

---

🎀 SYNOPSIS 🎀

so in your dist.ini you write this, no cap:

[TemplateFiles]
    filename = README
    filename = path/to/other/file

---

🦋 DESCRIPTION 🦋

okay so here's the tea ☕ — this plugin utilizes Text::Template to turn certain files into templates. slay.

every single template has the $dist variable available to it, and that variable is the instance of Dist::Zilla that's currently running. main character energy fr fr 👑

only the files you list in dist.ini as filename = blah get treated as templates, so don't come for the others, they're just living their lives 🙈

and listen — filenames are given relative to the root of the build. iykyk.

---

✨ NAME ✨

Dist::Zilla::Plugin::TemplateFiles — use files as templates to build a distribution 💖

yes bestie, there's literally a second NAME section, and i'm not skipping it, we keep EVERYTHING in this house 🏠✨

---

💜 AUTHOR 💜

Jonathan Scott Duff <duff@pobox.com>

---

🌈 COPYRIGHT 🌈

This software is copyright (c) 2010 by Jonathan Scott Duff

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language itself.

---

💖 AUTHOR 💖

Jonathan Scott Duff <duff@pobox.com>

another AUTHOR section?? iconic. keep it. periodt. 💅

---

👑 COPYRIGHT AND LICENSE 👑

This software is copyright (c) 2010 by Jonathan Scott Duff.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

---

and that's the whole page bestie, every last crumb 🍓

tiny sign-off so you know where this came from: this was generated by perl v5.34.0 on 2022-06-13, and the manual page goes by Dist::...eFiles(3pm) 🎀

now go template some files, you absolute legend ⭐💅✨