site/docs/testimonials.md

49 lines
1.8 KiB
Markdown
Raw Permalink Normal View History

Testimonials
------------------
The [testimonials component](../_src/_includes/testimonials.html)'s quotes are based on simple YAML data defined in [`_src/data/testimonials.yml`](../_src/data/testimonials.yml) with different arrays. Each array holds a total of 3 quotes.
2016-02-18 00:57:20 +01:00
The testimonials component consists of various files:
2016-02-18 00:57:20 +01:00
- [HTML component](../_src/_includes/testimonials.html)
- [HTML section](../_src/_includes/sections/section-testimonials.html)
2016-02-18 00:57:20 +01:00
- [YAML data](../_src/data/testimonials.yml)
- [SCSS styles](../_src/_assets/styles/bigchain/_testimonials.scss)
- [JavaScript](../_src/_assets/javascripts/bigchain/testimonials.js)
### 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:
```js
Testimonials.init();
```
### Select and output a set of quotes
2016-02-18 00:57:20 +01:00
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.
2016-02-18 00:57:20 +01:00
E.g. on the front page [`_src/index.html`](../_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:
```
---
2016-02-18 00:57:20 +01:00
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>
```
2016-02-18 00:57:20 +01:00
The value of the `quotes` variable will grab the associated set of quotes and outputs them on the front page.