Usage Note 24178: How can I control PDF links, tables of contents (bookmarks), and notes?
In SAS 8.1, the PDFMARK option with the ODS PRINTER statement
inserts special tags into the PostScript file that allow
Adobe Acrobat Distiller to do special markup. In SAS 8.2 and later, the PDF option
improves upon this, producing PDF
directly without the use of third-party software.
With either of these options to the ODS PRINTER statement, by default you get three special kinds of
formatting added:
- Links.
Basically you generate URLs just like HMTL, and ODS PDF
tries to "do the right thing" with them.
See FAQ 4148 for in-depth information.
- Table of contents. A table of contents window called Bookmarks
is generated and displayed so the reader can navigate through
the PDF output.
- Notes. Items with the style attribute
FLYOVER= are turned into PDF notes (also called annotations).
Because the bookmarks and notes aren't always desired, ODS provides a
way to turn them off:
- In SAS 8.1, the NOPDFNOTE option turns off both notes
and bookmarks.
- In SAS 8.2 and later, the NOPDFNOTE option only turns off notes.
(PDFNOTE is the default.)
The NOTOC option turns off bookmarks.
- In SAS 9.0 and later, BOOKMARKLIST= controls the display of bookmarks for a PDF file.
BOOKMARKGEN= controls the generation of bookmarks for a PDF file.
(If you set BOOKMARKGEN=NO, then the BOOKMARKLIST option is set to NO also.)
The NOTOC option is still supported; it behaves like BOOKMARKGEN=NO.
You can control the formatting of bookmarks in PDF similarly to the
CONTENTS file in ODS HTML, except you can't
use workarounds like
starting and ending comments.
The PROC TEMPLATE
FAQ provides a Table of Contents FAQ that discusses modifying the HTML contents, and it
might be a handy reference. Here is a quick guide to what
works in ODS PRINTER.
- The ODS PROCLABEL statement changes the label used for the procedure.
This is discussed in FAQ 3238.
- The CONTENTS=YES (alias ON) option
produces a Table of Contents page at the beginning of the PDF document. This is different from the bookmarks on the left.
CONTENTS= is experimental for SAS 9.1, 9.1.2, and 9.1.3 but should become production in a future release.
- The CONTENTS_LABEL attribute in the table template lets you change
the contents label for those tables that support it. There is a sample of code that uses this in
FAQ 3239.
- The DESCRIPTION= option on the action
statement of SAS/GRAPH procedures specifies the second-level entries
for bookmarks in PDF files. Note that specifying a null
value does not work as expected; see SAS Note 11888.
- More ODS PDF options are explained in the SAS online documentation.
Operating System and Release Information
*
For software releases that are not yet generally available, the Fixed
Release is the software release in which the problem is planned to be
fixed.
| Type: | Usage Note |
| Priority: | low |
| Topic: | System Administration ==> Printing Third Party ==> Output ==> PDF SAS Reference ==> ODS (Output Delivery System)
|
| Date Modified: | 2005-03-31 16:23:29 |
| Date Created: | 2004-10-06 12:11:41 |