forum2025.diglib.org 🌬️

A static site for the DLF Forum 2025 in Denver, built with Eleventy and Tailwind CSS.

Table of Contents

• forum2025.diglib.org 🌬️
  • Table of Contents
  • Prerequisites
  • Getting Started
  • Available Scripts
  • Zenodo Data
  • Linting & Formatting
  • Testing
  • Building
  • Deployment
  • Continuous Integration
  • Asset Optimization
  • Contributing
  • Changelog
  • Image Credits

Prerequisites

• Node.js 20 or later (npm included)
• pnpm 8 or later (recommended)
• ImageMagick (magick CLI) for resizing hero images
• cwebp (WebP tools) for WebP conversion

Getting Started

Clone the repo and install dependencies:

git clone https://github.com/clirdlf/forum2025.diglib.org.git
cd forum2025.diglib.org
pnpm install

Available Scripts

Command	Description
pnpm start	Run dev server and watch CSS (http://localhost:8080)
pnpm test	Execute unit tests (Jest)
pnpm build	Build production site (HTML + CSS)
pnpm lint	Run ESLint, Stylelint & HTML-Validate
pnpm format	Format codebase with Prettier
pnpm format:check	Check code formatting with Prettier
pnpm clean	Remove generated site folder (_site)
pnpm cache:zenodo	Cache Zenodo presentations

Zenodo Data

This pulls submissions from the DLF Forum community for a given year (e.g. 2025) and places the metadata in src/_data/presentaitons.json. These are then rendered at build time. The presentations are then available at /presentations/.

pnpm cache:zenodo

For use in future years, this also accepts a command-line argument for a given year:

pnpm cache:zenodo 2026

Source for this is in lib/cache-zenodo.js.

Linting & Formatting

pnpm lint
pnpm format:check

Testing

pnpm test

Building

pnpm build

Output in _site.

Deployment

Continuous deployment via GitHub Actions: pushes to main or dev trigger .github/workflows/deploy.yml to build & publish to GitHub Pages.

Continuous Integration

This project uses GitHub Actions for CI to enforce linting, formatting, testing, and build checks on every push and pull request. See .github/workflows/ci.yml for details.

Asset Optimization

Script	Description
./resize_images.sh	Resize images in src/static to a max of 2560×1400 via ImageMagick (mogrify).
./generate_webp.sh	Convert .jpg files in src/static to .webp using cwebp (use --all to reprocess).

Resize inline using Eleventy Image plugin:

<img eleventy:widths="200,600" src="/static/CLCS-46.jpg" alt="Learn@DLF" class="object-cover" />

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines on filing issues and submitting pull requests.

Changelog

All notable changes are documented in CHANGELOG.md.

Image Credits

• Photo by Aziz Acharki on Unsplash
• Photo by Andrew Preble on Unsplash
• Photo by JJ Shev on Unsplash
• Photo by Nico Smit on Unsplash
• Photo by Xuan Nguyen on Unsplash
• Photo by Samuel Regan-Asante on Unsplash
• Photo by Jonathan Beckman on Unsplash
• Photo by MARK HESSLING on Unsplash
• Photo by Logan Bonjean on Unsplash
• Photo by Marcel on Unsplash
• Photo by Giulia May on Unsplash
• Photo by Boston Public Library on Unsplash
• Photo by Pieter van de Sande on Unsplash
• Photo by Emily Morter on Unsplash