Skip to content

Clarify and expand documentation for thumbnail / preview functionality #424

@MiguelAntonioRS

Description

@MiguelAntonioRS

The functionality for generating, customizing, and displaying thumbnails/previews (for images, documents, etc.) is crucial but documentation is a bit sparse in some areas. For example, how thumbnail sizes are configured, how caching works, how fallback behavior functions when preview generation fails.

Proposed Work:

Add a section in the docs that describes all available thumbnail / preview settings, with examples (settings.py, template tags).

Document how to override thumbnail templates or styling in Grappelli + FileBrowser.

Describe what happens when a preview cannot be generated (file type not supported, missing libs, etc.).

Possibly provide a small example with automatic cleanup of old thumbnails / cache.

This will help developers using the package to better integrate preview behavior and avoid surprises.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions