ODFHIGHLIGHT(1)

💖 NAME 💖

okay so bestie, meet odfhighlight(1) — it’s from the User Contributed Perl Documentation, and it literally does search, replace and highlight text in a document. The whole thing is giving ✨ document-glow-up ✨ and I’m obsessed.

✨ SYNOPSIS ✨

odfhighlight "source.odt" "search string" -r "replacement" -o "target.odt"

This one replaces "search string" by "replacement" in the file "source.odt", highlights each replacement with a yellow (default) background, then writes the resulting document as "target.odt" 🎀

odfhighlight "myfile.odt" "search string" -color "green"

This one highlights each occurrence of "search string" in "myfile.odt" with a green background color, without changing the text — and without the -o option, the changes apply to "myfile.odt" 💅

🦋 ARGUMENTS AND OPTIONS 🦋

🌼 Default behaviour 🌼

With the minimal command line — just a filename and a string as arguments — each matching string is highlighted with a yellow background and represented with the Standard style. That’s the default vibe, no extra flags needed 🫶

🎀 Options 🎀

• -e, --encoding "xxxxxx" — character set to use, if different from the default
• -r, --replacement "new string" — "new string" is used as a replacement for "search string"
• -c, --color "code" — an RGB color code, expressed either as the concatenation of 3 comma-separated decimal values (each one in the range 0..255, ex: "72,61,139" for a dark slate blue), or a 6-digit hexadecimal number, preceded by a # (ex: #00ff00 for green) or, if a colormap is available and known in your OpenOffice::OODoc installation, a symbolic color name (ex: "sky blue")
• -s, --stylename "name" — the name of the color style (default: "MyHighlight"); the user must provide a style name that is not already in use in the document
• -p, --property "property=value" — This option can be repeated; each occurrence gives an additional property for the highlight style (font name, size, foreground color, ...). For example, with the combination of -p 'fo:color=#ff0000' and -p 'fo:font-size=18pt', the highlighted text will be made of 18pt-sized, red characters. In order to master these options, you should have some knowledge of the Form Objects (FO) vocabulary that is used in the OpenDocument specification.
• -o, --output "filename" and -t, --target "filename" — an alternative filename to save the modified document, when the source document must remain unchanged

That’s the whole page, bestie — signed off from the User Contributed Perl Documentation, perl v5.42.3, dated 2010-07-12 🫶💖