Help:Links

From FamilySearch Wiki

(Difference between revisions)
(cleaned up)
(moved content to Help:Advanced Linking)
Line 54: Line 54:
  
 
[[Image:StandardEditorToolbar.png|center|StandardEditorToolbar.png]]  
 
[[Image:StandardEditorToolbar.png|center|StandardEditorToolbar.png]]  
 +
 +
:''See [[Help:Advanced Linking|Advanced Linking]]''
  
 
=== Internal Link (text matches page title)  ===
 
=== Internal Link (text matches page title)  ===
Line 71: Line 73:
  
 
[[Image:StandardEditorInternalLinkNoTextMatchPage.png]]  
 
[[Image:StandardEditorInternalLinkNoTextMatchPage.png]]  
 
{| border="1" class="wikitable"
 
|-
 
! 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]]
 
|-
 
| 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]]
 
|-
 
| 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]]
 
|-
 
| Internal link to an image or a file of other types
 
| <pre>[[media:example.jpg]]
 
 
[[media:example.pdf]]</pre>
 
See also [[Help:Images]]
 
 
| [[Media:Example.jpg]]
 
[[Media:Example.pdf]]
 
 
|}
 
  
 
=== External links  ===
 
=== External links  ===
  
{| border="1" class="wikitable"
+
:''See [[Help:Create an external link|Creating an external 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.
+
 
+
|
+
[http://en.wikipedia.org/wiki/.avi video] [http://en.wikipedia.org/wiki/.wav sound] [http://en.wikipedia.org/wiki/.pdf document]
+
 
+
|-
+
| External link to the same host
+
| <pre>[http://{{SERVERNAME}}/pagename]</pre>
+
| [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=
+
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">
+
#bodyContent a.external,
+
#bodyContent a[href ^="gopher://"] {
+
background: none;
+
padding-right: 0;
+
}
+
</source>
+
}}
+
  
 
==== Avoiding auto-links ====
 
==== Avoiding auto-links ====

Revision as of 23:20, 1 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

Editing

To add or edit pages in the FamilySearch Wiki, you must be a registered user. To register, go here.

To add or edit a link on a page, do the following:

  1. HighlightEdit Link.png
    Sign in to the FamilySearch Wiki.
  2. Navigate to the page where you want to add or edit a link. If the page does not exist, then create it.
  3. Once you have reached the page you want to edit, click the Edit option in the sidebar to open the editing window.

Page Editors

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].

  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].

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

Using the Rich Editor

Editor Toolbar.png

Internal and External Link

  1. Enter and highlight or highlight the existing text that you want to use for your link. The text does not have to match the title of page you are linking.
  2. Click on the globe/earth icon with an unbroken chain LinkGlobe.jpg in the toolbar to open the link window.
    RichEditorHighlightText.jpg

Internal 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 [[#top|current page]] which always links to the top.)

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. Start typing the name of the FamilySearch Wiki page to which you want to link in the Link field.
    Pages that match what you type appear in the window below the Link Field.
    RichEditorTypeLink.jpg
  2. Highlight the desired page from the list and click OK to complete setting up the internal link.
    RichEditorHighlightDesiredLinkt.jpg

External links

  1. When you first begin adding external links, you may want to check with an experienced contributor for helps and guidelines.
  2. Without closing the edit session, open another (new) session window or tab in your browser. 
  3. Browse to the page to which you want to link. The address of the page appears in the browser's address bar. 
  4. Highlight and copy the address and then paste it into the Link field of the link window. (Be sure to include the “http://” portion of the address.) 
  5. Click OK to complete setting up the external link.
    Link(field) Window.png

Using the Standard Editor and Wikitext

StandardEditorToolbar.png
See Advanced Linking

Internal Link (text matches page title)

  1. Type and highlight or highlight the title to the existing internal page you are linking.
  2. Click the StandardEditorInternalLink.png button.

StandardEditorInternalLinkTextMatchsPage.png

The result is "See also [[Pennsylvania Biography]]." and is displayed on your page as "See also Pennsylvania Biography."

You can also add an internal link directly into the editor by typing two left brackets [[, the page title of the linked page, and two right brackets ]]. For example:

[[Pennsylvania Biography]]

Internal Link (text does not match page title)

  1. Type and highlight or highlight the title of the existing internal page and desired text (separated by the pipe | symbol).
  2. Click the StandardEditorInternalLink.png button.

StandardEditorInternalLinkNoTextMatchPage.png

External links

See Creating an external link

Avoiding auto-links

By default, when you write a URL as is, it will be transformed to an external link.

To avoid that effect, put the URL between <nowiki> tags as in:

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

Template Link

  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
The 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.

Link Templates

See Advanced Linking

Interwiki links

See Advanced Linking

Interlanguage links

See Advanced Linking

FAQ

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?

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


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.


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



See also