20.2. Insert a link into text

When you are in the text editor, you can link to pages on the internet and to pages within Mahara. The visual editor allows you to decide whether links shall be opened in the same window or in a new tab or window.

20.2.1. Link to an external web page

External pages are opened in a new tab or window (depending on your browser configuration) automatically.

Link to an external page

1. In the editor window, select the text that you want to link.

2. Click the Link icon . The link configuration window opens.

3. Url: Enter the URL for your link. Ensure that you use the correct protocol. In most cases, it is https://.

4. Text to display: You see the text that you highlighted.

5. Target: You can select in which window the link is opened.

   • None: Use the defined default option. For external links that means that the page is opened in a new tab or window.

   • Same page: Open the link in the same window as the current page.

   • New window: Open the link in a new tab or window.

6. Click the OK button to save your choice.

7. Continue writing your text and then save your content.

20.2.2. Link to another portfolio page

You can insert a link directly to one of your personal portfolio pages without needing to know its URL.

Note

Currently, this feature only exists for linking to your own personal portfolio pages, but not for linking to other people’s pages or group, institution, or site pages.

Insert an internal link into text

1. When you are in Edit mode of your page, select the Text block and drag it into the page editing area.

   Note

   This works anywhere on the site where you have the visual editor available.

2. Write the text that you want to link and highlight it.

3. Click the Link icon . The link configuration window opens.

4. Text to display: You see the text that you highlighted.

5. Link list: The drop-down menu shows all the collections and pages that are not in a collection to which you can link.

6. Select the page to which your highlighted text should link.

7. Url: The full path to the page is entered automatically into this field.

8. Target: You can select in which window the link is opened.

   • None: Use the defined default option. For links within Mahara, the link opens in the same window as the current page.

   • Same page: Open the link in the same window as the current page.

   • New window: Open the link in a new tab or window.

9. Click the OK button to save your choice.

10. Continue writing your text and then save your content.

20.2.3. Insert a link anchor

Sometimes you may not wish to link to a particular page, but rather to a specific passage within a journal entry or some other text in a block.

In this case, you can set an anchor and link to it.

Note

Anchors only work within an artefact and not across pages or artefacts. That means that you can set an anchor within a journal entry, but you cannot link to that anchor from within another journal entry or text block.

In order to use anchors, you need to:

1. Set the anchor.

2. Link to the anchor.

20.2.3.1. Set an anchor

Set an anchor in text

1. When you are in Edit mode of your page, select the Text block and drag it into the page editing area.

   Note

   This works anywhere on the site where you have the visual editor available.

2. Write your long text and place the cursor in the line to which you want to link directly.

3. Click the Anchor icon . The anchor configuration window opens.

   Note

   You need to click the Toggle toolbars icon to see the Anchor icon.

4. Id: Give your anchor a name so you can refer to it when setting your link.

5. Click the OK button to save your decision. You return to the edit screen for your text and see a little anchor where you had positioned your cursor.

6. Save your text.

20.2.3.2. Link to an anchor

Link to an anchor

1. You need to have set an anchor to somewhere else in the text that you are currently editing.

2. Highlight a word in your text that should take you to the anchor.

3. Click the Link icon . The link configuration window opens.

4. Text to display: You see the text that you highlighted.

5. Anchors: Select the anchor to which you want to link from the drop-down menu.

6. Url: The anchor that you selected is displayed.

   Note

   ‘user_’ is added automatically as the visual editor TinyMCE requires it for the anchor to work.

7. Click the OK button to save your choice.

8. Click the Save button to save your text.

9. When you display the page (outside of the Edit mode), you can click the linked text. You will jump to the section to which you had linked within that same text.