A long-lived project that still receives updates
Provides Distill templates, runtime assets, and policy checks for al-folio sites.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

>= 2.0, < 3.0
~> 5.0
~> 13.0

Runtime

>= 3.9, < 5.0
>= 4.0, < 6.0
 Project Readme

al-folio-distill

Distill runtime/plugin extraction for al-folio v1.x.

What it provides

  • Distill layout renderer tag: {% al_folio_distill_render %}
  • Distill templates/includes used by layout: distill
  • Packaged Distill JS runtime under /assets/js/distillpub/*
  • Packaged Distill stylesheet at /assets/css/al-folio-distill.css

Usage

Add the gem and plugin:

gem 'al_folio_distill'
plugins:
  - al_folio_distill
al_folio:
  features:
    distill:
      enabled: true

al_folio_core delegates layout: distill rendering to this plugin.

Vendored Distill runtime policy

This gem ships prebuilt Distill runtime assets for end users (no npm step at gem install time).

  • Source of truth: al-org-dev/distill-template (al-folio branch)
  • Sync script: scripts/distill/sync_distill.sh
  • Provenance metadata: assets/js/distillpub/provenance.json
  • Runtime parity policy: vendored runtime hashes are pinned to match al-folio main snapshots carried by the upstream al-folio branch

Refresh vendored assets:

./scripts/distill/sync_distill.sh
# or pin a specific ref
./scripts/distill/sync_distill.sh <commit-sha>