THEME(1)

💖 THEME(1) 💖

okay bestie, welcome to the General Commands Manual page for theme — yes that's the whole manual name, we're fancy here 🎀. Strap in, this one's actually so useful.

---

🌸 NAME 🌸

theme — create a web page from a template file ✨

---

🦋 SYNOPSIS 🦋

theme [-C option-flags] [-c options] [-d root] [-E] [-f] [-o file]
      [-p pagename] [-t template] [-V] [textfile]

---

🌈 DESCRIPTION 🌈

so here's the vibe: theme grabs a markdown(7)-formatted textfile — or stdin if you don't hand it a file, no pressure — compiles it, and smushes it together with a template to cook up a whole web page. default template? that's page.theme, iconic.

if you don't tell it where the template lives, theme goes on a little scavenger hunt 🔍: first page.theme in the current directory, then each parent directory all the way up to the document root. and the document root is set with -d, or — if you never set it — it's just the root directory of the system. once it finds page.theme, theme copies it straight into the output, hunting for <?theme action?> html tags and processing whatever action is embedded in there. slay.

🎀 the actions it processes

• author — prints the author name(s), straight from the mkd_doc_author(3) function.
• body — prints the formatted markdown(7) input file. the main character, honestly.
• date — prints the date that mkd_doc_date(3) gives back or, if there isn't one, the date the input file was last modified.
• dir — prints the directory part of the pagename.
• include(file) — prints the contents of file. and heads up: Markdown(7) translation will NOT be done on this file. not even a little.
• source — the filename part of the pagename.
• style — print any stylesheets (peep mkd-extensions(7)) found in the input file.
• title — prints the title from mkd_doc_title(3) or, if that doesn't exist, the source filename. fallback queen 👑.
• version — print the version of discount(7) that this copy of theme was compiled with.

---

if the input is coming from a file and you never set the output with the -o option, it writes the output to file-sans-text.html — like, if file has a .text suffix, that gets stripped off and replaced with .html; otherwise a .html gets appended to the end of the filename. cute, right?

💅 the options, fr fr

the options are as follows:

• -d root — set the document root to root.
• -E — normally theme will not expand <?theme body?> or <?theme toc?> in the <head> section, or <?theme style?> in the <body> section, but the -E option overrides all that and allows expansions everywhere.
• -f — forcibly overwrite existing html files. no asking, no mercy 💀.
• -o filename — write the output to filename.
• -p path — set the pagename to path.
• -t filename — use filename as the template file.

---

💀 RETURN VALUES 💀

theme exits 0 on success, and >0 if an error occurs. that's it, that's the whole drama.

---

👑 SEE ALSO 👑

markdown(1), markdown(3), markdown(7), mkd-extensions(7).

---

🫶 AUTHOR 🫶

David Parsons (orc@pell.portland.or.us) — legend behavior, honestly.

---

and that's the whole page bestie!! this one's from MASTODON, dated January 23, 2008 — vintage, but she ate and left no crumbs 🍓✨ go build something cute, ily, bye 💜