Linking to other components

I could be completely missing this in the documentation, but I can’t see where there is a way to have handlebars / MD in a components notes file render a link to another component.

i.e.

This is a description of how this component works. But it's also
similar to {{ components.buttons.cancel-button }}  

Am I just being blind/dumb ?

[mihkeleidast]

Reopening since this is something we should figure out with integrating core/theme/adapter somehow.

I see the need for three usecases:

• linking from component templates (this should be implemented by a helper in adapter)
• linking from docs pages - same as component template
• adding links to context from the config file. sometimes we need to statically link together two view templates, for example, without using helpers in templates, since the url/href should be a simple context value.

[LeBenLeBen]

If that is of any help, I have this Nunjucks helper:

    link(handle) {
      const name = handle.replace('@', '');
      let prefix = '';
      let ext = '';

      if (process.env.NODE_ENV === 'production') {
        prefix = '../..';
        ext = '.html';
      }

      return `<a href="${prefix}/components/detail/${name}${ext}">${handle}</a>`;
    },

Which then allows me to link to other components with: {{ '@handle' | link }}.

Notice that I run my Fractal commands prefixed with NODE_ENV=[development|production] for this to work properly.