W2HTML(1)

💖 w2html — the manual page, but make it make sense 💖

ok so bestie, welcome to W2HTML(1) — a User Contributed Perl Documentation page, no less. Yes we're in the big leagues. Sit down, grab a snack 🍓, and let me tell you about the little tool that turns your to-do list into a whole ✨web page✨.

---

🌸 NAME 🌸

w2html — a HTML exporter for w2do. That's it, that's the vibe. It takes your w2do stuff and exports it to HTML. Iconic behaviour, honestly.

---

🎀 SYNOPSIS 🎀

w2html [-bikDIPS] [-H heading] [-e encoding] [-o file] [-s file] [-f|-u]
[-d date] [-g group] [-p priority] [-t task]

w2html -h | -v

---

🦋 DESCRIPTION 🦋

So w2html is a HTML exporter for w2do, which is a simple to use yet efficient command-line todo manager written in Perl. Perl girlies rise up 💅.

By default it lists all your tasks — every single one, no filter, the whole roster. But if you want a cute little subset instead, you can easily select exactly what you want by specifying options. Choose your own adventure, bestie. ✨

---

💜 OPTIONS 💜

✨ General Options ✨

• -h, --help — Display the help message and exit. The classic "help me please" button.
• -v, --version — Display version information and exit. Main character info dump.

🔥 Specifying Options 🔥

• -t task, --task task — Specify the task name. Tell it which task you're talking about.
• -g group, --group group — Specify the group name. Now here's the tea: the group name should be a single word with a maximum of 10 characters — but don't panic, longer names are shortened automatically. She'll handle it. 💁
• -d date, --date date — Specify the due date. Your available options are anytime, today, yesterday, tomorrow, month, year, or an exact date in the YYYY-MM-DD format, e.g. 2008-06-17 for 17 June 2008. So many choices, so little time.
• -p priority, --priority priority — Specify the priority. Available options are integers between 1 and 5, where 1 represents the highest priority. Yes, 1 is the boss. Number one for a reason. 👑
• -f, --finished — Specify the finished task. Done and dusted, periodt.
• -u, --unfinished — Specify the unfinished task. The "it's still on my list, don't look at me" option. 🙈

💫 Additional Options 💫

• -H heading, --heading heading — Use selected heading. You pick the heading, she uses it.
• -e encoding, --encoding encoding — Specify the file encoding in a form recognised by the W3C HTML 4.01 standard (e.g. the default UTF-8). Standards-compliant and cute about it.
• -o file, --output file — Use selected file instead of the standard output. Send it somewhere specific instead of yelling into the terminal.
• -s file, --savefile file — Use selected file instead of the default ~/.w2do as a save file. Different save file, same energy.
• -k, --preserve — Do not rewrite existing style sheet if present (e.g. because it contains some local changes). Respect the local edits, bestie. 🫶
• -b, --bare — Leave out the HTML header and footer. This is especially useful when you are planning to embed the list to another page. Naked list, no wrapper, lowkey perfect for embedding.
• -B, --no-bare — Include HTML header and footer; the default option. Fully dressed, as nature intended.
• -i, --inline — Embed the style sheet to the page itself instead of creating a separate CSS file. But heads up: combining this option with -b results in no style sheet at all. So like… choose wisely. 😭
• -I, --no-id — Do not include ID column in the listing.
• --with-id — Include ID column in the listing; the default option.
• -D, --no-date — Do not include due date column in the listing.
• --with-date — Include due date column in the listing; the default option.
• -P, --no-priority — Do not include priority column in the listing.
• --with-priority — Include priority column in the listing; the default option.
• -S, --no-state — Do not include state column in the listing.
• --with-state — Include state column in the listing; the default option.
• --with-stats, --stats — Include overall task list statistics. Numbers! Data! The receipts! 📊
• --no-stats — Do not include overall task list statistics; the default option.

---

🌈 ENVIRONMENT 🌈

• W2DO_SAVEFILE — Use selected file instead of the default ~/.w2do as a save file. Same deal as -s, but living in your environment instead. iykyk.

---

🧚 FILES 🧚

• ~/.w2do — Default save file. Home sweet home for your tasks. 🏠

---

⭐ SEE ALSO ⭐

w2do(1), w2text(1), perl(1).

Go read the whole friend group, they're all connected. 💖

---

💀 BUGS 💀

To report bugs or even send patches, you can either add a new issue to the project bugtracker at <http://code.google.com/p/w2do/issues/>, visit the discussion group at <http://groups.google.com/group/w2do/>, or you can contact the author directly via e-mail.

Three ways. Pick your fighter. Please do report bugs though, she's trying her best. 🙏

---

👑 AUTHOR 👑

Written by Jaromir Hradilek <jhradilek@gmail.com>. Shoutout to the author, absolute legend. ✨

Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.

A copy of the license is included as a file called FDL in the main directory of the w2do source package.

---

💅 COPYRIGHT 💅

Copyright (C) 2008, 2009, 2010 Jaromir Hradilek

This program is free software; see the source for copying conditions. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

fr fr, read that part again. No warranty, bestie. She's free and she's trying, but she is not liable. 🫶

---

okay that's the whole page!! Version 2.3.1, dated 2018-12-28, and it's filed under W2HTML(1) in the User Contributed Perl Documentation section. mwah, go export some tasks 💖✨🎀