Changelog
=========

Version 0.5 Beta (2026-07-01)
-----------------------------

First public beta of ``sphinx-lightbox``.

- Standard Sphinx ``image`` and ``figure`` directives can be transformed into
  lightboxes for HTML output.
- The ``.. lightbox::`` directive is available with ``:percentage:`` and
  ``:latex-width:`` options.
- HTML output includes keyboard activation, Escape-to-close, focus management,
  focus trapping, and optional per-document gallery navigation through the
  external ``lightbox.js`` enhancement.
- Figure captions and legends remain visible on the page and are copied into
  lightbox overlays.
- Non-HTML builders keep standard image/figure behavior for class-based
  transforms. The ``.. lightbox::`` directive renders LaTeX figures for PDF
  output and plain images for other builders.
- Local image paths are constrained to the Sphinx source tree. Remote and
  ``data:`` images bypass lightbox transformation.
- Generated IDs and user-controlled HTML attributes are sanitized or escaped.
- Documentation is built with Sphinx and published at
  ``https://aputtu.github.io/sphinx-lightbox/``.