Please choose a menu option
Visit the IDRsolutions WebSite

Introductory PDF Plugin Tutorial

This tutorial shows the new features of the free JPedal PDF plugin for Java IDEs.

We have included a number of related PDF files in the bookmarks list, including some of the free sample chapters from the excellent Manning series of In Action books. These are copyright of Manning and included with permission.

Feature summary

  • Provide support for viewing PDF files.
  • Allow searching of PDF files.
  • Allow users to store a list of PDF files (either on the Internet or locally) which can be accessed via keyboard shortcuts. PDF Files from the Internet will be downloaded and cached for faster access next time they are viewed.
  • Provide an Open Source example of implementing an Eclipse plugin, NetBeans plugin and IDEA plugin.

There are specific pages on each PDF plugin covering installation. If you have followed these, the notes below will help you to make full use of the PDF plugin.

Opening a PDF file

Once the plugin is installed, the IDE will use it to display any PDF files. In this screenshot, we have used File - Open option. Double-clicking on any PDF listed in the IDE will have the same effect.

PDF plugin

Each PDF plugin is tailored to the specific IDE but all have the same structure shown above in the screenshot from the IDEA version:

  • A window showing the PDF file on the right with a toolbar at the top.
  • If the PDF file has an outline tree, it will be displayed and clicking on the links will go to the page.
  • A hideable PDF search window which allows the user to find words in the PDF file and click on them. This will take you to the page and the word will be highlighted.

The PDF toolbar

This has been moved back onto the panel in this release to make it less inconspicuous and offers the following features:

Current page/Total page count display
PDF plugin Zoom out of the PDF file
PDF plugin Zoom into the PDF file
PDF plugin Go to the first page
PDF plugin Jump back ten pages (if possible)
PDF pluginBack one page
PDF plugin Forward one page
PDF plugin Jump forward ten pages (if possible)
PDF plugin Go to the last page
PDF plugin General information on the plugin
PDF plugin Open list of PDF files bookmarked for quick and easy access

PDF Bookmarks

The PDF bookmarks feature allows the user to store a list of files (which can also be internet links). If the file is on the Internet, it will be downloaded and cached locally for future use (cached files are deleted when removed from the list). This makes it very easy to have your favorite documentation easily accessible and searchable. A default list of useful resources is provided as a starting point.

If the external box is ticked, the PDF will be opened in an external Java PDF viewer (which offers enhanced PDF search and other capabilities). Otherwise, it will appear as a new tab in the IDE.

PDF plugin

The PDF bookmarks function can be easily accessed from a keyboard shortcut of pressing the 3 keys ctrl shift d together, the toolbar PDF plugin or the File menu.

PDF plugin

Taking it from here

The PDF plugins (and the version of the Java PDF library they use) are all released under the LGPL license and the java source code is freely downloadable so the PDF plugins can be extended and tailored further.

Feedback and questions

There is a support forum for questions, or you can contact IDRsolutions via our contact page. Please note the plugins are not officially supported, but we are interested in any feedback and bug reports.

Links to related articles

Homepage for all PDF plugins.
Homepage for Open Source and commerical version of JPedal PDF library.

 

Return to main PDF support section

Click here for the main PDF support area with lots of java examples, PDF tutorials and useful information to get the most out of the JPedal PDF library

 


PDF viewer