Creating urls and linking to resources from text and Markdown files.
====================================
First you should read how you in general [use the framework to create urls to routes and resources]([BASEURL]create-urls).
Now, how is this done in textfiles or Markdown?
To solve this it exists some shortcodes that maps to the frameworks methods for creating links.
| Shortcode | Method in `$di->url` | Result |
|---------------|--------------------------|--------|
| `BASEURL` | `create($uri)` | Creates an url by prepending the siteurl and the baseurl to `$uri`. The scriptname is also prepended if the url type is `URL_APPEND`. The scriptname is not prepended when the url-type is `URL_CLEAN`. |
| `RELURL` | `createRelative($uri)` | Same as above but never prepending scriptname. |
| `ASSET` | `asset($url)` | Creates an url by prepending the siteurl and the baseurl to $url. The scriptname is also prepended if the url type is URL_APPEND. The scriptname is not prepended when the url-type is ORL_CLEAN. |
Now, lets see some examples.
Use textfiles and Markdown as content
------------------------------------
You can write content as textfiles or Markdown-files and you then integrate them into views like this.
```
$byline = $app->fileContent->get('byline.md');
$byline = $app->textFilter->doFilter($byline, 'shortcode, markdown');
```
The code above shows how you open the textfile as a ordinary file and then parse it through a list of filters. The result in `$byline` is usually HTML.
The examples below are written in Markdown. But the usage of these shortcodes is tied to the usage of the filter `shortcode` which is implemented in the class [`Anax\Content\CTextFilter`](https://github.com/mosbth/Anax-MVC/blob/master/src/Content/CTextFilter.php).
Creating links to routes with \[BASEURL\]
------------------------------------
To add the baseurl (of current frontcontroller) to a link, use the shortcode \[BASEURL\] like this in your Markdown document.
```
Here is a [link to this page]([BASEURL]create-urls-in-md).
The content of BASEURL is [ BASEURL ].
```
The resulting HTML turns out like this.
> Here is a [link to this page]([BASEURL]create-urls-in-md).
> The content of BASEURL is [BASEURL].
Or like this in its source.
```
Here is a link to this page.
The content of BASEURL is http://localhost/git/Anax-MVC/webroot/doc.php/.
```
Creating links to resources with \[RELURL\]
------------------------------------
To add the webapps baseurl (but always without the scriptname) to a resource on the website, use the shortcode `\[RELURL\]` like this in your Markdown document.
```
Here is a [link to the humans.txt]([RELURL]humans.txt).
The content of RELURL is [ RELURL ].
```
The resulting HTML turns out like this.
> Here is a [link to the humans.txt]([RELURL]humans.txt).
> The content of RELURL is [RELURL].
Or like this, in its source.
```
Here is a link to the humans.txt.
The content of RELURL is http://localhost/git/Anax-MVC/webroot/.
```
Linking to images with \[ASSET\]
------------------------------------
To add an image to the website and create the link relative the current webapp. Use the shortcode `\[ASSET\]` like this in your Markdown document.
```
Here is an image.
The content of ASSET is [ ASSET ].
```
The resulting HTML turns out like this.
> Here is an image.
> 
> The content of ASSET is [ASSET].
Or like this, in its source.
```
Here is an image.
```