Text masks are supported when generating bookmarks or tables of content in Debenu PDF Aerialist.

The text masking property has a number of special characters allowing you to selectively create bookmarks. They are described in detail below with simple examples provided.

Note: The user should be aware that the Bookmarks feature processes text by lines of text, and produces a bookmark out of the whole line of text. For example, if you specified “sales” in the text mask field, and your PDF document had a line in it with the text “and so to conclude, our company had no major sales this month”, this whole line of text will be turned into a bookmark.

Mac

Macintosh users can simply enter partial words to bookmark a line of text. Any line containing the characters will create a bookmark. It is not case sensitive.

Example: Entering “en” will create bookmarks from any lines of text containing “en” such as “Enjoy”, “entertain”, “content”, “burden” etc.

Windows

  • Case sensitive: Text Masking is case sensitive, so entering “ABC” will create different bookmarks from “abc”.
  •  . : The “.” matches one instance of any character.Example: Entering the expression “P.F” into the Text Mask field, it would create a bookmark from any lines of text containing “PDF, PeF, PdF,” etc.
  • ^ : The “^” only creates a bookmark if the specified text appears at the very start of the line.Example: Entering the text “^abc” will only create a bookmark if the line started with “abc”. If a line of text started with “1.0 abc” no bookmark of it would be created.
  • $ : The “$” only creates a bookmark if the specified text appears at the very end of the line.Example: Entering the text “abc$” will create a bookmark only from text with lines ending with “abc”, so “…xyzabc” would cause a bookmark of that line to be created, but “abcxyz” would not have a bookmark created.
  • If you only want to create bookmarks from lines that only contain the exact text you specify, use both the “^” and “$” characters.
  • [ ] : Any lines containing characters inside the “[ ]” will be created into a bookmark. Characters can be specified literally, or as a range of characters.Example: “[abc]” will create bookmarks from any lines containing either a, b, or c. This is opposed to only creating a bookmark from text containing abc if “abc” is entered. “[a-dA-D]” will create bookmarks from lines containing any of the characters between a-d (that is, a, b, c and d), in both lower and upper-case.
  • [^] : Any text containing characters inside the “[ ]” and after the “^” will not be turned into bookmarks. This feature is very handy when applied with in conjunction with other bookmark selection properties to stop unwanted bookmarks from being created. Please be aware that conversely this means that any other text not in the “[ ]” will be considered as potential bookmark material. Therefore it is suggested that another bookmark selection property is used in conjunction with this one.Example: Entering “[^0-9]” will still create bookmarks containing numbers if the text line contains any other character – 1.0 will be turned into a bookmark because it contains a “.”. If you really want to exclude numbers like 1.0 you would need to modify it to “[^0-9\.]. The “\” is explained below, and is needed because “.” is a considered special character in text masking.
  • \ : The “\” character is used when you wish to actually match a special character, such as “.” Or “$”. These special characters are used in the Text Mask field to perform special text matching.Example: Entering “\$” will search and create a bookmark from text on the document containing a “$”, ignoring the normal “$” text mask command.
  • * : Use the “*” character to create bookmarks from more than one set of characters at the same time.Example: Entering “a*b” will create bookmarks from any line of text containing either a and/or b.
  • + : Use the “+” character to create bookmarks from a set of characters arrayed in a certain order. Bookmarks can be created from the first character(s) before the “+”, however, characters after the “+” can only be bookmarked if the characters before the “+” are also present.Example: Entering “a+b” will create bookmarks from any line of text containing ab, aab, aaab¸ etc. Any text like ba, or cb, will be ignored.
  • ? : Like the “+” character, the “?” character creates bookmarks from a set of characters arrayed in a certain order, but in this case, bookmarks can be created from characters before the “?” only if the proceeding characters are also present. The characters after the “?” can be used to create bookmarks, irrespective of whether characters before the “?” are present.Example: Entering “a?b” will create bookmarks from any line of text containing ab, abb, or just b.
  • ( ) : Allows characters to be grouped together and be combined with other special characters.Example: “(a*b)$” will create bookmarks from lines of text containing either a and/or b, but only if these lines end with a or b.
  • | : Creates bookmarks from either one set of characters or another.Example: Entering “a | b” into the Text Mask field will create bookmarks from lines of text containing either a or b.