GiovanniSalmeri / yellow-selflink

Create internal links in Yellow

Selflink extension 0.8.16

Create internal links.

Deprecation

This extension is deprecated in favour of Link. In order to transform the Selflink shortcuts into the new Link shortcuts, do the following:

• Make a backup copy of the /content/ folder
• Install Link extension
• Download file selflinkpatch.php
• If you do not want also the generic Markdwown links to be changed into Link shortcuts, delete in selflinkpatch.php lines 24-25
• Copy selflinkpatch.php into the /system/extensions/ folder
• Visit the site with the browser

How to create an internal link

Create an [a] shortcut.

The following two arguments are available, the second of which is optional:

slug = the slug of the page to link, possibly with the fragment
text = the text to be used in the link

Example

Creating a link:

[a somepage]  
[a somepage#fragment]  
[a somepage - text for linking]  

The shortcut creates a link with the full path of the page: so no link will break if you rearrange the structure of the site without modifying the slugs of the pages. The previous examples are thus equivalent to:

[Title of the page](path/to/somepage)  
[text for linking](path/to/somepage)  

But if two or more pages have with the same slug (which in general is not advisable), you must specify the portion of the path which is sufficient to disambiguate:

[a path/to/somepage]  
[a anotherpath/to/somepage]  

If the argument of the shortcut is ambiguous, the behaviour is undefined.

If no page matches the argument, the shortcut creates a link equivalent to this HTML code:

<a href="slug" class="missing">slug</a>  

Installation

Download extension and copy zip file into your system/extensions folder. Right click if you use Safari.

Developer

Giovanni Salmeri. Get help.