site/docs/testimonials.md

1.8 KiB

Testimonials

The testimonials component's quotes are based on simple YAML data defined in _src/data/testimonials.yml with different arrays. Each array holds a total of 3 quotes.

The testimonials component consists of various files:

Photos

Photos of quotees need to be square and should be at least or exact 144x144px. The lazy retina technique is in use where the photo is the @2x resolution but is scaled down by 50% with CSS. Photo paths are relative to /assets/img/.

JavaScript

The small js component only handles activating the quotes intro animation once the whole section is in viewport. The component needs to be activated either globally or on each page it is used by calling:

Testimonials.init();

Select and output a set of quotes

A set of quotes can be set as value of the custom variable quotes in the YAML Front Matter of the page where the testimonials component has been included.

E.g. on the front page _src/index.html we want to include the whole testimonials section and use set2 for the quotes. So in the YAML Front Matter of that file, write:

---

quotes: set2

---

In the content of the page where you want to have the testimonials section include it:

<body>
    {% include sections/section-testimonials.html  %}
</body>

The value of the quotes variable will grab the associated set of quotes and outputs them on the front page.