Creating links in content

Link text needs to be meaningful and relavant enough to make sense when read out of context.  Take a look at the following sentence - the link text is in bold:   "Click here to view a video about subject xyz".  If we take the link text "Click here" out of context it tells us very little.  We don't know what it is about, where it will go, if its a document, etc.  

The only thing we could deduce is that it is a link.

A better option for the link text would be to change it to (link text in bold): "View a video about subject xyz".

Link Text Guidelines

Good links are descriptive, succinct and unique.  Link text must make sense out of context. Some general guidelines for link text creation are as follows:

  • Do not describe the mechanism behind following a link.  Examples of what not to do
    • Click here
    • hit this button
    • click on this
  • Write clear, descriptive text - it needs to make sense out of context.
  • Use the minimum amount of text to let the user understand what the link is about
  • Provide enough information about the destination of a link to prevent unpleasant surprises for vistors
    • if a link is not another web page but to a document let our visitor know by including the type of document, e.g. [pdf], [doc], [ppt]
  • Make sure multiple links going to different pages do not have the same link text. Repeating link text makes if very hard for individuals to discern which link is going where
Useful Link Text
Bad Link Text Good Replacement
Click here for more information Learn more about [subject]
To send us an email, click here Send us an email
Vist the Admissions website Vist the Admissions website
The grant application can be completed here Complete your grant application
Go to CNN to learn more Go to CNN to learn more
   

How To Add A Link To Body Copy

  • Highlight the text you want as your link text.  If the link is a document be sure to include they type of document as part of the link, e.g. 2014-15 Swarthmore Financial Aid Request form [pdf]
  • Once the link text is chosen, the "chains" in the web editor become available.  Use the unbroken chain to create a link, and the broken chain to break a link.
    Use the "chain" icon to create a link
  • There are several types of link: internal Swarthmore pages which "live in Drupal, e-mail links, Links to an section of a page (called an anchor) and documents and external URL's When you create a link a small window opens.  The first step is to choose the type of link.
    • If you are linking to a Swarthmore page choose that option and start typing the page title in the Link box
    • if you are linking to an e-mail choose that option and paste the e-mail address and add a subject if you'd like
    • if you are linking to an page outside of our main site (e.g. CNN, Acalog, NPR) choose URL or link to document and paste the full web address of the site you are linking to.  If it is a non-Swarthmore page use the Target tab and choose New Window 
    • if you are linking to a document choose URL or link to document  and then "Browse documents" to open the file finder (more how to detail about document links)

Choose URL or link to Document from dropdown, then enter the URL in the field next to http://

 

Gathering the data for Inserting or Editing a Link

  • Link URL
    • I find it helpful to have another browser window open to the page you want to link to, whether it is internal (starts with http://www.swarthmore.edu) or a link outside of Swarthmore.   Simply copy the URL and paste it in this field
    • Email links:  add mailto: in front of the e-mail address e.g.  mailto: somone@swarthmore.edu
  • Target
    • For internal links (those starting with http://www.swarthmore.edu) choose "Open Link in the Same Window"
    • For external links choose "Open Link in a New Window"
  • Title
    • If the link text doesn't make sense when taken out of content, use this field help our visitors understand what the link is going to do
    • Useful to alert visitors when a link opens a new window, a document, or is an email link.

How To Add A Link To A Document

  • Highlight the text you want as your link text.  If the link is a document be sure to include they type of document as part of the link, e.g. 2014-15 Swarthmore Financial Aid Request form [pdf]
  • Once the link text is chosen, the "chains" in the web editor become available.  Use the unbroken chain to create a link, and the broken chain to break a link.
    Use the "chain" icon to create a link
  • When you create a link a small window. Click the browse icon.
    Choose link to document, then browse to access the server
  • A new window will appear which allows you to upload new documents, view existing documents associated with your site and navigate to other directories.
  •  Use the UPLOAD button in the upper left corner to upload new documents, or select and existing document in the right menu. Then click the "INSERT" button.

    the upload button is located at the top left of the file manager window