Simplified the routing system by adding a partial generating Markdown references

Author: KittyGiraudel

_includes/routes.html

@@ -0,0 +1,3 @@
+{% for route in site.data.routes %}
+[{{ route[0] }}]: {{ route[1] }}
+{% endfor %}

about/index.md

@@ -9,7 +9,7 @@ There is nothing new with SassDoc. It has nothing of a revolutionnary idea; ther
 
 Still, we needed this. We needed a way to document our Sass files, APIs, frameworks, libraries and whatever. Thus, this project.
 
-SassDoc is built by [Pascal Duez](https://twitter.com/pascalduez), [Valerian Galliat](https://twitter.com/valeriangalliat), [Hugo Giraudel](https://twitter.com/hugogiraudel) and [Fabrice Weinberg](https://twitter.com/fweinb), a.k.a [SassDoc team](https://github.com/sassdoc) with the help of [Why Alix](https://twitter.com/isendil) for the design. And perhaps you, if you feel like <a href="/contributing/">contributing</a>!
+SassDoc is built by [Pascal Duez](https://twitter.com/pascalduez), [Valerian Galliat](https://twitter.com/valeriangalliat), [Hugo Giraudel](https://twitter.com/hugogiraudel) and [Fabrice Weinberg](https://twitter.com/fweinb), a.k.a [SassDoc team](https://github.com/sassdoc) with the help of [Why Alix](https://twitter.com/isendil) for the design. And perhaps you, if you feel like <a href="{{ site.data.routes.contributing }}">contributing</a>!
 
 <ul class="authors">
   <li class="author">
@@ -48,3 +48,5 @@ SassDoc is built by [Pascal Duez](https://twitter.com/pascalduez), [Valerian Gal
     <span class="author__role">Contributor</span>
   </li>
 </ul>
+
+{% include routes.html %}

annotations/index.md

@@ -602,3 +602,5 @@ Describes the documented item.
 ---
 
 \* The Markdown parsing is effective in compliant themes, by using the Markdown filter from [sassdoc-extras]({{ site.data.routes.extra_tools }}#markdown).
+
+{% include routes.html %}

brand-guidelines/index.md

@@ -53,3 +53,5 @@ $code-font-stack: 'Courier New', 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono',
 ## Illustration
 
 ![PNG Logo](/assets/images/illustration.png)
+
+{% include routes.html %}

broccoli/index.md

@@ -26,9 +26,9 @@ var docs = sassdoc(tree, options);
 Any specified option will be passed through directly to SassDoc, thus you can
 specify any option that SassDoc supports. Refer to:
 
-* [Command Line]({{ site.data.routes.command_line }}) for CLI options;
-* [Configuration]({{ site.data.routes.configuration }}) for SassDoc options;
-* [Customising the view]({{ site.data.routes.view }}) for default theme options.
+* [Command Line][command_line] for CLI options;
+* [Configuration][configuration] for SassDoc options;
+* [Customising the view][view] for default theme options.
 
 <p class="note note--info">
   <strong>Tip:</strong> provided you know what your doing and you've checked your paths before,
@@ -69,3 +69,5 @@ var docs = sassdoc('path/to/sass', {
     'package': './package.json'
 });
 {% endhighlight %}
+
+{% include routes.html %}

configuration/index.md

@@ -5,7 +5,7 @@ layout: default
 
 ## Introduction
 
-SassDoc comes with surprisingly few configuration in itself. Most of the configuration is [brought by the theme]({{ site.data.routes.view }}). However, you don't have to set up a configuration file in the theme package, that would be silly.
+SassDoc comes with surprisingly few configuration in itself. Most of the configuration is [brought by the theme][view]. However, you don't have to set up a configuration file in the theme package, that would be silly.
 
 Here is how it works: SassDoc merge the configuration file you provide (or that is being automatically fetched) with the one from the theme. If an option is set in both files, the one you set yourself overrides the one from the theme.
 
@@ -93,3 +93,5 @@ All non-grouped items are gathered by SassDoc in an `undefined` group, that is b
 SassDoc tries to make sure you always use an up-to-date version. If it is not the case, it will prompt you to update your current version. You can disable this behaviour by using the `no-update-notifier` option.
 
 <p class="note  note--info"><strong>Note:</strong> you can also use the CLI option <code>--no-update-notifier</code>.</p>
+
+{% include routes.html %}

contributing/index.md

@@ -14,7 +14,7 @@ There are many things you can do to contribute SassDoc:
 
 ## Asking a question
 
-Please, do not open an issue only to ask a question; it is not the best place for this. First, make sure your question is not already answered in the documentation, especially in the [Frequently Asked Questions]({{ site.data.routes.faq }}) section.
+Please, do not open an issue only to ask a question; it is not the best place for this. First, make sure your question is not already answered in the documentation, especially in the [Frequently Asked Questions][faq] section.
 
 If it's not, you can leave your question on:
 
@@ -54,3 +54,5 @@ If you are thinking of something a bit more complex, be sure to talk with someon
 New features or sizeable refactors should be based on the `develop` branch while bugfixes should head into both `master` and `develop`.
 
 Anyway, thank you very much for contributing!
+
+{% include routes.html %}

customising-the-view/index.md

@@ -5,9 +5,9 @@ title: "Customising the view"
 
 ## Introduction
 
-Aside from regular [configuration]({{ site.data.routes.configuration }}) from SassDoc itself, it is likely that the theme you use provides some kind of default configuration that you can overload.
+Aside from regular [configuration][configuration] from SassDoc itself, it is likely that the theme you use provides some kind of default configuration that you can overload.
 
-This is done exactly like the regular configuration, within the same configuration file. Please refer to the [configuration documentation]({{ site.data.routes.configuration }}) to learn how to specify a configuration file.
+This is done exactly like the regular configuration, within the same configuration file. Please refer to the [configuration documentation][configuration] to learn how to specify a configuration file.
 
 ## Options
 
@@ -146,3 +146,5 @@ googleAnalytics: 'UA-XXXXX-YY'
 tracking: |
   <img src="http://piwik.example.org/piwik.php?idsite={$IDSITE}amp;rec=1" style="border:0" alt="" />
 {% endhighlight %}
+
+{% include routes.html %}

data-interface/index.md

@@ -421,3 +421,5 @@ An item will look like this:
   /* ... */
 }
 {% endhighlight %}
+
+{% include routes.html %}

extending-sassdoc/index.md

@@ -6,11 +6,11 @@ title: "Extending SassDoc"
 ## Introduction
 
 SassDoc allows you to define custom annotations. This can only be done
-from a [custom theme]({{ site.data.routes.custom_theme }}) since there is no way for
+from a [custom theme][custom_theme] since there is no way for
 SassDoc to guess what to do or how those annotations should be displayed.
 
 Here's a simple example to add a few simple annotations to SassDoc
-within your theme. First, you'll have the usual theme function. Refer to [Using Your Own Theme]({{ site.data.routes.custom_theme }}) for more informations about this.
+within your theme. First, you'll have the usual theme function. Refer to [Using Your Own Theme][custom_theme] for more informations about this.
 
 {% highlight js %}
 module.exports = function () {
@@ -100,3 +100,5 @@ module.exports.annotations.push({
 
 For more examples, you can look at [the core annotations](https://github.com/SassDoc/sassdoc/tree/master/src/annotation/annotations) which are very
 insightful.
+
+{% include routes.html %}