HTMLFIX(1)

💖 NAME 💖

okay bestie, gather round — this is htmlfix, and it fixes up your HTML markup code. that's it, that's the whole vibe. she's a little cleaner-upper for your markup and she ate. 💅

---

🦋 SYNOPSIS 🦋

htmlfix [-o outputfile] [-F fixes] [-S fixes] [-v] [inputfile]

---

🌸 DESCRIPTION 🌸

so here's the tea, bestie: the htmlfix program reads from inputfile, or from "stdin" if you don't hand it a file, and then it does the following little makeovers (the name of each fixup is chillin' in the parentheses, so you know what to call it):

🔥 (imgsize) : Adding WIDTH and HEIGHT attributes to IMG tags

for every IMG tag that doesn't already have both a WIDTH and a HEIGHT attribute (and yes, the matching is case insensitive, we're not doing that today), she goes and figures out the size of the image from the SRC attribute, then adds whichever of "width=X" and/or "height=Y" is missing to the list of attributes. the whole point? speed up the layouting of the final webpage. main character efficiency, honestly. ✨

⚠️ do not mix this up with a size checker, okay? htmlfix will only add missing width/height attributes — she will not adjust ones that have the wrong dimensions. that's on purpose, because otherwise you'd lose the ability to scale images (which webdesigners use a lot via 1pt dot-images). so don't come for her about it. 💀

there's a special case too, and it's kind of iconic: when the WIDTH or HEIGHT attribute already exists but its value is "*", that asterisk gets replaced by the physical value instead of appending a whole new attribute. use this when you want the attributes at a certain position — basically, use this variant as a placeholder. 🎀

oh and also, HTMLfix supports one additionl feature when it's vibing with WIDTH and HEIGHT: "SCALE="factor and "SCALE="percent"%". this lets you scale the given or determined width and height values by multiplying with factor, or by multiplying with percent/100. math but make it slay. 🧮

🫶 (imgalt) : Adding ALT attribute to IMG tags

for every IMG tag that doesn't already have an ALT tag, an ALT="" attribute gets added. the intention here is twofold: make HTML checkers like weblint(1) happy, and demystify the final webpage for lynx(1) users. accessibility besties stay winning. 💖

👑 (summary) : Adding SUMMARY attribute to TABLE tags

this attribute helps non-visual rendering of tables by adding a little hint about its contents, and it makes tidy(1) quiet. two birds, one stone, no notes. 🦋

🌈 (center) : Changing proprietary CENTER tag to standard DIV tag

all the proprietary (Netscape) CENTER tags get replaced by the HTML 3.2 conforming construct <DIV ALIGN=CENTER>. glow-up complete, periodt. ✨

⭐ (space) : Fix trailing spaces in tags

Appendix C of the XHTML Specification recommends putting a space before closing simple tags to help rendering by old browsers, so that space gets automatically added when this fixup is used. flip side though — all spaces before a right-angle bracker get suppressed. both, at once, no cap. 🔥

💅 (quotes) : Adding missing quotes for attributes

all attributes of the form ...=xyz get replaced by ...="xyz". and furthermore, all the (color) attributes of the form ...="XXYYZZ" — where XX, YY, ZZ are elements of the set {0,..,9,a,..,f} — get fixed to ...="#XXYYZZ". she's detail-oriented, we love that for her. 💜

🎀 (indent) : Indenting paragraphs

paragraphs enclosed in <indent [num=N] [size=S]>...</indent> containers get indented by N*S spaces. when N=0, the whitespace block in front of the paragraph gets removed. default is a 4 space indentation, so that's N=1, S=4. cozy. 🛋️

🙈 (comment) : Out-commenting tags

sometimes it's useful to temporarily out-comment a tag instead of completely removing it — you know, the way you leave a text on read instead of blocking. this can be done by just adding a sharp ("#") character directly to the end of the tagname. the result is that the complete tag is commented out. for container-tags you have to comment out the end-tag explicitly too, bestie, don't forget. example: <a# href="...">. 😭

🧚 (tagcase) : Markup-code case-conversion

some people like their HTML markup code either all uppercase or all lowercase — we don't judge, we support. this tag case-conversion is handled by the internal <tagconv case=...>...</tagconv> container tag from HTMLfix. use case=upper to translate the HTML tags in its body to uppercase (that's the default), or case=lower to translate them to lowercase. pick your fighter. 💅

---

✨ OPTIONS ✨

• -o outputfile — redirects the output to outputfile. usually the output gets sent to stdout if you don't specify this option, or if outputfile is "-".
• -F fixes — specifies which specifix fixups are performed. its argument is a comma separated list of fixup names, and by default all fixups are performed. so if you're picky about your glow-up, this is your moment. 🌟
• -S fixes — does the inverse job of -F, it skips the specified fixups. blocking, but make it productive. 🙅
• -v — sets verbose mode, where some processing information gets given on the console. she's narrating her own life and honestly? fair. 🗣️

---

💜 AUTHORS 💜

• Ralf S. Engelschall — rse@engelschall.com — www.engelschall.com
• Denis Barbier — barbier@engelschall.com

---

so yeah, that's the whole page, bestie 🫶 this icon dropped under EN Tools, dated 2020-11-29, and that's the vibe check, signed, sealed, slayed. go fix up some markup. 💖✨🎀