Help/Links
There are basically three types of hypertext links:
- Internal links to other pages of the Rich Annotator System
- External links to pages at other websites
- Interlanguage links to other pages registered as different language versions of the current page
Please note that this list does not include category links and file links, which are used to place pages into categories and display images or other media files, respectively.
Internal links
To create a so-called internal link to a page in the Rich Annotator System, use double square brackets wiki markup, [[like this]]. When you preview or save your changes, you will see a link that can be followed to the target page. If the page exists the link is displayed in blue; if the page does not exist, the link appears red. Following such a "redlink" to a missing page will usually enable the user to create the page.
To markup any arbitrary string of text (not necessarily a page title) as a link, use a "vertical bar" or "pipe" character, like this: [[Help/Categories|category links]] results in the link category links.
If the page title you are linking to is that of the page you are editing, the result is not a hyperlink at all but simply bold text (for example, on this page the markup [[Help/Links]] gives the result Help/Links).
If you want to link to a specific section or to an anchor within the same page, use the # symbol, like this: [[#External links]], which gives #External links.
Anchors are provided automatically on section headings and to the top of the page.
You can also set an anchor for incoming links:
<div id="Unique anchor name 1">optional text</div>, rendered block-level;<span id="Unique anchor name 2">optional text</span>, rendered inline.
Doing this would allow for [[#Unique anchor name 1]] on the same page or [[Help/Links#Unique anchor name 1]] on a different page. Omit the "optional text" for an invisible anchor.
You can set an anchor in a section heading: ==<span id="Alternate Section Title"></span>Section heading==. Note the placement. This must be a "span" tag, not a "div". (Such anchors allow sections to be retitled without breaking incoming links.)
To link to an anchor at another page, use e.g. [[Help/Formatting#VisualEditor|VisualEditor]], which gives VisualEditor.
Visible link to a category page: [[:Category:Help]], which gives Category:Help. Without the leading colon the link would not be visible and the page would instead be placed into the category; this is a very common mistake. See also Categories.
Visible link to an image or media file: [[:File:Example.jpg]]. Without the leading colon on the "File:" examples, the images would actually be displayed. See also Images.
External links
To create an external link, usually to a page at a different website, enclose the URL followed by space and the link text in single square brackets (see examples below). When you save or preview the page, you will see a link rendered slightly differently than an internal wikilink: it will be a slightly different color and followed by an arrow icon to show that it leads to another site.
| Description | You type | You get |
|---|---|---|
| External link with specified link text | [https://ras.ppke.hu Rich Annotator System] |
Rich Annotator System |
| Numbered external link | [https://ras.ppke.hu] This is what happens if you omit the link text. Multiple links of this type on the same page are numbered sequentially. |
[1] |
| Bare external link | https://ras.ppke.hu URLs beginning with " http://" and "https://" are automatically linked, even when no brackets are used. |
https://ras.ppke.hu |
| Avoiding auto-linked URLs | <nowiki>https://ras.ppke.hu</nowiki> |
https://ras.ppke.hu |
