Batch highlighting tool can process all PDF documents in a directory tree and create new PDFs with built in highlight annotations. Documents can be highlighted for a single query or multiple queries specified in a CSV file.
Run batch highlighter from the command line. Available options will be listed when started without arguments:
Batch highlighter works in offline mode and does not need Highlighter Server running – in fact, the server and the batch tool cannot run at the same time.
Simple Query Highlighting
To highlight documents for a single query, use
-q option as in:
The above command will highlight terms home, style, and price using English language rules.
Using Query File
Using a query file you can highlight all your PDF documents for multiple, possibly hundreds, keywords and phrases at once.
The query file is a plain CSV file with the following columns:
query is the only required column. Multi term queries will be handled as phrases without need to put them in quotes. Color is desired RGB color of highlight for the query keywords.
Tags can be used to categorize and group keywords. If the color was not specified but the tag is, all queries with the same tag will get assigned the same color. In addition, created PDF bookmarks to highlights will be grouped by tags.
The bookmark column can be used to control PDF bookmark creation on a query level, specifying bookmark path template string. If not defined, the default path template will be used – see PDF bookmark options for more details about customizing bookmark creation and PDF output.
To highlight PDF documents for a query file, use
-qf option as in:
The queries CSV file can list queries only, as in:
or, can include colors and tags as well:
To quickly test how PDF highlighting works for your documents and keywords, use our online demo.
The batch highlighter configuration file is named
application.conf and is loaded from the
This config file does not exist by default, but the directory contains the file
application.conf.sample that contains the most commonly used options and you can use it as an example when creating your own.
Batch highlighter creates a log of all handled files, listing any issue or error that occurred. The default path to the log file is
The file is overriden every time the batch tool runs.