<< Click to Display Table of Contents >>
Navigation: Actions Library > Bookmark Actions >
Generate Bookmarks from Page Text
The Generate Bookmarks from Page Text action creates bookmarks from the text of input documents. It contains the following customizable parameters:
Figure 1. Generate Bookmarks from Page Text Action Optons
•Click All Options to view/edit all options. The Generate Bookmarks from Page Text dialog box will open, as detailed below.
•Select the Show setup dialog while running box to launch the Generate Bookmarks from Page Text dialog box and customize settings each time this action is used. Clear this box to disable the Generate Bookmarks from Page Text dialog box from opening each time the action is used, which is useful when the same settings are used consistently.
Figure 2. Generate Bookmarks from Page Text Dialog Box
Note that it is necessary to create bookmark generators in order to generate bookmarks from page text.
•Click Add to add a new bookmark generator. The Bookmark Generation Properties dialog box will open, as detailed in (figure 5).
•Click Edit to edit the selected bookmark generator.
•Click Remove to remove the selected bookmark generator.
•The Page Range options determine the pages included in the generation of bookmarks:
•Select All to use all document pages.
•Select Custom to use a custom page range. Further information on how to specify page ranges is available here.
•Use the Subset option to select All Pages, Odd Pages or Even Pages as desired.
•Select the Ignore text that contains stop words box as desired. Text containing stop words will be excluded from the bookmark generation process when this option is enabled. Click the ellipsis icon to view/edit the list of stop words.
•Select the Ignore consecutive duplicate bookmarks box to prevent the creation of consecutive identical bookmarks.
•Select the Replace Existing bookmarks box as desired.
•Click the Settings dropdown arrow to save/manage/delete bookmark generator settings:
Figure 3. Generate Bookmarks from Page Text Dialog Box, Save/Manage/Delete Options
•Click Save Current Settings to save the current settings as a profile for subsequent use.
•Click Delete to delete the current profile.
•Click Manage to manage profiles. The Manage Presets dialog box will open:
Figure 4. Manage Presets Dialog Box
•Click Edit to edit selected profiles.
•Click Clone to clone selected profiles.
•Use the up and down arrows to move selected profiles up or down in the list.
•Click Delete to delete selected profiles.
•Click Import to import profiles from a saved file.
•Click Export to export profiles to file.
Figure 5. Bookmark Generation Properties Dialog Box, Text Matching Options Category
The options selected in the Bookmark Generation Properties dialog box determine the text used to generate bookmarks, and the style of the generated bookmarks:
Text Matching Options
These options determine text used in the generation of bookmarks according to font, size and color:
•Select the Font Names box to include text of specific fonts in the generation of bookmarks. Click Add to add fonts to the list, Add Custom to add custom fonts, or Remove to remove selected fonts.
•Select the Font Size box to include text of a specific size in the generation of bookmarks. Use the number boxes to determine the Size, Tolerance and Units of text included in the generation of bookmarks. The Tolerance value determines the degree to which selected text can differ from the specified Font Size and remain included in the generation of bookmarks.
•Select the Text Color box to include text of a specific color in the generation of bookmarks, then select a color in the dropdown menu.
•The Get Style from Selected Text option is not currently available. It will be available in a future build of PDF-Tools.
•The option selected in the Match Text Case dropdown menu determines text used in the generation of bookmarks according to text case:
•Select No Restrictions to include text of all cases in the generation of bookmarks.
•Select All Characters Are Capital to include only upper-case text in the generation of bookmarks.
•Select First Character is Capital to include only text that starts with a capital letter in the generation of bookmarks.
•Select First Character is Digit to include only text that starts with a digit in the generation of bookmarks.
•Select the Allow multiline bookmark titles box to allow bookmark titles to exceed one line in length. This is useful in cases where it is not possible to shorten bookmark titles.
•Select the Match Text Pattern box to specify a sequence of words that document text must match in order to be included in the generation of bookmarks. Enter the desired text patten in the text box.
•Select the Match text case box to include only text that matches the case of the text entered in the Match Text Pattern box. If this box is not selected then all matching text will be included regardless of its case.
•Select the Limit bookmark titles to matching pattern only box to determine that only text matching the specified pattern will be included in the generation of bookmarks.
These options determine characteristics of generated bookmarks:
Figure 6. Bookmark Generation Properties Dialog Box, Resulting Appearance Category
•Use the Text Color menu to determine the text color of bookmarks.
•Use the Text Style menu to determine the text style of bookmarks.
•Use the Zoom menu to determine the zoom level when bookmarks are clicked. Select Inherit to use the current zoom level.
•Select the Show expanded box to expand all generated bookmarks.
These options are used to format bookmark titles:
Figure 7. Bookmark Generation Properties Dialog Box, Title Formatting Category
•Select a Text Case option to determine the text case of generated bookmark titles.
•Select the Search and replace bookmark title with text patterns box to search for specific text in bookmark titles and replace it with customized text:
•Enter the text to be replaced in the Search Pattern text box.
•Enter the replacement text in the Replace Pattern text box.
•Select the Match text case box as desired.
•Select the Insert text before each title box to add text before bookmark titles. Enter the desired text in the text box.
•Select the Add text after each title box to add text after bookmark titles. Enter the desired text in the text box.
•The Leading Numbers dropdown menu is used to add/remove/retain leading numbers for bookmarks. Select No Change, Add or Remove as desired. If leading numbers are being added then use the Use dropdown menu to select Numbers, Letters or Roman Numerals.
•Use the Maximum Title Length text box to set the maximum number of characters for generated bookmarks.
•Select the Remove duplicate spaces box to remove instances of adjacent blank characters.
•Select the Replace line breaks with spaces box to use spaces instead of line breaks for bookmarks.
Click OK to save changes.