HTML> View Handbook Link Cover Page of
The Mayfield Handbook of Technical & Scientific Writing
Table of ContentsWriting TimelineIndexHelpCredits

Help: Appendix C

View Handbook Link

No reference link selected (Windows / Macintosh) Windows and Macintosh message: It appears that no reference link to the Handbook is selected in your "<word processor>" document. Please make sure that you have selected or placed your cursor on a reference link which will be demarcated by ## on either side.

In order to view a Handbook link, the actual link must be specified. You can do this by placing the cursor anywhere within the ## delimiters. However, selecting the entire link will always produce the fastest results.

Action:

  1. Return to the word processing document in which the link has been inserted.
  2. Select the entire link by highlighting the reference, including the ## delimiters.
  3. Run View Handbook Link again.
Reference link not recognized (Windows / Macintosh) Windows and Macintosh message: The reference link that you have selected "<incorrect link>" is not recognized by the Handbook.

The most likely reason for this error is that the reference link has inadvertently been edited. Attempt to restore the link to the correct link text, and try again. If the Handbook was installed on the hard drive and you receive this message often, the link almost surely has been inadvertently changed.

Action:

TIP: Since a reference link is not write-protected within a word processing document, it is possible to edit the link, making it invalid.

    Example: ## Paragraphs ## was inserted into your document, but while you were reading your document, this link was inadvertently edited and now reads ## ParaThegraphs ##. This corrupted link does not refer to any page within the Handbook.

    Example: ## Paragraphs ## has been inserted into your document, but while you were reading your document, this link was inadvertently edited and now reads ## Paragraphs.

    In either instance, if you know what the link is supposed to look like, you can simply edit the text within your word processor (in the first example, delete the intervening "The"; in the second example, add the "##" to the end of the link). If you do not know what the link is supposed to look like, you can always go to the Handbook directly, and use the index to scan for the words or topic you suppose the link referred to.

HTML file not found (Windows / Macintosh) Windows and Macintosh message: The Handbook page could not be opened because the file "name/path of file" could not be found.

If this error occurs often, it may be that the HTML files have been moved or deleted. If the files have simply been moved, then resetting the preferences should fix the problem.

Action:

    Windows: Run the Setup.exe program and choose the Modify Settings option. Make sure you correctly identify the installation location for the Handbook folder.
    Macintosh: Run Configure Mayfield. Click the Browse button in the Handbook Folder pane of the main window, and select the Handbook folder which contains the HTML files.
    If the problem is not simply locating the Handbook folder correctly, you will need to reinstall the Handbook. For installation instructions, see Installation for Windows in Chapter 2 or Installation for the Macintosh in Chapter 3.
Cannot open browser (Windows / Macintosh) Windows message: The Handbook cannot find a browser to open to the reference link you have selected. Please check that you have a browser properly installed on your machine.
Macintosh message: The application "<name/path of application>" could not be found. Please run "Configure Mayfield" to select a browser.

The first thing View Handbook Link does is to launch the browser. This error message will occur when the software cannot locate your browser. This mostly likely happens for one of two reasons:

Action:

  1. Make sure that you have a compatible browser (Internet Explorer or Netscape Navigator) currently installed on your system and that you can launch and run it. If you cannot find your browser, locate the installation disks and reinstall it.
  2. If your browser runs successfully, then go back to the Handbook installation (see Installation for Windows in Chapter 2 or Installation for the Macintosh in Chapter 3).
  3. Windows: Run the Setup.exe program and choose Modify Settings. Be sure to select the right browser during installation.
    Macintosh: Run Configure Mayfield and be sure to select the appropriate browser.
Word processor not running (Macintosh) Macintosh message: Your word processor must be running in order for you to view a Handbook reference link. Please launch "<word processor>," open a document, and select the link for the Handbook page you wish to view.

In order to run View Handbook Link, your cursor must be placed on a reference link that has been inserted into a word processing document. This message will appear if you press the key combination (Command + Option + J) when a word processor is not currently running.

Action:

  1. Launch your word processor.
  2. Go to the word processing document that contains the reference link.
  3. Select the entire link, including the ## delimiters.
  4. Run View Handbook Link again.
No word processing document open (Windows / Macintosh) Windows and Macintosh message: There is no document open and therefore no link to the Handbook is selected. Please open a document in "<word processor>" and select the link for the Handbook page you wish to view.

This message will appear only when you are using Microsoft Word version 6.0 or later. In order to run View Handbook Link, your cursor must be placed on a reference link that has been inserted into a word processing document. This message will appear only if your word processor is running and you have attempted to run View Handbook Link using a key combination but no document window is open.

Action:

  1. Open your word processor.
  2. Open the document which contains the reference link.
  3. Select the entire reference link (including the ## delimiters).
  4. Run View Handbook Link again.

[ Home | Table of Contents | Writing Timeline | Index | Help | Credits]