odfhighlight - search, replace and highlight text in a document
odfhighlight "source.odt" "search string" -r
"replacement" -o "target.odt"
replaces "search string" by "replacement" in
the file "source.odt", highlights each replacement with a yellow
(default) backgound, then writes the resulting document as
odfhighlight "myfile.odt" "search string"
highlights each occurrence of "search string" in
"myfile.odt" with a green background color, without changing the
text (without "-o" option, the changes apply to
With the "minimal" command line, with only a filename and a string as
arguments, each matching string is highlighted with a yellow background and
represented with the "Standard" style.
-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:
-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"
-t --target "filename"
an alternative filename to save the modified document, when
the source document must remain unchanged