Help:Create an external link

From FamilySearch Wiki

(Difference between revisions)
m (moved quick reference to "advanced linking" page)
(Update Template)
(32 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{how-to-articles}}  
+
{{Help article}}  
  
=== What is an external link?  ===
+
{{Quick reference|
 +
*The blue globe/earth icon [[Image:Globe (internal linking).jpg|28x23px]] with the two chain links looped together on the toolbar is used for external linking.
 +
|float=right
 +
|width=40%
 +
}}
  
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 [[Create an internal link|internal links]].
+
{| cellspacing="1" cellpadding="1" border="0" align="left" width="50%"
 +
|-
 +
| __TOC__
 +
|}
  
=== Links should not display the full URL  ===
+
<br><br><br><br><br><br><br><br>
  
Many URLs (website addresses) are long and not&nbsp;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.<br>
+
*Watch a [https://help.familysearch.org/kb/tutorials/en/fsdemos/FS_index.html?v=https://help.familysearch.org/kb/tutorials/en/fsdemos/WikiLinks video demonstration] of how to create links.
  
==== Example 1: a link by itself ====
+
=== What is an external link? ===
  
'''Correct:''' [http://www.familysearch.org/eng/default.asp FamilySearch]  
+
An external link is a link in a 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 [[Create an internal link|internal links]].
  
'''Incorrect:''' [http://www.familysearch.org/eng/default.asp http://www.familysearch.org/eng/default.asp]
+
=== How to create an external link  ===
  
===== Example 2: a link in context  =====
+
To create external links using the "Standard Editor", see [[Help:Advanced Linking#How_to_create_an_external_link_using_Wikitext|How to create an external link using Wikitext]].
  
'''Correct:''' [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 Order United States military records] online.
+
#Log in to the FamilySearch&nbsp;Research&nbsp;Wiki.  
 
+
#Navigate to the page where you want to add the external link. Click '''Edit '''in the navigation bar page options. This will&nbsp;open the editing window.  
'''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&amp;SWEView=GPEA+Product+Detail+-+Features+View+FFO&amp;SWEHo=eservices.archives.gov&amp;SWETS=1199728061&amp;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 https://eservices.archives.gov/orderonline/start.swe?SWECmd=GotoView&amp;SWEView=GPEA+Product+Detail+-+Features+View+FFO&amp;SWEHo=eservices.archives.gov&amp;SWETS=1199728061&amp;SWEPostnApplet=GPEA+Product+Form] to order United States military records online.
+
 
+
[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 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 do ''NOT'' 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  ==
+
 
+
#Log into the FamilySearch&nbsp;Research&nbsp;Wiki.  
+
#Navigate to the page where you want to add the external link. Click "'''Edit" '''in the navigation bar page options. This will&nbsp;open the editing window.  
+
 
#In the editing window,&nbsp;type the text you want to create the link with. Remember, this&nbsp;should help the users understand what they&nbsp;will find by clicking on the link.  
 
#In the editing window,&nbsp;type the text you want to create the link with. Remember, this&nbsp;should help the users understand what they&nbsp;will find by clicking on the link.  
#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. [[Image:HighlightTextEditor.png|border|center|350px]]  
+
#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. [[Image:HighlightTextEditor.png|border|center|350px|HighlightTextEditor.png]]  
#On the editing toolbar, click the hyperlink icon. It looks like a tiny earth with two chain links in front of it.[[Image:HighlightTextEditorhyperlink.png|border|center|350px]]  
+
#On the editing toolbar, click the hyperlink icon. It looks like a tiny globe/earth with two chain links in front of it.[[Image:HighlightTextEditorhyperlink.png|border|center|350px|HighlightTextEditorhyperlink.png]]  
#After clicking the hyperlink icon, the "Link" window will open.[[Image:LinkLinkWindow.png|border|center|300px]]  
+
#After clicking the hyperlink icon, the "Link" window will open.[[Image:LinkLinkWindow.png|border|center|300px|LinkLinkWindow.png]]  
 
#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.  
 
#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.  
#Once the correct&nbsp;url or website&nbsp;appears in the "Link" box, click "OK" to save the link in the editing window.&nbsp;  
+
#Once the correct&nbsp;url or website&nbsp;appears in the "Link" box, click '''OK''' to save the link in the editing window.&nbsp;  
 
#The text that you highlighted in step 4 will now appear blue in the editing window.  
 
#The text that you highlighted in step 4 will now appear blue in the editing window.  
#Save your changes by scrolling down using the outside scroll-bar until you locate the "Save page" button located below the editing window.  
+
#Save your changes by scrolling down using the outside scroll-bar until you locate the '''Save page''' button located below the editing window.  
#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,&nbsp;website was typed in incorrectly. Repeat the steps above, paying close attention to step 7.
+
#After clicking '''Save page''', you will be able to click on the newly created link to another website.
 
+
<u>'''Other Helpful Hints:'''</u><br>
+
 
+
*To link to another website, the&nbsp;url, or website address&nbsp;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  ==
+
 
+
#Type&nbsp;a single&nbsp;right-facing square bracket '''['''
+
#Type or paste the url or website&nbsp;immediately after the single&nbsp;square bracket, without leaving a space between the bracket and the first letter or symbol of the url (website address).&nbsp;Remember, the url MUST begin with "http://"&nbsp;or "https://"
+
#If you want the url visible&nbsp;on the page, skip to step 5. If you want the&nbsp;url masked&nbsp;on the page, continue with step 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.
+
#Next type&nbsp;a single, left-facing&nbsp;square bracket ''']''' without leaving a space between the bracket and the last letter&nbsp;or symbol of the url&nbsp;or text.
+
 
+
'''Example:'''
+
 
+
:<nowiki>[http://www.familysearch.org FamilySearch]</nowiki>
+
 
+
The text above will appear as:[http://www.familysearch.org 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]]
+
:{{Note|NOTE: If the link does not work, then it was typed in incorrectly. Unlike internal links which display a red link when a page does not exist, external links will display a blue link even though the link is incorrect. Repeat the steps above, paying close attention to step 7. '''Check to see''' that your link includes '''http:// or https://''' at the beginning of the link.<br>}}
  
=== Family History Library Catalog (FHLC) Links ===
+
=== Creating links using templates ===
  
*Instructions for using the {{tl|FHL}} template for creating links to the Family History Library Catalog.
+
#Open the editor and place your cursor where you want to add the template link.<br><br>
 +
#Click on the '''<nowiki>{T}</nowiki>''' icon in the editor's toolbar. This will open the Template editor window.<br><br>[[Image:RichEditorTemplateText.jpg]]<br><br>
 +
#Type two left curly braces '''<nowiki>{{</nowiki>''', followed by the template name and parameters with the pipe symbol '''<nowiki>|</nowiki>''' separating the name and parameters, followed by two right curly braces '''<nowiki>}}</nowiki>'''.<br><br>
 +
#Click OK to finish setting up the template.<br>[[Image:Template Properties Text.png]]<br><br>
  
=== Record Search Links  ===
+
::This example uses the Wikipedia Template {{tl|Wpd}} and adds optional link text parameter. The result for this template entry is "See also {{Wpd|History of Pennsylvania|Pennsylvania History}}"<br>In the rich editor, templates appear as [[Image:TemplateSymbolInRichEditor.png]].
  
*Instructions for using the {{tl|RecordSearch}} template for creating links to [{{RecordSearch}} Record Search].
+
<br> For a list of some external link templates see [[Help:Advanced Linking#Creating_Links_Using_Templates|Advanced Linking]].  
  
=== WorldCat/OCLC Links  ===
+
{{Contributor Help badge
 +
| link = https://familysearch.org/ask/
 +
| name = Get Help}}
  
*Instructions for using the {{tl|WorldCat}} template for creating links to the English-language [http://www.WorldCat.org WorldCat/OCLC] catalog.
+
=== See also  ===
  
=== Wikipedia Links  ===
+
*[[Help:Create an internal link|Creating an internal link]]
  
*Instructions for using the {{tl|Wikipedia}} template for creating interwiki links to articles in the English-language [[wikipedia:Wikipedia|Wikipedia]].
+
{{Contributor help-navbox}} {{Editing help}}  
  
 
[[Category:Help]]
 
[[Category:Help]]

Revision as of 06:42, 16 July 2013

Help-content.png This help article will guide you as you edit in the Wiki. See Contributor Help for more help articles.


Contents









What is an external link?

An external link is a link in a 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.

How to create an external link

To create external links using the "Standard Editor", see How to create an external link using Wikitext.

  1. Log in to 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.
    HighlightTextEditor.png
  5. On the editing toolbar, click the hyperlink icon. It looks like a tiny globe/earth with two chain links in front of it.
    HighlightTextEditorhyperlink.png
  6. After clicking the hyperlink icon, the "Link" window will open.
    LinkLinkWindow.png
  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.

Creating links using templates

  1. Open the editor and place your cursor where you want to add the template link.

  2. Click on the {T} icon in the editor's toolbar. This will open the Template editor window.

    RichEditorTemplateText.jpg

  3. Type two left curly braces {{, followed by the template name and parameters with the pipe symbol | separating the name and parameters, followed by two right curly braces }}.

  4. Click OK to finish setting up the template.
    Template Properties Text.png

This example uses the Wikipedia Template {{Wpd}} and adds optional link text parameter. The result for this template entry is "See also Pennsylvania History"
In the rich editor, templates appear as TemplateSymbolInRichEditor.png.


For a list of some external link templates see Advanced Linking.

Help-content.png Questions?
Visit the Get Help to receive help with contributing to the Wiki.


See also