Getting started

Firstly, let me warn you that responsive images are somewhat complicated, and fall squarely into "proper web development" territory. To do this well, you will need to do some learning. The default settings are a starting point, meant to get you up and running with something reasonable while minimizing unexpected behavior.

Here are some good guides:

Step 1: Customize global settings

JPT's global configuration happens under the picture: key in _config.yml. The defaults are probably fine, though you may want to configure the input and output directories.

Step 2: Test & Learn

Step 3: Add breakpoints

Once you have a feel for how this plugin works, it's time to adapt it to your particular site. The built-in jpt- media queries probably don't quite fit your layout; Find whatever breakpoints your css uses, and tell JPT about them:

  1. Create _data/picture.yml
  2. List them under the media_queries: key. Give them easy-to-remember names, and wrap them in single quotes.
# _data/picture.yml

  (name): '(media query)'

If you're using bootstrap or something, you don't need to plug in every single breakpoint they have, just a handful that you'll actually use.

Step 4: Write presets

From there, it's time to write your own presets. Start with the default, and then move on to cover all the different ways you use images in your site.