-This laggard of a release finally lingers to deployment this October day bringing the first alpha-state inclusion of the new WYSIWYG editor which has been the main development focus, but that doesn't stop a few other goodies being included for this release too!
+This laggard of a release finally lingers to deployment this day in October bringing the first alpha-state inclusion of the new WYSIWYG editor, which has been the main development focus, but that doesn't stop a few other goodies being included for this release too!
* [Update instructions](/docs/admin/updates)
* [GitHub release page](https://github.com/BookStackApp/BookStack/releases/tag/v24.10)
* [Update instructions](/docs/admin/updates)
* [GitHub release page](https://github.com/BookStackApp/BookStack/releases/tag/v24.10)
Initially our goal is to match the existing editor functionality & layout as close as possible
to ensure a stable & familiar upgrade path, so it should look much the same:
Initially our goal is to match the existing editor functionality & layout as close as possible
to ensure a stable & familiar upgrade path, so it should look much the same:
-This is an initial alpha revision of this editor though, so there are some known omissions, weak-points along with a range of issues to solve, which I'm listing & taking feedback for [on a GitHub issue here](https://github.com/BookStackApp/BookStack/issues/5245). The biggest limitation right now is the lack of specific mobile support.
+This is an initial alpha revision of this editor so there are some known omissions & weak-points along with a range of issues to solve, which I'm listing & taking feedback for [on a GitHub issue here](https://github.com/BookStackApp/BookStack/issues/5245). The biggest limitation right now is the lack of specific mobile support.
-TODO - Image of controls
+
+
-Be wary though that the new editor right now can be less reliable, and specific content support can differ leading to loss of formatting in edge cases that may have been previously allowed.
-I don't advise it's use in production scenarios right now, it's primarily in this release for wider testing to gain feedback for.
+Be wary though that, in its current state, the new editor can be less reliable, and specific content support can differ leading to loss of formatting in edge cases that may have been previously allowed.
+I don't advise its use in production scenarios right now, it's primarily in this release for wider testing to gain feedback.
-This new editor is quite a significant undertaking. The editor controls UI is completely custom built from scratch and the core editing is based upon the [Lexical library](https://lexical.dev/), although I made the decision to fork the lexical codebase into BookStack quite late in development due to some incompatible core design decisions made in lexical. This quite massively increases the maintenance surface area, but also provides us more control and possibilities around a fundamental part of BookStack. I'm thinking that as my funding continues to grow, it might even be possible to fund someone to help work part time specifically on some of the growing JavaScript/TypeScript components. This is all a bit of an experimental jump though, so I'll be thinking about maintainability and sustainability quite a lot as we mature this editor over the next few releases.
+This new editor is quite a significant undertaking. The editor UI controls are completely custom built from scratch and the core editing is based upon the [Lexical library](https://lexical.dev/), although I made the decision to fork the lexical codebase into BookStack quite late during development due to some incompatible core design decisions made in lexical. This quite massively increases the maintenance surface area, but also provides us more control and possibilities around a fundamental part of BookStack. I'm thinking that as my funding continues to grow, it might even be possible to fund someone to help work part time specifically on some of the growing JavaScript/TypeScript components. This is all a bit of an experimental jump though, so I'll be thinking about maintainability & sustainability quite a lot as we mature this editor over the next few releases.
-Going forward, we'll continue to improve and stabilize this editor over the next few releases to get it into a beta status, before eventually later making it the default WYSIWYG option. Then, in quite a few releases later, we'll remove the existing TinyMCE based editor. Making this a stable and easy switch-over for 99% of users is super important to me.
+Going forward, we'll continue to improve and stabilize this editor to get it into a beta status, before eventually later making it the default WYSIWYG option. Then, in quite a few releases later, we'll remove the existing TinyMCE based editor. It's super important to me that this is a stable and easy switch-over for 99% of users.
- which does **not** have permissions set
This opens up search to a whole range of more advanced scenarios.
- which does **not** have permissions set
This opens up search to a whole range of more advanced scenarios.
BookStack will now advertise OpenSearch support to browsers.
I don't mean the Amazon fork of ElasticSearch, but [the standard](https://developer.mozilla.org/en-US/docs/Web/OpenSearch) used to tell
browsers about the search functions of a website.
For example, FireFox will now show an instance as an option to add for searching:
BookStack will now advertise OpenSearch support to browsers.
I don't mean the Amazon fork of ElasticSearch, but [the standard](https://developer.mozilla.org/en-US/docs/Web/OpenSearch) used to tell
browsers about the search functions of a website.
For example, FireFox will now show an instance as an option to add for searching:
-When added, I can then at any point perform a search via my BookStack instance using the FireFox URL/Search bar. While this was possible to set up before, this automates much of the tedious setup work.
+When added you can then, at any point, perform a search via the added BookStack instance using the FireFox URL/search bar. While this was possible to set up before, OpenSearch support automates much of the tedious setup work.
Different browsers use this in different ways though, so how it presents in other browsers may differ.
A big thanks to [@maximilian-walter](https://github.com/BookStackApp/BookStack/pull/5198) for providing this feature to BookStack.
### R & SAS Code Block Support
Different browsers use this in different ways though, so how it presents in other browsers may differ.
A big thanks to [@maximilian-walter](https://github.com/BookStackApp/BookStack/pull/5198) for providing this feature to BookStack.
### R & SAS Code Block Support
### PDF Timeout Option
In the [last release we added](/blog/bookstack-release-v24-05/#command-based-pdf-export-option)
the command-based PDF export option which allowed PDF exports to be generated using a custom command.
### PDF Timeout Option
In the [last release we added](/blog/bookstack-release-v24-05/#command-based-pdf-export-option)
the command-based PDF export option which allowed PDF exports to be generated using a custom command.
-One limitation of this was the default 15 second process timeout, which was found to be fairly limiting in some scenarios, so this timeout is not configurable:
+One limitation of this was the default 15 second process timeout, which was found to be fairly limiting in some scenarios, so this timeout is now configurable:
within a new BookStack instance but if email has not been configured correctly & tested, this can result in an error when BookStack tries to send the invite. Previously this would just result in a generic error screen, leaving the admin needing to hunt around in error logs to understand what went wrong.
From this release we now specifically show an error notification to explain the scenario, while returning the admin back to the user creation form with the existing data-prefilled.
within a new BookStack instance but if email has not been configured correctly & tested, this can result in an error when BookStack tries to send the invite. Previously this would just result in a generic error screen, leaving the admin needing to hunt around in error logs to understand what went wrong.
From this release we now specifically show an error notification to explain the scenario, while returning the admin back to the user creation form with the existing data-prefilled.
This is thanks to Crowdin member "KateBaber"'s continuous work over the last 10 months to develop out these Welsh translations.
Of course there's been plenty of other great efforts by our translators, so a big thanks to the
This is thanks to Crowdin member "KateBaber"'s continuous work over the last 10 months to develop out these Welsh translations.
Of course there's been plenty of other great efforts by our translators, so a big thanks to the
-Efforts will be focused on maturing the new editor over the next release cycle, addressing issues raised in its wider testing. Build of the new editor introduces TypeScript into the BookStack codebase, so I'll likely also look to migrate more of our original JS code to TS.
+Efforts will be focused on maturing the new editor over the next release cycle, addressing issues raised in its wider testing. Build of the new editor introduces TypeScript into the BookStack codebase, so I'll probably look to migrate more of our original JS code to TS.
-It'd be nice to get back to some other features though, so I may also pick out a long-standing desired feature to focus on otherwise this year looks a bit thin due to focusing on maintenance work and like-for-like replacements of existing functionality.
+It'd be nice to get back to some other features though, so I may also pick out a long-standing desired feature to focus on otherwise this year looks a bit thin due to so far focusing on maintenance work and like-for-like replacements of existing functionality.
projects / website / commitdiff
