Linking

Overview

Steelkilt makes linking the following easy:

  • Documents
  • Chapters
  • Part title pages
  • Images
  • Resources

Buttons

The Link Chooser has one button:

ButtonPurpose
Link button (see below)

Linking Documents, Chapters, Parts and Resources with Text Editor

To add links to Documents, Chapters, Parts and Resources to your text:

  • Open a Document or Chapter
  • Move the cursor to the place where you want to insert the link
  • Tap the Tools button on the toolbar
  • Choose Insert Link… from the menu
  • Use Link Chooser to select a Document, Chapter, Part or Resource
  • Tap the Link button

Link Markup

For Documents and Chapters with Use Markdown switched on in Document and Chapter Settings, links are represented by Markdown link directives, using a unique identifier to reference the Document, Chapter or Part.

For Documents and Chapters with Use Markdown switched off in Document and Chapter Settings, links are represented by HTML <a> elements containing a reference to the XHTML Resource representing the target Document, Chapter or Part.

Warning

Using <a> elements to link Documents, Chapters and Parts is not recommended. Such links will not be automatically updated if you restructure the contents of your Book.

Read the following for more information:

Linking Images with Text Editor

Use Image Chooser for linking images in Text Editor

Linking Resources with Code Editor

To add links to text-based Resources (such as XHTML documents):

  • Open a text-based Resource
  • Move the cursor to the place where you want to insert the link
  • Tap the Tools button on the toolbar
  • Choose Insert Link… from the menu
  • Use Link Chooser to select a Resource
  • Tap the Link button

Link Chooser is not available for Resources that do not accept <a> elements, such as OPF files and container.xml.

The Resources that are made available in Link Chooser will depend on the destination Resource type.