Help:Create an external linkEdit This Page

From FamilySearch Wiki

What is an external link?

An external link is a link in FamilySearch Wiki article that sends users to another website outside of the FamilySearch Research Wiki. In other words, if users click on an external link, the link will send them to a different website, rather than to an article in the FamilySearch Research Wiki website. Links that send users to other articles in the FamilySearch Research Wiki website are known as internal links.

Links should not display the full URL

Many URLs (website addresses) are long and not reader-friendly. For readability's sake, links should not include the full URL of the destination page. There may be extremely rare instances where displaying the full URL is desirable, but this should be the exception, not the rule, and should be done only if there is a compelling reason.

Example 1: a link by itself

Correct: FamilySearch

Incorrect: http://www.familysearch.org/eng/default.asp

Example 2: a link in context

Correct: Order United States military records online.

Incorrect: Go to https://eservices.archives.gov/orderonline/start.swe?SWECmd=GotoView&SWEView=GPEA+Product+Detail+-+Features+View+FFO&SWEHo=eservices.archives.gov&SWETS=1199728061&SWEPostnApplet=GPEA+Product+Form

https://eservices.archives.gov/orderonline/start.swe?SWECmd=GotoView&SWEView=GPEA+Product+Detail+-+Features+View+FFO&SWEHo=eservices.archives.gov&SWETS=1199728061&SWEPostnApplet=GPEA+Product+Form to order United States military records online.

Click here to order United States military records online.

Clearly, the first link is much easier to read, takes less space, and helps users understand what they will find by clicking the link.

Full URLs don't improve printouts

One reason some wiki users give for displaying a Website's full URL is that it will make the article more helpful to users who print the article. However, modern Web browsers print the full URL of linked sites by default even if the full URL is not displayed onscreen. Therefore, displaying full URLs onscreen adds no value to printouts.

How to create an external link

1. Log into the FamilySearch Research Wiki.
2. Navigate to the page where you want to add the external link. Click "Edit" in the navigation bar page options. This will open the editing window.
3. In the editing window, type the text you want to create the link with. Remember, this should help the users understand what they will find by clicking on the link.
4. Using your mouse, position your cursor in front of the text you just typed. While holding down the left mouse button, drag the cursor across the text until it is highlighted.
   
5. On the editing toolbar, click the hyperlink icon. It looks like a tiny earth with two chain links in front of it.
   
6. After clicking the hyperlink icon, the "Link" window will open.
   
7. At the top of the "Link" window, locate the "Link" box. Here you will type or paste the url or website to which you want to link. The website must begin with "http://" or "https://" for the link to work correctly.
8. Once the correct url or website appears in the "Link" box, click "OK" to save the link in the editing window. 
9. The text that you highlighted in step 4 will now appear blue in the editing window.
10. Save your changes by scrolling down using the outside scroll-bar until you locate the "Save page" button located below the editing window.
11. After clicking "Save page," you will be able to click on the newly created link to another website. NOTE: If the link appears red on the page, website was typed in incorrectly. Repeat the steps above, paying close attention to step 7.

Other Helpful Hints:

• To link to another website, the url, or website address must match exactly. If there are any differences, the link will appear red on the page, and will not direct users to the intended website.
• If the website was entered correctly in the "Link" box, the link will be blue.

To create an external link using Wikitext

1. Type a single right-facing square bracket [
2. Type or paste the url or website immediately after the single square bracket, without leaving a space between the bracket and the first letter or symbol of the url (website address). Remember, the url MUST begin with "http://" or "https://"
3. If you want the url visible on the page, skip to step 5. If you want the url masked on the page, continue with step 4.
4. After typing or pasting the exact url (website address) you are linking to, hit the spacebar once, and then type the text that you want to appear as the link on the page.
5. Next type a single, left-facing square bracket ] without leaving a space between the bracket and the last letter or symbol of the url or text.

Example:

[http://www.familysearch.org FamilySearch]

The text above will appear as:FamilySearch even though the actual website url is "http://www.familysearch.org."

Tips

In the URL, include the http:// or the link will not work.

To edit existing links to websites, follow the same steps above.

Other links

Internal Websites

• For links within the Research Wiki, see Create an internal link

Family History Library Catalog (FHLC) Links

• Instructions for using the {{FHL}} template for creating links to the Family History Library Catalog.

Record Search Links

• Instructions for using the {{RecordSearch}} template for creating links to [Historical Record Collections Record Search].

WorldCat/OCLC Links

• Instructions for using the {{WorldCat}} template for creating links to the English-language WorldCat/OCLC catalog.

Wikipedia Links

• Instructions for using the {{Wikipedia}} template for creating interwiki links to articles in the English-language Wikipedia.