Selected

Frontmatter

blocks:
  - type: selected-* # [selected-posts, selected-publications, selected-products…]
    section: '' # [posts, publications, products…]
    heading: {} # (optional)
      surtitle: '' # string (optional)
      title: '' # string (optional)
      text: '' # markdown (optional)
    source: '' # [selection, taxonomies, children, toplevel] (optional, defaults to selection)
    items: [] # list of paths or slugs, when source is selection
    categories: [] # one field per taxonomy, when source is taxonomies (optional)
    parent: [] # list of paths or slugs, when source is children
    limit: 4 # number, caps the items shown, every one when empty (optional)
    show_more: false # boolean, adds a link to the section index (optional)
    ui: {} # (optional)
      theme: '' # [accent, black, dark, highlight, light, neutral, white] (optional)
      grid: '' # [xsmall, small, medium, large, container, full] (optional)
      offset: '' # [start, center, end] (optional)
      align: '' # [start, center, end] (optional)
      layout: '' # [grid, list, carousel] (optional)
      scrollsnap: '' # [none, sm, md, lg, xl, all] or object (optional)
      carousel: {} # only with layout: carousel (optional)

Four ways to fill the block. source: selection takes the pages one by one in items, in that order. source: taxonomies takes every page of the section matching all the taxonomy terms set on the block — an empty taxonomy is ignored — and the block then carries one field per taxonomy of that section, named after the taxonomy itself (categories, tags, persons_statutes…). source: children takes the children of the pages set in parent, the sub-expertises of an expertise for one. source: toplevel takes the first level of the section, the expertises rather than their sub-expertises, and needs no field: both follow the tree as it grows.

source: children and source: toplevel are offered to the sections the CMS lets you nest, those whose nested.depth is above 1 (see nested collections). Only the direct children of a parent come out: a deeper level would flatten the tree into a listing mixing an item and its own children.

With every source but selection, pages come out pinned first — those with a weight — then by date when the section has one, by title otherwise. The persons section keeps its own order, by status then by lastname.

limit caps the items shown, whatever the source: the latest posts of a category, the first sub-expertises of an expertise. Left empty, every item comes out.

The block class carries the section, block-selected-posts, so a section can be styled on its own.

See Common keys for heading, footing, scrollsnap, carousel and the full ui reference.

Files

• HTML file — hugolify-theme
• SASS file — hugolify-theme-bootstrap
• CSS file — hugolify-theme-design-system
• Demo content file
• Hugolify admin file

CMS availability