Say how a theme from here reaches an instance today #27

Merged

tiagoagueda merged 1 commit from 13-readme into main

2026-11-12 07:30:58 +00:00

tiagoagueda commented

2026-11-11 22:58:53 +00:00

Owner

Refs #13

The install section is rewritten against the core's main: from the official repository or an uploaded wheel, on the data volume, no restart. The issue's third point (the core's CONTRIBUTING still calling this repository a copy, not a package) is a core change, so the issue stays open for it.

🤖 Generated with Claude Code

Refs #13 The install section is rewritten against the core's main: from the official repository or an uploaded wheel, on the data volume, no restart. The issue's third point (the core's CONTRIBUTING still calling this repository a copy, not a package) is a core change, so the issue stays open for it. 🤖 Generated with [Claude Code](https://claude.com/claude-code)

tiagoagueda added 1 commit

2026-11-11 22:58:54 +00:00

Say how a theme from here reaches an instance today

CI / test (pull_request) Successful in 3m36s

Details

CI / Audit the locked dependencies (pull_request) Failing after 2m21s

Details

bd2d47398a

The issue's first two points were settled before this commit: the repository became a
feature plugin that declares a Theme, and it has a LICENSE (AGPL-3.0-or-later) and a NOTICE.
What the README still said about installing was the shell command and a restart, and a
pointer to a "Plugins in the image" section the wiki no longer has.

Read against the core's main: a theme comes only from Postulo or from an installed plugin
(documents/themes.py); plugins are installed by an administrator under Server settings ->
Plugins, from the official catalogue (which lists postulo-templates, its repository row
present and switched off) or from an uploaded wheel, onto the data volume, and are in use
without a restart, while an upgrade over an older release needs one (server_views.py). The
README now says so, keeps the manual install for an instance without a container, points
to the wiki's Plugins section for a baked image, says which release goes with which
Postulo, and that a removed plugin, like one switched off, leaves its documents drawn in
Plain. The exports a theme never sees are now plain text, OpenDocument and Word, and any a
plugin registers (documents/formats.py), not only Word and text.

Refs #13

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

tiagoagueda force-pushed 13-readme from bd2d47398a

CI / test (pull_request) Successful in 3m36s

Details

CI / Audit the locked dependencies (pull_request) Failing after 2m21s

Details

to dee4556179

CI / Audit the locked dependencies (pull_request) Successful in 5m8s

Details

CI / test (pull_request) Successful in 5m52s

Details

2026-11-12 06:39:59 +00:00

Compare