User Guide

ARTS PDF Aerialist Professional User Guide
Links
| CONTENTS | INDEX |
 Page 145 of 200
7.6.5. Report on Selected Link
This feature will generate a low level report on the structure of the selected link or
annotation. This feature is intended to be useful to experienced developers who are
familiar with the PDF Specification. This report may offer an explanation as to
possible strange (unexplained) behaviors in a link.
To use:
1. Select the ARTS PDF Link Tool in the toolbar.
2. Using the ARTS PDF Link Tool select a single link or annotation.
3. Click ‘Plug-ins > ARTS PDF Aerialist > Links > Create Report On > Selected
Link or Annot’
Note:
A GoToR link to an external file that references a page number or name that does
not exist will cause Adobe Acrobat to open the external file to page one. Because
the user goes somewhere when a link is clicked, the link would not seem to be
broken. But, the link is broken, and ARTS PDF Aerialist will flag this as a bad link.
If you find such a link and the desired destination happens to be page one
anyways, you can leave this alone. If, however, you are using a named
destination and the intended destination is later moved to another page along
with the named destination, the link will still point to page one because it is using
a name that does not match any name found in the document.
You may occasionally get the message that the routine went "too deep" and an
object will not be enumerated. This is often the case with objects that refer to
each other in a circular loop of "next" and "previous" objects. This setup is valid,
and is sometimes required by the spec, but ARTS PDF Aerialist will not provide
details about objects it knows are of this type, and will stop after a certain
number of iterations if it unknowingly starts reporting in a loop.