tart-custom(5)

📦 version 3.10, in debian trixie, ubuntu jammy, ubuntu questing, ubuntu resolute, ubuntu stonking

🎀 tart-custom — the LinuxTaRT template format 💖

okay bestie, so this is the manual for tart-custom(5), aka the LinuxTaRT template format. yes it's a manual page, yes it's about signature templates, and yes we're gonna make it make sense together. let's go ✨

✨ NAME ✨

tart-custom — the template format for LinuxTaRT 🌸

💅 DESCRIPTION 💅

so here's the tea: LinuxTaRT can use a user defined template file to generate the signature. you get to pick the name and location of that file in ~/.tartrc, but if you don't say anything it just defaults to this spot:

~/.tart-custom

no cap, that's the whole vibe. you write a template, tart fills in the blanks. 💖

🦋 PARAMETERS 🦋

LinuxTaRT recognizes the following directives in the template and replaces them with the corresponding values — this is the part where it gets iconic, so pay attention:

  • %c1 — CustomText1 from .tartrc 💜
  • %c2 — CustomText2 from .tartrc 💜
  • %tg — tagline. randomly selected from the tagline database. yes it's giving chaos, that's the point 🎲
  • %hr — horizontal line ➖
  • %dt — todays date. in the format: Monday, February 25, 2002 📅
  • %12 — current hour, in 12-hour format 🕐
  • %24 — current hour, in 24-hour format 🕛
  • %mn — current minutes ⏱️
  • %ap — AM / PM 🌞🌙
  • %ut — system uptime. for RiscOS or systems with the sysinfo function. iykyk 👑
  • %ib — time in ibeats 🥁
  • %vi — LinuxTaRT version string 🏷️
  • %% — the percent symbol (%) 💯

and literally any other characters in the template? they get copied to the signature as is. no editing, no opinions, just vibes ✨

🌈 EXAMPLES 🌈

here's the moment you've been waiting for. take this template:

LinuxTaRT - The Automatic Random Tagline
%hr
/dev/random says:
%tg

http://mycompany.com
%hr

and it generates the following signature:

LinuxTaRT - The Automatic Random Tagline
-------------------------------------------------------
/dev/random says:
Best way to dispose of the Borg: Give them Windows 3.1.

http://mycompany.com
-------------------------------------------------------

see how %hr turned into that long line of dashes and %tg pulled a whole random tagline out of nowhere? main character energy, fr fr 🔥

🍓 FILES 🍓

  • ~/.custom

🧚 SEE ALSO 🧚

okay that's the whole page bestie, you ate that 💅 this little manual was brought to you by Mark Veinot, version 1.0.0 — go forth and make your signature cute 🫶

📦 where this page comes from