iStudio Publisher icon

Hyperlinks

A hyperlink, or 'link', is an element in an electronic document that links to another location, or 'target', which can be opened by clicking with a mouse or tapping on a touchscreen.

Links can be added to text and shapes. Link targets can include external websites, email addresses, files, internal document pages (requires OS X 10.9 Mavericks or later), and custom URL schemes.

Adding links to an iStudio Publisher document is only useful when the document will be exported as PDF, EPUB, or RTF, and viewed electronically.

IMPORTANT: Choose menu option File > Export as PDF, or File > Export as Booklet PDF to create a PDF file with links added. Links won't be added to a PDF that is exported or saved by another option, including saving to PDF file via the Print dialog.

The presence of hyperlinks on text and shapes in an iStudio Publisher document is indicated by a light orange highlight, which can be toggled on/off by choosing menu option View > Links.

To add a hyperlink to text:

Either select some text, or insert the text cursor, where a link is to be added.

NOTE: Text hyperlinks are not allowed to span multiple paragraphs, but can include manual line breaks (which may entered via the key combination Shift-Return).

Choose menu option Edit > Add Link..., which is also available on the contextual menu. This displays the Link popover dialog, as shown here:

Link popover dialog

Choose the link target from the pop-up list. Here's the choice of link target types:

Web page

Internal document page (requires OS X 10.9 Mavericks or later)

Email

File

Custom

Complete the link target settings. For more information about how to do this for each type of link target see below.

Edit the display text, if required. A minimum of one character of display text is required.

Choose whether or not to apply Default Style settings to the link display text, by selecting or deselecting the Use checkbox. Change the default style color and effects (bold, italic, and underline), as required. A preview of the styled display text is shown in the Preview field.

NOTE 1: Any changes made to the default style settings are persisted automatically to the next time the Link popover dialog is opened, including the Use checkbox selection state.

NOTE 2: Style settings, and font, can be applied to link display text via the Character Inspector, either before or after the hyperlink is formed.

NOTE 3: Once a link is formed its display text becomes a single selectable item, and each character within the display text is given the same style, and font. The font is matched to either the first character of any selected text, or the font where the text cursor is inserted.

Click the Add button to add the new link.

To dismiss the Link popover dialog at any time, click the Cancel button (which retains any current text selection), or click outside the Link popover dialog (which deselects any text selection).

To add hyperlink(s) to shape(s):

Select one or more shapes to which links are to be added.

NOTE 1: If multiple shapes are selected, a separate link can be added to each selected shape, all at the same time. The click/tap area of each link will be a tight fit to its shape.

NOTE 2: If a group of shapes is selected, one link will be added to the whole group. The click/tap area will be a bounding box around the group.

Choose menu option Edit > Add Link..., which is also available on the contextual menu. This displays the Link popover dialog.

Choose the link target from the pop-up list. Here's the choice of link target types:

Web page

Internal document page (requires OS X 10.9 Mavericks or later)

Email

File

Custom

Complete the link target settings. For more information about how to do this for each type of link target see below.

Click the Add button to add the new link(s).

To set up a web page link target:

Choose Web Page from the Link Target pop-up list.

Enter the web page address in the URL field, either by typing or pasting it in, or by selecting a URL from the drop-down list. The URL drop-down list is pre-populated with web page link targets already used in the document.

To set up an internal document page link target:

Choose Internal Document Page from the Link Target pop-up list.

Click on the thumbnail of the target page to link to.

The link is set up to this particular target page, and will continue to link to this page even if the page number changes or the page is moved to a different position within the document.

NOTE: Linking to internal document pages is only available on OS X 10.9 Mavericks or later.

To set up an email link target:

Choose Email from the Link Target pop-up list.

Enter the email address in the Address field, either by typing or pasting it in, or by selecting an Address from the drop-down list. The Address drop-down list is pre-populated with email address link targets already used in the document.

Enter the email subject in the Subject field.

To set up a file link target:

Choose File from the Link Target pop-up list.

Enter the file address in the URL field, either by typing or pasting it in, or by selecting a URL from the drop-down list. The URL drop-down list is pre-populated with the file addresses already used in the document.

The "correct" link format is file:/// (3 forward slashes) followed by the path to the file, using forward slashes throughout. Embedded spaces must be encoded as %20. Here are two examples:

file:///Users/john/Desktop/file

file:///Users/janet/Documents/folder%20with%20spaces/file%20with%20spaces

TIP: To create a correctly formatted URL address string use Finder to drag the file onto the URL field of a web browser. If the browser can open the file it will also add the file address to its URL field, which you can then copy and paste into iStudio Publisher.

IMPORTANT: Links to PDF files are widely supported in most PDF readers, but links to other file types may have mixed support. For example, Preview does not currently support linking to image files.

To set up a custom link target:

Choose Custom from the Link Target pop-up list.

Enter the custom URL in the URL field, either by typing or pasting it in, or by selecting a URL from the drop-down list. The URL drop-down list is pre-populated with custom URLs already used in the document.

Different apps may have their own custom URL scheme that you can link to. For example, here's a custom link that will open the Messages app on a Mac computer and initiate a new iMessage conversation to your Apple ID:

imessage://your@appleid.com

Replace “your@appleid.com” with your own Apple ID that is configured to use with the Messages app.

IMPORTANT: Custom links may not be supported in some PDF readers, including Preview.

To test hyperlink(s):

Select the text or shape(s) containing the link(s).

NOTE: Multiple links, across multiple paragraphs of text, or on multiple shapes can be selected and tested at the same time if all of the links are identical. If multiple, non-identical links are selected the option to test will be disabled.

Choose menu option Edit > Test Link, which is also available on the contextual menu. This performs the same action as will occur when following the link in the exported document.

NOTE: The "Test Link" menu item label may change to reflect the link target. For example, for a link to a web page the menu item wording is changed to "Open Link in Browser".

IMPORTANT: Links to PDF files are widely supported in most PDF readers, but links to other file types and custom links may have mixed support. A successful link test does not guarantee these link types will work correctly in all PDF readers.

To edit hyperlink(s):

Select the text or shape(s) containing the link(s).

NOTE 1: Multiple links, if all within one paragraph of text, can be selected and edited at the same time. The result will be a single, combined hyperlink. To keep existing individual links separate it is necessary to select and edit them one at a time.

NOTE 2: Multiple links, on multiple shapes, can be selected and edited at the same time.

Follow the same instructions as for adding hyperlinks, although note that the menu option has changed to Edit > Edit Link..., which is also available on the contextual menu.

If you have changed any of the Default Style settings since creating a link, and want to keep it's existing (non-default) style, untick the Use checkbox.

To remove hyperlink(s):

Select the text or shape(s) containing the links.

NOTE: Multiple links, across multiple paragraphs of text, or on multiple shapes can be selected and removed at the same time.

Choose menu option Edit > Remove Link(s), which is also available on the contextual menu.

Related Topics

About the Document Window

Printing and Exporting