Links
Upgrade Notices
- Page Include Tags - Nesting is now allowed for include tags, up to 3 levels of depth. You may now see more content loaded for pages which previously had unparsed nested include tags.
- SAML2 - Single LogOut (SLO) requests will now include a "session_index" for the current user. This technically brings BookStack's implementation closer to the spec, and is not expected to cause issues, but if using SLO it may be wise to check your identity provider behavior remains the same as before during logout.
- Custom Code Block Themes - Due to a change of library, the method of defining custom codeblock themes has significantly changed, and "window.CodeTheme" code is no longer used. Refer to our "Changing Code Block Themes" documentation for further information.
- Editor Event - editor-markdown::setup - This event no longer contains "codeMirrorInstance" in the event data. It instead has a "cmEditorView" property. See the event docs for more details.
- Editor Event - editor-markdown-cm::pre-init - This event has been renamed to "editor-markdown-cm6::pre-init" and no longer contains "config" in the event data. It instead has a "editorViewConfig" property. See the event docs for more details.
- Upload Timeouts - The use of "window.uploadTimeout" has been removed as a way to control upload timeouts. This would previously only be used in certain cases. Instead, if required, timeouts can usually be enforced at the web-server level.
Full List of Changes
- Added system CLI for admin operations. (#4206, #3149)
- Added image gallery API Endpoints. (#4103)
- Added content permission API endpoints. (#2702, #4099)
- Added new logical theme event to customize OIDC ID token data. (#4200)
- Added Clojure syntax highlighting for code blocks. (#4112)
- Added option to disable SSL verification with SMTP email sending. Thanks to @vincentbernat. (#4126, #3166)
- Added support for three-levels of nested include tags. Thanks to @jasonF1000. (#4192, #2845)
- Added detailed documentation for public JS events. (#4179)
- Added standard JS codebase formatting via ESLint. (#4181, #4180)
- Updated code blocks & markdown editor to CodeMirror 6. (#3617, #3518)
- Updated file upload handling for images and attachments. (#4193)
- Updated SAML2 SLO requests to include a session index. (#3936)
- Updated translations with latest Crowdin changes. (#4163)
- Fixed audit log type filter leading to wrong location. (#4201)
- Fixed large videos within content escaping content area. Thanks to @chopin2712. (#4204)
- Fixed missing WKHTMLTOPDF in .env.example.complete file. Thanks to @7nohe. (#4145)
- Fixed not being able to search for terms containing backslashes . Thanks to @esakkiraja100116. (#4202, #4175)
- Fixed timestamp in API docs example chapter response. Thanks to @tigsikram. (#4191)