- (Default) Sensible searches for repeated text at the bottom of the page. For more information about automatic recognition, see Notes.
- (Configurable) To bypass automatic recognition, for example to recognize footer text that varies slightly, configure a text match. Sensible removes all text below the bottom boundary of the matched text. The preprocessor removes text on pages in which it finds the match, and ignores pages missing the match.
Parameters
key | value | description |
---|---|---|
type (required) | removeFooter | For an example, see the Examples section. |
startsOnPage | integer. default: 1 | The first page number on which to start checking for repeated elements. Note this is the page number, not the page’s zero-based index in the pages array. To filter out end pages that lack a repeating element, use the Page Range preprocessor to define an End Page parameter. |
match | Match object or array of Match objects | Bypasses automatic footer recognition.Removes all text on the page below the bottom boundary of the matched line.If Sensible doesn’t find the match, it doesn’t perform footer removal. |
offsetY | number in inches. default: 0 | Bypasses automatic footer recognition.Defines a point at which to start text removal. Positive values offset down the page, negative values offset up the page.If used with no Match parameter defined, offsets from the bottom of the page.If used with the Match parameter, offsets from the bottom boundary of the matched line. |
Examples
The following example shows using automatic footer recognition. The example document contains:- A repeating footer with an incrementing page number. Sensible removes this.
- A repeating sidebar that overlaps the y-extent of both repeating and variable elements:
- Where it overlaps a repeating element, Sensible treats it as repeating and removes it.
- Where it overlaps variable text, Sensible treats it as nonrepeating and retains it.
JSON


Example document | Download link |
---|
JSON
Notes
Automatic footer recognition To automatically recognize a footer, this preprocessor starts at the bottom of the page and moves up the page, stopping as soon as it finds a nonrepeating element. Sensible recognizes these elements as “repeating”:- Elements whose y-extent doesn’t overlap with any variable element on the page
- Positively incrementing page numbers
- Elements that change their alignment on alternate pages (for example, page numbers aligned alternately left and right, as in a book)
- A repeating element that’s missing from even one page (for example, from an intentionally blank page).