====== Jumping between document locations ======

For the purposes of development, it is often useful (to the author) to link events in one location in the __Document__ pane to another, even if that other location is technically in another __Index Card__.

In order to do this, we can create a hyperlink (see adding Emphasis) to another, named internal location.

=== To create a target location: ===

  * Go to the position in the target Index Card required and enter a //unique// word or phrase that identifies this location. The text will not appear visually in the document pane.
  * Select the unique word or phrase and select the [Jump Target] option from the [Emphasis] menu. This will wrap the text in the @@ symbol, indicating that it is now a target.

=== To create the hyperlink to the target: ===

  * Go to the original location where you want the hyperlink to reside.
  * Enter the normal text that will represent the link - very often, this is normal text which would otherwise be simply read as part of the document.
  * Select the text, then the [Hyperlink] option from the [Emphasis] menu. This will wrap the text in a normal hyperlink tags - replace the link part of the tag with a hash (#) followed by the text used for the target.

----

===== For example: =====

We have written an historical text referring to the **Harrowing Of The North**. We want the initial mention of this phrase to link to a note in an appendix card at the end of the document.

=== Step 1 - Create the note in the appendix card ===

> //# The Harrowing Of The North **@@harrowing@@**//
>
> //The Harrowing of The North took place during the reign of William...//

Note that we have added the jump target to the end of the Header line, as all headers tags must be at the beginning of the line.

=== Step 2 - Make the initial mention into a hypertext link ===

> //While Jennifer drove around North Yorkshire and Durham, she occasionally heard the term **[The Harrowing of The North](#harrowing)**, which she had not encountered before...//

The term The Harrowing of The North will now jump to the appendix text when clicked.

//Note: If experimenting with this technique, ensure that your hyperlink and jump target are some distance apart in your document. If the two would naturally appear on the __Document__ pane on the same visible page in any case, no apparent movement will take place. A distinct, **obvious** jump to another location will only take place if the jump target is not currently displayed in the browser.//


----


{{:logo.png?nolink |}}\\
[[:start|Pergamon Wiki Home]]\\
[[LostPlot:home|LostPlot Home]]\\