Release Notes for Cristal 0.14

Last modified by Manuel Leduc on 2025/01/28

This is the release notes for Cristal.

The main improvement of this release is the ability to move and rename pages on the file system backend. Additionally, it is now possible to update the configuration of electron instance manually. Also, the file system and Nextcloud backends are now initialized with default content. Finally, users are now warned when leaving the editor with unsaved content.

Note for translators: While there is currently no easy way to switch languages, we started extracting translatable text info a format that can be exploited by Weblate. You can already start translating a few translation keys.

Cristal is still under heavy development.

  • All APIs are subject to be changed without notice
  • A lot of features are subject to limitations that will be removed over time
  • See the Roadmap page to see what we plan to work on in the next releases

New and Noteworthy (since Cristal 0.13)

Full list of issues fixed and Dashboard for 0.14.

For Users

Default content for the file system and Nextcloud backends

 
Until now, opening the file system backend or the Nextcloud backend could be a confusing experience as users were presented with empty content.
Now, the first time a file system or Nextcloud backend are accessed, a minimal default content is created, allowing users to start using the wiki more easily.

Page move and page rename for FileSystem

 
The page actions now include a Move action and a Rename action, that can be used to change the location of a page, and optionally the location of its children. These are only supported for the FileSystem backend so far.

 
Now, the external links on an XWiki document are marked properly with an icon.

Warning when leaving the editor with unsaved content

 
Users are now warned when leaving the editor with unsaved content. Either by navigating through internal links, or by closing the current tag (or window in the case of Electron).

Miscellaneous

  • It is now possible to add configurations manually for electron: When starting an electron instance for the first time, a config.json file is initialized in the most relevant place based on the default settings of the operating system:

    • %APPDATA% on Windows
    • $XDG_CONFIG_HOME or ~/.config on Linux
    • ~/Library/Application Support on macOS

    Once created, it is possible to manually edit this file to add new configurations. See the backends section for more details.

  • Page creation menu simplification: The Page Creation process has been streamlined by removing unnecessary fields.

For Admins

No changes!

For Developers

New configuration API

 
A configuration API is now available, allowing to access the configuration in specific ways based on how the UI is launched (e.g., in a web page or part of an electron application).

Checkbox component

 
A XCheckbox component was introduced to the design systems (both Shoelace and Vuetify), to be used in XForm environments.

Upgrades

The following runtime dependencies have been upgraded (they have a different release cycle than XWiki Commons, XWiki Rendering and XWiki Platform):

Security Issues

Security issues are not listed in issue lists or dashboards to avoid disclosing ways to use them, but they will appear automatically in them once they're disclosed. See the XWiki Security Policy for more details.

Known issues

Credits

France 2030 Logo

This project is being financed by the French State as part of the France 2030 program

Ce projet est financé par l’État Français dans le cadre de France 2030

The following people have contributed code to this release (sorted alphabetically):

  • Manuel Leduc
  • Pierre Jeanjean
  • Simpel
  • Thiago Krieck
  • xrichard

Get Connected