Help:Links

From FamilySearch Wiki

(Difference between revisions)
(Creating links)
(27 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{PD Help Page}}  
+
{{Help article}}  
  
{{Help article}}
+
__TOC__
  
 +
=== Types of links ===
  
There are four sorts of links in MediaWiki:  
+
There are four types of links:
  
#'''[[#Internal_links|internal links]]''' to other pages in the wiki  
+
#[[#Creating links|Internal links]] to other pages in the wiki.  These links pertain only to the Wiki.  They do not include any other FamilySearch sites.
#'''[[#External_links|external links]]''' to other websites  
+
#[[#Creating links|External links]] to other websites, inlcuding other FamilySearch sites
#'''[[#Interwiki_links|interwiki links]]''' to other websites registered to the wiki in advance  
+
#[[Help:Advanced Linking#Interwiki Links|Interwiki links]] to other websites registered to the wiki in advance  
#'''[[#Interlanguage_links|Interlanguage links]]''' to other websites registered as other language versions of the wiki
+
#[[Help:Advanced Linking#Interlanguage Links|Interlanguage links]] to other websites registered as other language versions of the wiki
  
== Internal links ==
+
=== Creating links ===
  
To add an internal link, enclose the name of the page you want to link to in double square brackets. When you save the page, you'll see the new link pointing to your page. If the page exists already it is displayed in blue, if it does not, in red. Selflinks to the current page are not transformed in URLs but displayed in bold. (If you really want to link to the current page, use an anchor (see below), or <nowiki>[[#top|current page]]</nowiki> which always links to the top.)
+
The FamilySearch Wiki uses two types of editors to create and edit pages:
  
The first letter of the target page is automatically capitalized, unless otherwise set by the admins, and spaces are represented as underscores (typing an underscore in the link will have a similar effect as typing a space, but is not recommended, since the underscore will also be shown in the text).  
+
1. The '''Rich Editor''' has a toolbar similar to many word processors.
  
{| class="wikitable" border="1"
+
::[[Image:RichEditor.jpg|500px|RichEditor.jpg]]
|-
+
! Description
+
! You type
+
! You get
+
|-
+
| Internal link
+
| <pre>[[Main Page]]</pre>
+
| [[Main Page]]
+
|-
+
| Piped link
+
| <pre>[[Main Page|different text]]</pre>
+
| [[Main Page|different text]]
+
|-
+
| Shortened sort-of-piped link
+
| <pre>[[Internationalisation]]s</pre>
+
| [[Internationalisation]]s
+
|-
+
| Redirect
+
| <pre>#REDIRECT [[Main Page]]</pre>
+
See also [[Help:Redirects]]
+
  
| → [[Main Page]]
+
::To switch to the Standard Editor, click on <nowiki>[Disable rich editor]</nowiki>.
|-
+
| Internal link to an anchor
+
| <pre>[[#See also]]</pre>
+
[[Help:Formatting|Section headings]] and the [[#top|top]] of the page are automatically anchored.
+
  
| [[#See_also]]
 
|-
 
| Internal link to an anchor at another page
 
| <pre>[[Help:Images#See also]]</pre>
 
| [[Help:Images#See_also]]
 
|-
 
| Internal link to the current page's talk page
 
| <pre>[[{{TALKPAGENAME}}|Discussion]]</pre>
 
See also [[Help:Magic words#Page_names]]
 
  
| [[{{TALKPAGENAME}}|Discussion]]
+
:If you are using the Rich Editor, See [[Help:Create an internal link]] and [[Help:Create an external link]] for step by step instructions on how to add links to a page.
|-
+
| Internal link to a subpage
+
| <pre>[[/example]]</pre>
+
Shortcut for <nowiki>[[Help:Links/example]]</nowiki>. See also [[Help:Subpages]].
+
  
| [[/example]]
 
|-
 
| Internal link to a category page
 
| <pre>[[:Category:Help]]</pre>
 
See also [[Help:Categories]]
 
  
| [[:Category:Help]]
+
2. The '''Standard Editor''' works in Wikitext and its limited tools help you edit a page.
|-
+
| Internal link to an image or a file of other types
+
| <pre>[[media:example.jpg]]
+
  
[[media:example.pdf]]</pre>
+
::[[Image:StandardEditor.jpg|500px|StandardEditor.jpg]]
See also [[Help:Images]]
+
  
| [[Media:Example.jpg]]
+
::To switch to the Rich Editor, click on <nowiki>[Rich Editor]</nowiki>.<br><br>
[[Media:Example.pdf]]
+
  
|}
+
:See [[Help:Advanced Linking|Advanced Linking]] for instructions on how to create links using the "Standard Editor" and Wikitext.
  
== External links  ==
+
=== FAQ - Frequently Asked Questions ===
  
{| class="wikitable" border="1"
+
'''How do I edit a link?'''
|-
+
! style="width: 15%" | Description
+
! style="width: 45%" | You type
+
! style="width: 40%" | You get
+
|-
+
| External link  
+
| <pre>http://mediawiki.org</pre>
+
| http://mediawiki.org
+
|-
+
| External link with different label
+
| <pre>[http://mediawiki.org MediaWiki]</pre>
+
| [http://mediawiki.org MediaWiki]
+
|-
+
| External link numbered
+
| <pre>[http://mediawiki.org]</pre>
+
| [http://mediawiki.org]
+
|-
+
| External link icons
+
| <pre>[http://en.wikipedia.org/wiki/.avi video]
+
[http://en.wikipedia.org/wiki/.wav sound]
+
[http://en.wikipedia.org/wiki/.pdf document]
+
</pre>
+
External link icons may differ depending on the file type of the target.
+
  
|
+
Links to both internal FamilySearch Wiki pages and external internet pages can and often do change.  
[http://en.wikipedia.org/wiki/.avi video] [http://en.wikipedia.org/wiki/.wav sound] [http://en.wikipedia.org/wiki/.pdf document]
+
  
|-
+
*In the Standard Editor, type the new page, internet link address, or template text over the old material.
| External link to the same host
+
*In the Rich Editor, place your cursor over the link text and click the the blue globe/earth icon with an unbroken chain [[Image:LinkGlobe.jpg|20x20px|text-bottom]] on the toolbar. Then replace the page title or internet address link with the correct link.  
| <pre>[http://{{SERVERNAME}}/pagename]</pre>
+
*If you are editing a template in the Rich Editor, highlight the template [[Image:TemplateSymbolInRichEditor.png]] and click on the template '''<nowiki>{T}</nowiki>''' icon on the toolbar. Then edit the template text.
| [http://{{SERVERNAME}}/pagename]
+
|-
+
| External link to other host passing the pagename
+
| <pre>[http://google.com/search?q={{PAGENAMEE}}]</pre>
+
| [http://google.com/search?q={{PAGENAMEE}}]
+
|-
+
| Mailto link  
+
| <pre>[mailto:info@example.org email me]</pre>
+
| [mailto:info@example.org email me]
+
|-
+
| Mailto named with subject line and body
+
| <pre>[mailto:info@example.org?Subject=URL%20Encoded%20Subject&amp;body=Body%20Text info]</pre>
+
| [mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info]
+
|}
+
  
{{admin tip|tip=
+
Don't forget to summarize what you have done so others know the change you've made.
Which protocols (like http:) are allowed for links is controlled by the {{mediawiki|Manual:$wgUrlProtocols|$wgUrlProtocols}}<!--Should these admin tips even be here? This is supposed to be end user help is it not? --> setting.
+
}} {{admin tip|tip=
+
To remove the “external link icons“ from next to each of the external links, add the following to the page located at <code>MediaWiki:Monobook.css</code> on your wiki.
+
  
<source lang="css">
+
'''Does the text on the page need to match the title of the linked page?'''
#bodyContent a.external,
+
#bodyContent a[href ^="gopher://"] {
+
background: none;
+
padding-right: 0;
+
}
+
</source>
+
}}
+
  
=== How to avoid auto-links ===
+
It is not required , but the linking text should clearly convey the content of the linked page to the researcher and may 1) expand on the title of the linked page, 2) be more concise and 3) external links, which should always use linking text in place of the full internet <nowiki>http://</nowiki> address.<br>
  
By default, when you write a URL as is, it will be transformed to an external link.
+
Example 1:
  
To avoid that effect, put the URL between <code>&lt;nowiki&gt;</code> tags as in:  
+
Page Title: Mennonites
 +
Linking Text: Researching Mennonite Records
 +
 
 +
Example 2:
 +
 
 +
Page Title: Pennsylvania Biography
 +
Linking Text: Biographies
 +
 
 +
Example 3:
 +
 
 +
Page URL: <nowiki>http://www.classbrain.com/artstate/publish/article_561.shtml</nowiki>
 +
Linking Text: Famous Pennsylvanians
 +
 
 +
 
 +
'''How do I avoid making a Link?'''
 +
 
 +
Generally, when you type an URL address (with the <nowiki>http://</nowiki>), it will be transformed to an external link. To avoid making a link, put the URL address between <code>&lt;nowiki&gt;</code> tags in the Standard Editor:  
  
 
  <nowiki><nowiki>http://mediawiki.org</nowiki>&lt;/nowiki&gt;
 
  <nowiki><nowiki>http://mediawiki.org</nowiki>&lt;/nowiki&gt;
  
== Interwiki links  ==
 
  
Interwiki links are links with the internal link markup to a website registered in advance. For example, you can link to the Sunflower article on http://en.wikipedia.org by typing <code><nowiki>[[wikipedia:Sunflower]]</nowiki></code>, which will result in a link [[wikipedia:Sunflower|RTENOTITLE]]. This is because <code><nowiki>http://en.wikipedia.org/wiki/</nowiki></code> is registered to your wiki by default with the prefix of <code>wikipedia</code>. ''This link may not work properly, if the admin of your wiki has changed the setting.''  
+
'''Can I create a new page by adding a link?'''
 +
 
 +
Yes. You do this by typing the '''title''' of the non-existing page as your link. This works only for internal links and will display the new page link in [[RedLink|red text]]. When you click on the link, you will be taken to a new page that will not exist until you edit and save it.
 +
 
 +
Before you use this method to create a new page, search the FamilySearch Wiki to make sure it does not already exist. If you have not already done so, please read the material on the [[Help:Creating a page|Creating a page]] page.<br>
 +
 
 +
'''What happens if I add a link to a page that does not exist?'''
 +
 
 +
The link to the non-existing page will be created, but the link will be displayed in [[RedLink|red text]]. You can use this method to create new pages in the FamilySearch Wiki as you edit an existing page. If you click on the link, it will take you to the page where you can create it.
 +
 
 +
'''What do the symbols at the end of the External Links mean?'''
 +
 
 +
The following symbols can appear behind an external link.
 +
 
 +
#[[Image:ExternalLinkSymbol.png|20x20px]] This is the standard external link symbol. Internal links have no symbol attached to the link text.
 +
#[[Image:ExternalSecureLinkSymbol.png|20x20px]] This link symbol indicates that the link is a secure link, using <nowiki>https://</nowiki> in the link address.  
 +
#[[Image:DocumentSymbol.png|20x20px]] The document symbol indicates a link to a document and not a Wiki page.
 +
#[[Image:AudioSymbol.png|20x20px]] The audio (sound) symbol indicates a link to a sound file.
 +
#[[Image:VideoSymbol.png|20x20px]] The video symbol indicates a link to a video file.
 +
#[[Image:EmailSymbol.png|30x40px]] The email symbol indicates an email address and will usually start the email program. Please do not use.
 +
 
 +
'''What is an Interwiki Link?'''
  
Similar to internal page links, you can create piped links, with alternate link label, e.g. <code><nowiki>[[wikipedia:Sunflower|big yellow flower]]</nowiki></code>.  
+
Interwiki links are Links to other wiki's such as Wikipedia. These appear as an internal link, but contain the name of the wiki: [[wikipedia:History of Pennsylvania]]. Please use the Wikipedia Template {{tl|Wpd}} to create an external link to Wikipedia pages. This will allow all Wikipedia links to be updated at the same time if Wikipedia changes the way it links to pages.
  
Basically this is an abbreviation for longer URLs. A very similar link could be created as a normal external link by typing <code><nowiki>[http://en.wikipedia.org/wiki/Sunflower Sunflower]</nowiki></code>, but interwiki links allow you to type out an easy and compact link, almost as if you are linking to a page on your own wiki.
+
'''What is an Inter-language Link?'''
  
{{admin tip|tip=See {{mediawiki|Manual:Interwiki}} for the management of interwiki links of your wiki.}}
+
An inter-language link is a link to a Wiki page in a different language. Inter-language links are usually found in a bar at the bottom of the page. The links are created using the {{tl|H-langs}} template. If this page is available in [[FamilySearch Wiki:Non-English versions of the wiki|other languages]] and someone has added the links, you will see a bar displaying the links at the bottom of the page.
  
=== Interlanguage links ===
+
<u>'''Quick Reference for the Rich Editor:'''</u>
 +
<blockquote>
 +
*[[Image:LinkGlobe.jpg|20x20px|LinkGlobe.jpg]] The blue globe/earth icon with an <u>unbroken</u> chain on the toolbar is used for adding or editing links.<br>
 +
*[[Image:UnLinkGlobe.jpg|20x20px|UnLinkGlobe.jpg]] The blue globe/earth icon with a <u>broken</u> chain on the toolbar is used for deleting a link, but not the text. The icon is active during editing when a link is selected.
 +
*[[Image:RichEditorTemplateButton.png|20x20px|RichEditorTemplateButton.png]] The <nowiki>{T}</nowiki> icon button is used for adding a Template, including template links.
 +
</blockquote>
 +
<u>'''Quick Reference for the Standard Editor:'''</u>
 +
<blockquote>
 +
*[[Image:StandardEditorInternalLink.png|20x20px|StandardEditorInternalLink.png]] The '''<u>Ab</u>''' icon button is used for defining internal links.<br>
 +
*[[Image:StandardEditorExternalLink.png|20x20px|StandardEditorExternalLink.png]] The globe icon button is used for defining external links.<br>
 +
</blockquote>
  
If your wiki has other language versions, you may find “interlanguage links” in the [[Help:Navigation#Sidebar|sidebar]], just below [[Help:Navigation#Toolbox|toolbox]] in the box named “{{lcfirst:{{int:otherlanguages}}}}.”
+
'''Ways to Add Links'''
  
Interlanguage links behave similar to interwiki links, except that they are listed in the sidebar. To create an interlanguage link from a page, just type <code><nowiki>[[</nowiki>''language prefix'':pagename]]</code> wherever you like in the page; the language prefix is the prefix specified at your wiki for the other language version (typically the [[wikipedia:ISO 639|ISO language code]]).
+
You can add a link to a page in one of three ways:  
  
If you want to make the interlanguage link to appear in the content of the page, you can add a colon before the language prefix, e. g. <code><nowiki>[[:en:Sunflower]]</nowiki></code>.  
+
#Use the <u>''Rich Editor''</u> to add internal and external links and to use templates using features similar to those found on many word processors..  
 +
#Use the ''<u>Standard Editor</u>'' and <u>''Wikitext''</u> to add code manually for features not enabled in the rich editor, including internal or external link or to use a template.
 +
#Use a <u>''Template''</u> to add interwiki links and other links that need special requirements set up. You can use either the rich editor or wikitext to add a template link.<br><br>
  
{{Contributor Help badge}}
+
Watch a video demonstration of how to add a link:<br><br>[[Image:Watch a video.png|156x56px|link=http://bcove.me/vikzmanh]]
  
 +
{{Contributor Help badge}}
  
== See also  ==
+
=== See also  ===
  
*[[Help:Linked images|Linked images]]
+
*[[Help:Advanced Linking|Help:Advanced Linking]]  
  
{{Languages}}  
+
{{Contributor help-navbox}} {{Editing help}}
  
 
[[Category:Help]]
 
[[Category:Help]]

Revision as of 05:54, 3 September 2012

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


Contents


Types of links

There are four types of links:

  1. Internal links to other pages in the wiki.  These links pertain only to the Wiki.  They do not include any other FamilySearch sites.
  2. External links to other websites, inlcuding other FamilySearch sites
  3. Interwiki links to other websites registered to the wiki in advance
  4. Interlanguage links to other websites registered as other language versions of the wiki

Creating links

The FamilySearch Wiki uses two types of editors to create and edit pages:

1. The Rich Editor has a toolbar similar to many word processors.

RichEditor.jpg
To switch to the Standard Editor, click on [Disable rich editor].


If you are using the Rich Editor, See Help:Create an internal link and Help:Create an external link for step by step instructions on how to add links to a page.


2. The Standard Editor works in Wikitext and its limited tools help you edit a page.

StandardEditor.jpg
To switch to the Rich Editor, click on [Rich Editor].

See Advanced Linking for instructions on how to create links using the "Standard Editor" and Wikitext.

FAQ - Frequently Asked Questions

How do I edit a link?

Links to both internal FamilySearch Wiki pages and external internet pages can and often do change.

  • In the Standard Editor, type the new page, internet link address, or template text over the old material.
  • In the Rich Editor, place your cursor over the link text and click the the blue globe/earth icon with an unbroken chain LinkGlobe.jpg on the toolbar. Then replace the page title or internet address link with the correct link.
  • If you are editing a template in the Rich Editor, highlight the template TemplateSymbolInRichEditor.png and click on the template {T} icon on the toolbar. Then edit the template text.

Don't forget to summarize what you have done so others know the change you've made.

Does the text on the page need to match the title of the linked page?

It is not required , but the linking text should clearly convey the content of the linked page to the researcher and may 1) expand on the title of the linked page, 2) be more concise and 3) external links, which should always use linking text in place of the full internet http:// address.

Example 1:

Page Title: Mennonites
Linking Text: Researching Mennonite Records 

Example 2:

Page Title: Pennsylvania Biography
Linking Text: Biographies

Example 3:

Page URL: http://www.classbrain.com/artstate/publish/article_561.shtml
Linking Text: Famous Pennsylvanians


How do I avoid making a Link?

Generally, when you type an URL address (with the http://), it will be transformed to an external link. To avoid making a link, put the URL address between <nowiki> tags in the Standard Editor:

<nowiki>http://mediawiki.org</nowiki>


Can I create a new page by adding a link?

Yes. You do this by typing the title of the non-existing page as your link. This works only for internal links and will display the new page link in red text. When you click on the link, you will be taken to a new page that will not exist until you edit and save it.

Before you use this method to create a new page, search the FamilySearch Wiki to make sure it does not already exist. If you have not already done so, please read the material on the Creating a page page.

What happens if I add a link to a page that does not exist?

The link to the non-existing page will be created, but the link will be displayed in red text. You can use this method to create new pages in the FamilySearch Wiki as you edit an existing page. If you click on the link, it will take you to the page where you can create it.

What do the symbols at the end of the External Links mean?

The following symbols can appear behind an external link.

  1. ExternalLinkSymbol.png This is the standard external link symbol. Internal links have no symbol attached to the link text.
  2. ExternalSecureLinkSymbol.png This link symbol indicates that the link is a secure link, using https:// in the link address.
  3. DocumentSymbol.png The document symbol indicates a link to a document and not a Wiki page.
  4. AudioSymbol.png The audio (sound) symbol indicates a link to a sound file.
  5. VideoSymbol.png The video symbol indicates a link to a video file.
  6. EmailSymbol.png The email symbol indicates an email address and will usually start the email program. Please do not use.

What is an Interwiki Link?

Interwiki links are Links to other wiki's such as Wikipedia. These appear as an internal link, but contain the name of the wiki: wikipedia:History of Pennsylvania. Please use the Wikipedia Template {{Wpd}} to create an external link to Wikipedia pages. This will allow all Wikipedia links to be updated at the same time if Wikipedia changes the way it links to pages.

What is an Inter-language Link?

An inter-language link is a link to a Wiki page in a different language. Inter-language links are usually found in a bar at the bottom of the page. The links are created using the {{H-langs}} template. If this page is available in other languages and someone has added the links, you will see a bar displaying the links at the bottom of the page.

Quick Reference for the Rich Editor:

  • LinkGlobe.jpg The blue globe/earth icon with an unbroken chain on the toolbar is used for adding or editing links.
  • UnLinkGlobe.jpg The blue globe/earth icon with a broken chain on the toolbar is used for deleting a link, but not the text. The icon is active during editing when a link is selected.
  • RichEditorTemplateButton.png The {T} icon button is used for adding a Template, including template links.

Quick Reference for the Standard Editor:

  • StandardEditorInternalLink.png The Ab icon button is used for defining internal links.
  • StandardEditorExternalLink.png The globe icon button is used for defining external links.

Ways to Add Links

You can add a link to a page in one of three ways:

  1. Use the Rich Editor to add internal and external links and to use templates using features similar to those found on many word processors..
  2. Use the Standard Editor and Wikitext to add code manually for features not enabled in the rich editor, including internal or external link or to use a template.
  3. Use a Template to add interwiki links and other links that need special requirements set up. You can use either the rich editor or wikitext to add a template link.

Watch a video demonstration of how to add a link:

Watch a video.png

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


See also