Internal links

From WikiEducator
Jump to: navigation, search



Links to pages within the wiki are called internal links or wiki links and can be created as follows:

Using the Wiki Syntax

To create a link to a page, surround the word you wish to use as your link in double square brackets like this:

   [[New Page]]

This will create a link when your content is saved (or previewed) like this:

   New Page
Icon present.gif
Tip: Remember page links are case sensitive

Newbies often make the mistake of using capitals and lowercase letters inconsistently when referring to the same page. So you may end up creating a new page when intending to link to an existing page because the case (upper and lower case) configuration do not match.


Editing Toolbar method

Highlight the word or set of words you would like to be the name of your new page and click on the Internal Link Button link.png button in the GUI toolbar.

You can use the Editing toolbar to perform a lot of simple formatting on the wiki, including creating links to pages.

When you preview or save your content, you will see that the text you have now linked has changed colour. If this link points towards a page that does not yet exist in the wiki, the link will be red. If the page already exists the link will be blue. The wiki software automatically checks all links to see whether they already exist in the wiki or not.

Creating a link to a page that does not yet exist is the first step to creating a new page.



Icon activity.jpg
Activity

You've probably already created your first page if you've made a sandbox under your User page. Have a go at creating maybe a booklist page of some of your recent reads.

Step 1: Go to your user page.
Step 2: Create a name for your new page e.g. [[/My Booklist/]].
Step 3: Use the wiki syntax above to turn the text you have entered into a page link.




Piped Links

There will often be times when you want the displayed text of a link to be different than the actual name of the page you are linking to. You may, for example, want to create a link that displays to the user as "Next Page" but the page itself will be called "ProjectPage2" or "ProjectPage3". If you want the displayed text of the link to have a different title than the actual page name you can do so by adding the pipe "|" divider (SHIFT + BACKSLASH on English-layout and other keyboards).

Keyboardlayout shift pipe.png

The pipe "|" is then followed by the alternative name. For example:

   [[Name of the Target page|display text]]

Using this type of syntax you can create a link to say the eXe Manual with a different link text like this:

  [[Online_manual|The eXe User Manual]]

which will appear like this:

 The eXe User Manual