Integration

URL formatting

There are two basic types of links: relative and absolute. A relative link points to a file that is relative to the current page, while an absolute link points to a file using the full URL, including the protocol and domain:

<!-- Relative URL -->
<a href="../index.html">Home</a>

<!-- Absolute URL -->
<a href="http://www.example-website.net/index.html">Home</a>

As you edit, the CMS generates relative URLs for links. In some cases, this may not be desirable. To tell the CMS to format your links as absolute URLs, you can add data-urls="absolute" to your editable region:

<div id="nav" class="editable" data-urls="absolute">
    <ul>
        <li><a href="http://example-website.net/">Home</a></li>
        <li><a href="http://example-website.net/about">About</a></li>
        <li><a href="http://example-website.net/contact">Contact</a></li>
    </ul>
</div>

In most cases, you won’t need to worry about this. However, if you have pages in various folder levels of your site that share the same include file, you’ll most likely want to use absolute URLs in the include file to ensure that the links always point to the right place.

While viewing the source in the editor, links will appear as relative URLs. This is normal, and they will be converted before the page is published.