Adding Links

It is possible to type HTML tags directly into most of the Hot Potatoes text boxes, in order to insert links to other files into the Web pages. However, if you want to insert a link, you can use one of the built-in functions to help you. You can use these link functions to add sound and video to your pages -- see Adding sound and video for more information on this.

To insert a link to a file that will be on the same website as the page

First, save your data file. Hot Potatoes needs to know where your data is saved to calculate the path from your page to the linked file.

Click in the textfield where you want to insert the link.

Choose Local File from the Insert menu. The following window appears:

The link text contains any text you selected before choosing to insert a link. Any changes you make in this box will be written back into the textbox.

Type, copy and paste, or browse for the file you want to make the link to.

The target box allows you to specify where you want the linked page to appear. The safest option is to have the linked file open in a new window. You may type in the target if you know it, or choose one of the following by clicking on the Target button:

This choice Puts this into target box
default {nothing} usually results in page being replaced
replace this page _self

open in new window
_blank
replace this frameset _parent
replace everything _top

Click on the Insert button to insert the tag for that link.

To insert a link to a URL

First, ensure that you are entitled to include a link from your site to the intended file and that you credit the source appropriately.

Click in the textfield where you want to insert the link code.

Choose Page on Web from the Insert menu. The following window appears:

Type, or copy and paste, the URL into the URL box, change the other settings appropriately.

Details on how to use the target button and field are mentioned just above.

Click on the Insert button to insert the tag for that link.

Details on the features in these windows

Link text

This is the text that will become the link on your Web page. You might want to use a graphic as the link, so there is a button below the text box to enable you to choose a picture. If you selected text before choosing Insert Link, then the selected text will appear here.

File (local link only)

Type, or copy and paste, the name of the file here. Hot Potatoes assumes that you will save your web pages in the same folder as your data file, and calculates the path between your pages and linked files accordingly. If you do not intend to put your HTML pages in the same folder as your data file, or if the linked files will be in a different place relative to the pages on the server than they are on your computer, then you will need to configure the relative path manually to ensure that the link works on your page. This will be much easier if you understand basic HTML.

Browse button (local link only)

Use this button to select the file that you want to link to (which will appear in the File box).

URL

Type, or copy and paste, the URL of the file you want to link to here.

Target

This specifies where the page linked to will appear. You can type anything you want into here, or you can choose from these items in the drop-down list:

_blank will make the file appear in a new window, leaving the exercise intact in the old window.

_self will make the file replace the exercise. In the case of V3 output, this will leave the top (feedback) frame intact.

_parent will replace the frameset containing the exercise. In the case of a V3 output file, this will replace the entire exercise.

_top will replace the entire frameset, so if your exercise is inside a larger frameset, then the whole thing will be replaced by the new file.

If you find this confusing, then the best option is probably _blank; if you choose this, then you can be sure the exercise (and the student's work) will not be lost. If you know HTML, you can also type in the names of any of the frames in your document -- FeedbackFrame, for example, would cause the file to display in the top (feedback) frame of a V3 exercise.

Insert button

Once you have chosen the file you want, you can press OK to insert the appropriate code for the link into the Hot Potato text box.


List of Topics