Links

Was this page helpful?

1. Linking to Wiki Pages
2. Linking to Wiki Page Sections
3. Linking to Sub Pages (Wiki.tree)
4. Link Text Highlighting
5. Acronyms and Technical Terms
1. 5.1. Web.link Extension

Hyperlinks form the power behind the Wiki, so use lots of them.

Just highlight the text you wish to link, and press the link button on the Edit Menu.

Linking to Wiki Pages

Linking to pages is very easy using the Link button on the Edit Menu .

The link feature will search for relevant Wiki pages and you can simple select the Wiki Page you wish to link to or paste a link to another website.

You may also select the Browse tab and navigate to another page in the MediaPortal Wiki.

Linking to Wiki Page Sections

To link to a section of a Wiki Page, is not as easy as linking to Pages. You may enter the section link in the format:

[[/12_Installation/1_Deploy_Tool/0_Select_Options#Use_TV|Use TV]]

To find the section link, you must go to the page, select Table of Contents, select the section and copy the link from the address bar.

Therefore, generally content is separated into distinct pages, rather than long pages with many sections/heading, particularly wherever section links may be required.

Linking to Sub Pages (Wiki.tree)

If you wish to link to sub pages of the current page, you do not need to enter the links separately. You may use the wiki.tree extension:

Select Extensions button on the Edit Menu.
Select Built in and navigate almost to the end of the list > wiki.tree.
Path: wiki page path (omit the http).
Depth: nesting depth for retrieving child pages (default: all).
Reverse: reverse order of child pages.

This extension is particularly useful for top level pages of a section, where you may wish to display an index of the sub pages you have added.

Link Text Highlighting

Make sure the text on the hyperlink describes the page the link leads to. Some examples:

Wrong: "Install the latest version of MediaPortal and the latest SVN-Snapshot."
OK-ish: "Install the latest version of MediaPortal and the latest SVN-Snapshott."
Best: "Install the latest version of MediaPortal and the latest SVN-Snapshot."
NEVER use "here" as the link text! "You will find what you want here." For more info check W3C's document on why not to use "click here".

Acronyms and Technical Terms

Acronyms and technical terms should always be linked to a glossary term in the MediaPortal Wiki, or to another website page, like Wikipedia. Even if you think the Acronym is well know, it may not be known to all new users.

Note: the MediaPortal Wiki Glossary contains only terms unique to MediaPortal, or those used in a unique way. All other terms should be linked to Wikipedia or other websites.

Web.link Extension

One of the best ways to add a link for acronyms or technical terms, is to use the web.link extension. The advantage of this extension is it allows you to display a title/text for the link on mouse hover. Example: HDD The code for this is:

{{ web.link{uri: "http://en.wikipedia.org/wiki/Hard_disk_drive", text: "HDD", title: "Hard Disk Drive", 
target: "_blank"} }}

However, you can easily use the web.link extension:

Select Extensions button on the Edit Menu.
Select Built in and navigate almost to the end of the list > web.link.
Link: add the hyperlink.
Text: link contents; can be text, an image, or another document (default: link uri).
Title: the caption which displays on mouse hover.
Target: be sure to add _blank in the Target field so the link will open in a new tab/window.