bookstack/website
Fork 4
Code Issues 5 Pull requests Activity

Proof read v25.02 blogpost

Browse source
This commit is contained in:
Dan Brown 2025-02-25 11:11:39 +00:00
commit af3543cbad
Signed by: danb
GPG key ID: 46D9F943C24A2EF9
1 changed files with 10 additions and 9 deletions
Download patch file Download diff file Expand all files Collapse all files

19
content/blog/2025/bookstack-release-v25-02.md
View file

@ -10,8 +10,9 @@ draft = false
+++
Today we release BookStack v25.02! This aimed to be a maintenance
release to upgrade the core framework, but it also introduces
automatic sorting along with some other enhancements.
release with the primary goal of upgrading our core framework, but it
grew a little to include some goodies like automatic sorting,
theme system additions, and editor improvements.
* [Update instructions](/docs/admin/updates)
* [GitHub release page](https://github.com/BookStackApp/BookStack/releases/tag/v25.02)
@ -46,12 +47,12 @@ view for a book:
![View of the Book sort view, with the mouse hovering over a "Name sort" option within a "Auto Sort Option" dropdown](/images/2025/02/book-autosort-option.png)
It's also possible to configure a default sort rule to assign to any new
created books. This is also part of the new "Sorting" settings page.
created books. This is part of the new "Sorting" settings page.
These sort rules will then automatically run on events which may alter the sort order,
like page/chapter create/update.
like page/chapter create/update events.
The operations within a sort rule can be updated as needed, and upon save
any assigned books will be automatically sorted to use the new order.
any assigned books will be automatically re-sorted to use the new order.
For those that want to assign a sort rule to their existing books, [a new
command](/docs/admin/commands/#assign-sort-rule) has been added to make this easy.
@ -60,10 +61,10 @@ This has various options for batch assigning sort rules to books.
### Search Indexing Improvements
The way BookStack indexes content for search now follows more advanced logic
for this release to address some common limitation faced.
for this release to address some common limitations faced.
Specifically, single terms containing certain punctuation like `.` periods
would have previously been split, leaving any searches for terms like "24.5"
falling back to slower exact matches.
falling back to slower (and non-score based) exact matches.
As of v25.02, BookStack will now index the non-split term in addition to the split term,
allowing both to match with indexed and scored results.
@ -100,7 +101,7 @@ While there were some methods to work around this, BookStack now provides a
direct way using the theme system via simply creating a `public` directory
within your theme folder.
Any files within this folder will then be served at the `theme/<theme_name>/`
location of your BookStack instance.
url path of your BookStack instance.
For full details, see the added ["Publicly Accessible Files"](https://github.com/BookStackApp/BookStack/blob/development/dev/docs/visual-theme-system.md#publicly-accessible-files) section of the visual theme system documentation.
@ -184,4 +185,4 @@ out via patch releases instead of waiting for a full release.
----
<span style="font-size: 0.8em;opacity:0.9;">Header Image Credits: <span>Photo by <a href="https://commons.wikimedia.org/wiki/File:Howden_Dam_Upper_Derwent_Reservoir_2023_01.jpg">Julian Herzog (CC-BY-4)</a> - Image Modified</span></span>
<span style="font-size: 0.8em;opacity:0.9;">Header Image Credits: <span>Photo by <a href="https://commons.wikimedia.org/wiki/File:Howden_Dam_Upper_Derwent_Reservoir_2023_01.jpg">Julian Herzog (CC-BY-4)</a> - Image Modified</span></span>