Linking: Difference between revisions
Markmcumber (talk | contribs) No edit summary |
Markmcumber (talk | contribs) No edit summary |
||
| Line 2: | Line 2: | ||
<br/><br/><br/><br/><br/><br/>'''[[Archives Manual#Linking within the Wiki|Return to the Student Manual]]''' | <br/><br/><br/><br/><br/><br/><br/>'''[[Archives Manual#Linking within the Wiki|Return to the Student Manual]]''' | ||
= Internal Links = | = Internal Links = | ||
| Line 28: | Line 28: | ||
Sometimes the exact title of a page is not ideal to insert into a sentence and an '''alternate text''' would better serve the entry/page. Instead, best practice is to present the hyperlink as text that flows within the entry. | Sometimes the exact title of a page is not ideal to insert into a sentence and an '''alternate text''' would better serve the entry/page. Instead, best practice is to present the hyperlink as text that flows within the entry. | ||
<div style="border: 2px solid black;"><br/><center>'''Consider this example:'''</center><center>Debating has long been a popular extracurricular activity at UNB.</center><p style="text-align: center;">It is in the wiki's interest to establish a link to the Literary and Debating Society page, but inserting this title would obstruct the flow of the sentence. | <div style="border: 2px solid black;"><br/><center>'''Consider this example:'''</center><center>Debating has long been a popular extracurricular activity at UNB.</center><p style="text-align: center;">It is in the wiki's interest to establish a link to the Literary and Debating Society page, but inserting this title would obstruct the flow of the sentence.<br/></p></div><br/> | ||
== RichTextEditor == | == RichTextEditor == | ||
| Line 36: | Line 36: | ||
To establish a link using alternate text with the WikiTextEditor, a [[Mark-up Language|pipe]] (or vertical bar)— | —must be placed after the title of the [[Entries and Pages|destination]] entry/page, followed by the desired alternate text and enclosed between double square brackets: | To establish a link using alternate text with the WikiTextEditor, a [[Mark-up Language|pipe]] (or vertical bar)— | —must be placed after the title of the [[Entries and Pages|destination]] entry/page, followed by the desired alternate text and enclosed between double square brackets: | ||
<p style="text-align: center;"><nowiki>[[Literary and Debating Society|Debating]]</nowiki> has long been a popular extracurricular activity at UNB. </p><p style="text-align: center;"><span style="line-height: 1.6;">(Result:) [[Literary and Debating Society|Debating]] has long been a popular extracurricular activity at UNB.</span></p> | <p style="text-align: center;"><nowiki>[[Literary and Debating Society|Debating]]</nowiki> has long been a popular extracurricular activity at UNB. </p><p style="text-align: center;"><span style="line-height: 1.6;">(Result:) [[Literary and Debating Society|Debating]] has long been a popular extracurricular activity at UNB.</span></p><br/> | ||
== Lazy Linking | = Lazy Linking = | ||
''Lazy Linking'' is the process of actively creating links to non-existent [[Entries and Pages|entries/pages]] with the intention of creating them—or having someone else create them—in the future. It is an effective way to map out the future of the wiki's development without deviating from the task at hand to establish a new entry/page (the perpetual nature of this deviation could be infinite and result in an infinite number of unfinished pages - don't mind the dramatics). | |||
Hyperlinks to non-existent entries/pages will appear red - clicking a red hyperlink will allow the contributor to [[Editors|edit]] this non-existent entry/page. | |||
<center>Here is a link to all the entries/pages that have been ''Lazy Linked'': [] | |||
= External Links = | = External Links = | ||
Revision as of 10:45, 20 June 2014
Internal Links
An Internal Link is used to direct the user to another page within the UNB wiki. These internal links are the most effective way to establish a web of connections throughout the wiki that enhance readers' experience by increasing accessibility of information.
RichTextEditor
Creating an Internal Link with the RichTextEditor is quick and easy, as MediaWiki provides the Contributor with a field to search the entire wiki for the desired destination page/entry. To generate this field, click the Link icon:
Clicking the link icon will generate a new box in which existing pages can be searched - as long as the contributor knows the title of the destination entry/page. Upon inputting the first few characters the desired destination should appear to be selected, establishing a hyperlink on the origin entry/page.
WikiTextEditor
To create an internal link, enclose the title of the destination entry with double square brackets on either side:
- If the destination entry exists and has been entered correctly an operational link will be created.
- Remember that Mediawiki is case sensitive - the first thing that the contributor should check for if a link does not work is the spelling and capitalization of the destination entry within the WikiTextEditor code.
- If the destination entry does not exist, the hyperlink created will connect to a new page upon which an entry can be created, either immediately or in the future. The practice of creating links to non-existent pages for future creation is called #Lazy_Linking, which can be an effective way to communicate to future contributors the pages that need to be created and the future direction of the wiki.
http://unbhistory.lib.unb.ca/index.php/Special:WantedPages
Linking via Alternate Text
Sometimes the exact title of a page is not ideal to insert into a sentence and an alternate text would better serve the entry/page. Instead, best practice is to present the hyperlink as text that flows within the entry.
It is in the wiki's interest to establish a link to the Literary and Debating Society page, but inserting this title would obstruct the flow of the sentence.
RichTextEditor
Using the RichTextEditor, simply write the sentence and highlight the text intended to be presented as hyperlink, and complete the process as outlined in the section above by clicking the link icon and selecting the destination page.
WikiTextEditor
To establish a link using alternate text with the WikiTextEditor, a pipe (or vertical bar)— | —must be placed after the title of the destination entry/page, followed by the desired alternate text and enclosed between double square brackets:
[[Literary and Debating Society|Debating]] has long been a popular extracurricular activity at UNB.
(Result:) Debating has long been a popular extracurricular activity at UNB.
Lazy Linking
Lazy Linking is the process of actively creating links to non-existent entries/pages with the intention of creating them—or having someone else create them—in the future. It is an effective way to map out the future of the wiki's development without deviating from the task at hand to establish a new entry/page (the perpetual nature of this deviation could be infinite and result in an infinite number of unfinished pages - don't mind the dramatics).
Hyperlinks to non-existent entries/pages will appear red - clicking a red hyperlink will allow the contributor to edit this non-existent entry/page.
External Links
Linking to Category Pages
Linking to Image Pages
Anchors (Linking to a Specific Place on a Page)
There may be circumstances in which linking to a the top of a page is ineffective, as the reader will then have to read through a body of text or scroll through the page to locate the reference. Linking to a specific place on an entry or page requires the use of an anchor.
- This is particularly relevant for larger pages with a lot of content.
- For these functions the WikiTextEditor is most effective.
- Remember to verify capitalization and spelling of titles when creating links.
1. Some anchors exist naturally within a page. All of the section headers are anchors and can be easily identified by their presence in the Table of Contents at the top of a given page:
[[Destination page]]
[[Destination page#Header title of Destination page]]
[[Destination page#Header title on Destination page|Alternative text]]
Example: [[Mark's Page#Sneaker Collection|Mark loves sneakers]]
2. Some entries may not be effectively broken up by headers, while some sections might be too long for linking to the header to be an effective solution - do not fear! There is a way to manually create an anchor on a page, but the WikiTextEditor must be used:
<span id="Anchor_name">Text can be inserted here (although the absence of text will produce an invisible anchor)<span>
Spaces cannot be used in the "Anchor_name", so make use of _'s, and remember to use quotation marks.
Having created this anchor, the next step is to link to it. This process is identical to linking to headers as described above:</span>
[[Destination page#Anchor_name|Alternative text]]