Links, Anchors

Source:  Sam Knox tutorial at LearnPlone.org

What Are Anchors?

An anchor is a special kind of link that allows you to direct a user to a specific location in a page.  If you have a long page with information that is highly inter-related, it can be helpful to users to provide links that jump them directly to a related topic. This FAQ will help you to create and use anchors in your web pages.

Prepare the Destination Target

Open page. Click Edit. Type a word or phrase which will serve as the mooring destination spot on the page where you'd like your readers to land.

Place cursor immediately to the left of your destination point. Highlight the destination phrase, then give it a style chosen from the text formatting box (Heading, subheading, etc.). The destination phrase needs to be in some formatting style which lets it stand out from the rest of the text; otherwise the anchor function can't find it.

Mark the Destination Target

Highlight your destination phrase again. Click the Kupu anchor symbol, the 14th icon from the left.

In the Anchors box, find the highlighted tab on the left, "Link to Anchor." It should show the Kupu Text Formatting menu, displaying a choice of formats.

Click the style which matches the format of your destination text.

Now the middle panel should show all the phrases in your document which match this style. Find and click the radio button showing your destination text.

Click OK.

On your page, a copy of the destination phrase (highlighted as hypertext) should appear after your cursor. Save.

Create an Origin Label

At the spot where you want to flag the reader's attention and let him/her jump to the destination spot on this page, select the word or phrase which will serve as the flag letting them know they can jump elsewhere for more information. Highlight that word or phrase. In the Kupu bar, click the internal link (= chain) icon. You should see the usual internal link window open up. In the middle panel, choose the page with the destination spot. (It can be on the same page, or on any other page in the website). Click its radio button. This should open a Links, Anchor box in the right-hand panel, with a Link to Anchor drop-down menu. Its first choice will be Top of page (default), and the reader will "land" at the top of the page where you placed the destination anchor. But if you click the menu, it will also display the item Fetching Anchors. If you click this, you should be able to select the phrase that you prepared as the destination point. Click OK, then Save.

Test your anchor: go to the page with the origin text, click it, and see where it takes you. (When I just tried it, clicking the origin text jumped me to the page with the destination anchor, and clicking the destination anchor link moved that link to the top of the page.)

Note: If your page is so long that you need anchors, we recommend that you explore breaking up the material into separate pages.

Also, how about using the FAQ linked here ( create a table of contents ) for your page? Those are considerably easier to create than anchors, and the reader can look at the T of C and click its links to move up and down the page.

Breaking any Link

If you have inserted an anchor or any other kind of link to your webpage, to break the connection to the linked content,

  • Choose Edit mode
  • Look at your hyperlink; click anywhere on the text or image which you highlighted to create the link;
  • see the tiny red "X" appearing at the far right of the Kupu editing green-frame (see screen shot below);
FAQs Break Link Red X
  • click on this "X," and hit Save. Now you should be in View mode, and you should be unable to open anything with this link. The hypertext line underneath the marker text should have disappeared.
  • Note: Why not just delete the hypertext phrase? Because in some cases this will leave the link floating around unbroken. Also, using the red X is a good habit to form because in many cases you will want to keep the original label phrase rather than retyping the whole thing again.
Document Actions