Static resources for the Euphorie project

This repository contains static resources for the Euphorie project.

Updating the package

In order to properly update the package, you will need some development tools to be installed, i.e:

• git
• make
• rsync
• Ruby

Optionally, you can install gitman to manage the checkouts.

Updating the site is a three-step process.

1. you need to fetch a fresh clone of the Euphorie prototype.
2. you need to compile the resources.
3. you need to install the resources in the Euphorie package.

This can be done by running the following command:

make all

Run:

make help

to see all available commands and fine tune the build experience.

Fetching a fresh clone of the Euphorie prototype

To update the repository, run the command:

make update-proto

The clone will be placed in the var/prototype directory.

Running make all will take care of running this command for you.

Compiling the resources

The resources are compiled using the static site generator Jekyll. The compiled site can be found in the var/prototype/_site directory.

To compile the resources, run the command:

make jekyll

This command will also clone (but not update) the Euphorie prototype if it is not already present.

Running make all will take care of running this command for you.

Installing the resources in the Euphorie package

The compiled prototype in var/prototype/_site needs to be copied in this package. Only selected resources will be copied and they will end up in the src/plonestatic/euphorie/resources directory.

The resources directory will be served by Plone as a static resource folder under the path ++resource++euphorie.resource.

While doing the copy, some references to the other resources in CSS and HTML files have to be rewritten to adjust to the new location, e.g. /assets/... will be rewritten to /++resource++euphorie.resource/assets/....

The command to install the resources is:

make resources-install

Running make all will take care of running this command for you.

Changelog

2.0.0 (2026-07-14)

Breaking changes:

• Replace pkg_resources namespace with PEP 420 native namespace. Support only Plone 6.2 and Python 3.10+. (Issue #3928)

1.1.0 (2026-06-23)

New features:

• Update of the italian help, reflecting the wishes of the IT oira partner as requested. (Issue #4797)
• Update to the latest proto. @ale-rt (Issue #4797)

Internal:

• The script that copies the resources now warns at 60MB. @ale-rt (Issue #4797)

1.0.3 (2026-05-13)

Bug fixes:

• Remove stale help file created only for testing (Issue #4822)

1.0.2 (2026-04-10)

Bug fixes:

• Update the resources, increase the size of the package. Fix an issue with a missing css resource triggering an error in the backend. @ale-rt (Issue #3642)

1.0.1 (2025-12-09)

Bug fixes:

• Update Prototype to fix a problem with some previews not shown in help pages.

  Note: This uses the submodule "_includes/patterns" branch "reverse-sentinel" from https://github.com/Patternslib/patterns-includes/pull/3

  Ref: scrum-3430 [thet]

Internal:

• Fix towncrier config.

1.0.0 (2025-07-15)

Bug fixes:

• Add missing example report images (used by @@register_session) Also extend the Makefile to automatically include these images when building plonestatic.euphorie. (#3709)
• Script replacement: Also support version/release-level specific subdirectories of the Patternslib script in prototype like alpha/, beta/, etc. [thet]

1.0.0a5 (2025-03-27)

• Add a missing image used by the Euphorie package

• Use gitman if it is available [ale-rt]

• major update of help, fixing broken links, missing images and pages, new illustration files [pilz]

1.0.0a4 (2025-02-20)

• Update to the most recent markup

1.0.0a3 (2025-02-04)

• Fix link to patternslib

1.0.0a2 (2025-02-04)

• Add missing resources

1.0.0a1 (2025-02-03)

• Initial release