wml::fmt::text(3)

✨ wml::fmt::text ✨ — the wml::fmt::text(3) era 💖

okay bestie, gather round, because this one is genuinely one of the cutest little EN Tools modules and it's about to make your plain ASCII text look so good 💅

---

🌸 NAME 🌸

wml::fmt::text — Plain ASCII with Special Formatting Semantic ✨

---

🎀 SYNOPSIS 🎀

#use wml::fmt::text

<: print &wml_fmt_text({ FILE => $file, OPTIONS => '--xhtml', ...}); :>

<text notypo>
FOO
===

1. bar
2. quux
   a. baz
   b. foo
...
</text>

---

🦋 DESCRIPTION 🦋

ngl the usage is stupid simple: you just wrap your text in the <text> container tag and then literally just write plain ASCII text inside it. that's it. that's the whole vibe. 🫶

the corresponding HTML code gets made via txt2html(3), which is a filter that gives the ASCII text nice formatting semantic which control the HTML result. it's giving ✨glow up✨ for boring text.

now, if the OPTIONS field is specified, a newer txt2html(1) filter is called instead of txt2html, which is dead upstream 💀. this allows for instance generation of XHTML markup. so if you want the fancy modern version, you know what to do 👑

the core conversion function is wml_fmt_text() which also can be used by other include files. very giving, very generous of it 💖

---

💜 ATTRIBUTES 💜

these attributes can be used both in the <text> tag (in lowercase letters!!) and in wml_fmt_text's arguments, as shown in the examples above. two ways in, same energy 🔥

• NOTYPO — by default, font commands are added to headings to highlight them (main character behavior fr fr). this attribute prevents alteration of txt2html's output. so like, if you want it left exactly as-is, no notes, this is your girl 🙈
• OPTIONS=str — this attribute performs two actions: select txt2html as a filter instead of txt2html, and make str arguments be passed literally on the command line of txt2html. two birds, one iconique attribute 🎀

---

👑 AUTHOR 👑

Ralf S. Engelschall

rse@engelschall.com

www.engelschall.com

---

🌈 REQUIRES 🌈

• Internal: P1, P2, P3, txt2html (WML)
• External: --

---

⭐ SEE ALSO ⭐

txt2html(1)

---

and that's the whole page bestie!! 💖 EN Tools, dated 2020-11-29, wml::fmt::text(3) — literally iconic, no cap, periodt 🎀✨🦋