Linking

Overview

Steelkilt makes linking the following easy:

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

Linking Documents, Chapters and Parts with Text Editor

To link Documents and Chapters:

  • Drag a Document or Chapter from Project Navigator into the text of another Document or Chapter
  • Use the Autocompletion Menu in Text Editor

To link Part title pages:

  • Drag a Part folder from Project Navigator into the text of a Document or Chapter
  • Use the Autocompletion Menu in Text Editor

Linking Resources with Text Editor

To link Resources (such as XHTML documents representing custom Resources):

  • Use the Autocompletion Menu in Text Editor

Link Markup

For Documents and Chapters with Use Markdown checked 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 unchecked 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 link Resources within Code Editor:

  • Drag a Resource from Project Navigator into the HTML code belonging to an XHTML-based Resource
  • Use the Autocompletion Menu in Code Editor

Note

Dragging a Resource into the text or code associated with a non-XHTML-based Resource will do nothing.

Read the following for more information: