HXWLS(1)

💖 hxwls — the HTML-XML-utils link lister 💖

okay bestie, gather round, because hxwls is literally the friend who reads your HTML and tells you about every single link in it. no gatekeeping. no judgment. just links. ✨

✨ NAME ✨

hxwls — list links in an HTML file 🦋

🌸 SYNOPSIS 🌸

hxwls [ -l ] [ -t ] [ -r ] [ -h ] [ -a ] [ -b base ] [ file ]

💅 DESCRIPTION 💅

so the way this works is: hxwls reads an HTML file (and if you don't hand it one, it just reads standard input, no big deal, it's flexible like that 💁) and then prints out all the links it finds. the output goes to stdout. that's it. that's the whole vibe. 👑

🎀 OPTIONS 🎀

here's everything it supports, and yes we're going through all of them, because we don't skip:

• -l — long listing energy 💖. instead of just handing you the URI, hxwls prints three columns: the element name, the value of the REL attribute, and the target URI.
• -t — the tuple listing, aka the even more listing 🫶. this one prints four columns: the URI of the document itself, the element name, the value of the REL attribute, and the target URI.
• -r — keeps it real 🎀. prints relative URLs as they are, no converting them into absolute URLs. lowkey just respecting them as they came.
• -b base — sets the initial base URL to base. but heads up bestie: if there's a <base> element in the document, it will override the -b option. the document has main character energy here, ngl.
• -h — outputs as HTML 🌈. the output comes out in the form of <a> elements. cute, right?
• -a — converts any IRIs (Internationalized Resource Identifiers) to ASCII-only URIs ✨. what that means: any non-ASCII characters in the path of a URI get encoded as %-escaped octets, and non-ASCII characters in the domain name become punycode. quick note though — punycode encoding is only available if hxwls is compiled with libidn support. so like, depends on the build, iykyk.

🦋 OPERANDS 🦋

the one and only:

• file — the name or the URL of an HTML file. if it's absent, standard input is read instead 💜.

😭 DIAGNOSTICS 😭

the exit values, and we care about them:

• 0 — successful completion. slay. 🎉
• > 0 — an error occurred in the parsing of the HTML file. and honestly? hxwls will try to correct the error and produce output anyway 💀. resilient queen.

👑 SEE ALSO 👑

go hang out with the rest of the squad:

asc2xml(1), hxnormalize(1), hxnum(1), xml2asc(1)

and that's the whole page, bestie!! this is HTML-XML-utils version 7.x, dated 10 Jul 2011 — yes she's been iconic since 2011 and she's still serving 🕰️💖. now go list some links. periodt. 💅✨