]> BookStack Code Mirror - website/blobdiff - content/blog/2025/bookstack-release-v25-02.md
Updated v25.02 post time
[website] / content / blog / 2025 / bookstack-release-v25-02.md
index fbd5c8d10cd015f533c4e3eb57d5e75f10ea15dd..374e48c284a0e7ed903e40eeb861dd135e6f2e56 100644 (file)
@@ -2,7 +2,7 @@
 categories = ["Releases"]
 tags = ["Releases"]
 title = "BookStack Release v25.02"
-date = 2025-02-27T12:00:00Z
+date = 2025-02-26T14:30:00Z
 author = "Dan Brown"
 image = "/images/blog-cover-images/cc-by-4/resevoir-julian-herzog.jpg"
 slug = "bookstack-release-v25-02"
@@ -10,22 +10,20 @@ 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)
 
 **Upgrade Notices**
 
-TODO - Copy to updates page
-
-- **PHP Version Requirement Change** - The minimum supported PHP version has changed from PHP 8.0.2 to PHP 8.1 in this release. Please see our ["Updating PHP & Composer" documentation page](/docs/admin/updating-php/#updating-php) for guidance on updating PHP where needed.
+- **PHP Version Requirement Change** - The minimum supported PHP version has changed from PHP 8.1 to PHP 8.2 in this release. Please see our ["Updating PHP & Composer" documentation page](/docs/admin/updating-php/#updating-php) for guidance on updating PHP where needed.
 - **Sorting** - Basic sort order changes for chapters and pages will no longer affect the "updated" time for these items. Wider changes during sorting (moving to a new parent) will still increment the "updated" time.
 - **Theme System** - A `public/` folder within an active theme folder will now be exposed for public access. If for some reason you already have such a folder that you don't want exposed, rename it before upgrading.
 
-TODO - Video
-<!-- {{<pt imWKrALvSwokP3vrjRdUXh>}} -->
+{{<pt iUZWrk4oxLYc2dFsAPjDyY>}}
 
 ### Automatic Sorting with Sort Rules
 
@@ -46,12 +44,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 +58,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 +98,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 +182,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>
\ No newline at end of file
+<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>