-
Notifications
You must be signed in to change notification settings - Fork 0
Generated Site
cr4te writes a static HTML site to the output folder.
The generated site includes:
site/
|-- index.html
|-- projects.html
|-- tags.html
|-- html/
|-- assets/
|-- thumbnails/
|-- symlinks/
index.html is the creator overview page.
It includes:
- Creator cards rendered as either portrait image cards or text cards, depending on
site_rendering.galleries.creator_cards.display_mode - Search
- Media and project counts
- Links to creator pages
- Theme selector
projects.html is the project overview page.
It includes:
- Project cards
- Creator names as secondary card text
- Search
- Media count badges
- Links to project pages
tags.html groups tags and tag-like facet values into action-menu chips. Each menu can filter the creator overview or project overview for that tag. Clickable project metadata links still open the project overview directly with a tag query.
Generated creator and project pages live under html/.
The exact file paths are hashed and nested for stability and collision resistance, rather than being simple slug paths.
Creator pages can show:
- Portrait
- Metadata
- README description
- Tags
- A combined projects section with solo and collaboration project cards
- Collaboration context as secondary text on collaboration project cards
- Creator-level media
Project pages can show:
- Cover/preview image
- Metadata and facets
- README description
- Tags
- Creator or collaboration profile block
- Participants for collaborations
- Project media
Creator and project page titles are exposed in the global breadcrumb area rather than as separate visible title strips. The accessible page title remains present for assistive technology.
assets/ contains generated site CSS, JavaScript, default thumbnails, and the favicon. Built-in and selected custom themes are copied to assets/css/themes/.
See Custom Themes for custom theme authoring and build behavior.
thumbnails/ contains generated thumbnails for overview cards, creator page project cards, gallery images, and source-backed detail-page images. Text-mode creator overviews create no creator-overview thumbnails. Detail-page image roles set to hide create no thumbnails for that role. Detail-page image roles set to show prepare generated defaults for missing or unusable sources. Detail-page image roles set to if_available create source thumbnails only when a usable source image exists.
When rebuilding, cr4te keeps the thumbnail folder by default if the output directory already exists. Source-derived thumbnails are reused when their cached freshness metadata still matches the source file path, byte size, modified time, and thumbnail recipe. Use --clear-thumbnail-cache to regenerate thumbnails from scratch when you do not trust preserved source timestamps or want to discard the thumbnail cache.
symlinks/ contains staged links to original media files. cr4te uses stable hashed paths so generated pages can refer to media without exposing or depending on the original folder names.
See Media and Galleries for media staging details.
The generated site has no backend. Browser JavaScript powers:
- Search
- Pagination
- Theme switching
- Lightbox
- Captions toggle
- Audio player
- Video player
- Responsive layout adjustments
Theme and media volume/mute state use browser localStorage.