HTML2PDF(1p)

💖 HTML2PDF(1p) — the glow-up edition 💖

okay bestie, welcome to html2pdf, a page from the User Contributed Perl Documentation (section 1p, if you're keeping track). it's giving "turn your HTML into a PDF and feel iconic while doing it." let's get into it 🦋

---

✨ NAME ✨

html2pdf — convert HTML to PDF. that's it, that's the whole job, and she does it flawlessly. 💅

---

✨ SYNOPSIS ✨

html2pdf [ -l ] [ -e encoding ] [ -f font ] [ -s size ]
            input.html [ output.pdf ]

okay so here's the whole tea, one bullet at a time, no cap:

• if you don't hand over an input.html, she'll just read the HTML straight from standard input. feeding her, basically. 🍓
• if you don't hand over an output.pdf, she writes the PDF using the same name as the input file but with an extra .pdf suffix tacked on the end. unless the output is being redirected somewhere that isn't a terminal — then it goes to standard output. she's flexible like that. ✨
• if you don't give her an encoding, the input encoding lowkey defaults to "utf-8". periodt.
• if you don't give her a font, the base font family defaults to "Helvetica". and bestie, the font value can be a truetype font file, one of the PDF core fonts, or literally one of these four: "traditional", "simplified", "korean", "japanese". choices! we love options! 👑
• if you don't give her a size, the base font size defaults to 12 points. tiny but mighty. 🎀
• and if you pass -l, the output comes out in landscape layout. rotating her little world, she ate. 🔥

ngl the vibes are: feed her HTML, she feeds you a PDF. main character energy from start to finish. 💜

---

✨ AUTHORS ✨

the icon behind all of this: Audrey Tang <cpan@audreyt.org> 🌸

---

✨ COPYRIGHT ✨

Copyright 2004-2008 by Audrey Tang <cpan@audreyt.org>. 🫶

this software is released under the MIT license cited below. so generous, so real of her. 💖

---

🎀 The "MIT" License 🎀

bestie, this part is the actual legal text and I am not about to paraphrase a license, so here it is, character for character, exactly as written:

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be included
in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

🚨 real talk though: no warranty, express or implied, no promises about merchantability or fitness for a particular purpose, and nobody's liable for any claim, damages or other liability — whether in an action of contract, tort or otherwise — arising from, out of, or in connection with the software or its use. it's giving "use her responsibly." 😭

---

okay that's the whole page bestie!! this one's perl v5.38.2, dated 2024-07-28, and it lives under the name HTML2PDF(1p) — so if you ever need to cite her, that's the receipt. 🌈💜 mwah, go make some PDFs. 🎀✨