bookstack/website
Fork 4
Code Issues 5 Pull requests Activity

Started v21.06 blogpost

Browse source
This commit is contained in:
Dan Brown 2021-05-30 13:21:04 +01:00
commit 25d923ecf2
Signed by: danb
GPG key ID: 46D9F943C24A2EF9
9 changed files with 196 additions and 14 deletions
Download patch file Download diff file Expand all files Collapse all files

160
content/blog/bookstack-release-v21-06.md Normal file
View file

@ -0,0 +1,160 @@
+++
categories = ["Releases"]
tags = ["Releases"]
title = "BookStack Release v21.06"
date = 2021-05-30T10:32:33Z
author = "Dan Brown"
image = "/images/blog-cover-images/book-collection-fredmarriage.jpg"
slug = "bookstack-release-v21-06"
draft = false
+++
The BookStack v21.06 has now been released which brings us a few new user interface
features and enhancements which include marking items as favourites and easier in-book
navigation.
The previous release, BookStack v21.04, also recieved a bunch of fixes & enhancements during
the last couple of months so we'll also be delving into a few of those changes within this post.
* [Update instructions](https://www.bookstackapp.com/docs/admin/updates)
* [GitHub release page](https://github.com/BookStackApp/BookStack/releases/tag/v21.06)
### Favourites System
For quite a while I've wanted to be able to favourite select content within BookStack for easier future location.
For this release cycle I decided to be a bit selfish and spend a couple of nights getting this implemented.
Thanks to all those that provded feedback in regards to the naming in [GitHub issue 2063](https://github.com/BookStackApp/BookStack/issues/2063).
When viewing a shelf, book, chapter or page while logged in you'll see a new available "Favourite" action:
![BookStack Favourites Action Link](/images/2021/06/favourites-action.png)
Clicking this will add the item to your personal favourites.
Now when you're on the homepage you'll see a list of your most viewed favourites:
![BookStack Favourites Home List](/images/2021/06/favourites-home-list.png)
You can view all your favourites by clicking the header of the homepage list shown above or via
a link within the profile dropdown menu in the header bar:
![BookStack Favourites Link in Profile Menu](/images/2021/06/favourites-profile-menu.png)
This new feature makes it really easy to curate a personal collection of items within the system.
In the future we may able to use this system for other uses; For example, for watching/notification control.
### Next/Previous Page & Chapter Navigation
Much like a physical book, you'll often want to move to the next or previous page when the get to the
bottom of the current one. To support this we now have actions below the page content to move to the
next chapter or page from the current one, within the ordering of the current Book:
![BookStack Next & Previous Content Navigation Preview](/images/2021/06/next-prev-nav.png)
The links are designed to not be distracting by default, like the other non-content interface, but will
become more apparent upon interaction.
Thanks to [@shubhamosmosys](https://github.com/BookStackApp/BookStack/pull/2511) for providing an initial
implementation of this and also a thanks to [@james-geiger](https://github.com/BookStackApp/BookStack/issues/1381#issuecomment-540105003)
for supporting a work-around for this in the mean time.
### Tags Within Search Results
### LDAP User Avatar Import
### Improved Header Accessibility
At mobile screen sizes, v21.04.1
### Dark Mode Updates
v21.04.3 & v21.04.4
### Translations
### Full List of Changes
**Released in v21.06**
* Added shelf/book/chapter/page favourite system. ([#2748](https://github.com/BookStackApp/BookStack/pull/2748))
* Added previous/next navigation to chapters and pages. Thanks to [@shubhamosmosys](https://github.com/BookStackApp/BookStack/pull/2511). ([#2511](https://github.com/BookStackApp/BookStack/pull/2511), [#1381](https://github.com/BookStackApp/BookStack/issues/1381))
* Added display of tags within search results. Thanks to [@burnoutberni](https://github.com/BookStackApp/BookStack/pull/2487). ([#2487](https://github.com/BookStackApp/BookStack/pull/2487), [#2462](https://github.com/BookStackApp/BookStack/issues/2462))
* Added the ability to import JPEG user avatar images during LDAP login/registration. Thanks to [@jasonhoule](https://github.com/BookStackApp/BookStack/pull/2320). ([#2320](https://github.com/BookStackApp/BookStack/pull/2320), [#1161](https://github.com/BookStackApp/BookStack/issues/1161))
* Updated export meta date format to align with the format used in revisions. ([#2771](https://github.com/BookStackApp/BookStack/issues/2771))
* Updated drawing manager system to verify host on post messages for additional security. ([#2769](https://github.com/BookStackApp/BookStack/issues/2769))
* Updated potential external links with `rel="noopener"` for better security . Thanks to [@CorruptComputer](https://github.com/BookStackApp/BookStack/pull/2768). ([#2768](https://github.com/BookStackApp/BookStack/pull/2768))
* Updated drawing upload error handling to better advise when images are too large for the server. ([#2740](https://github.com/BookStackApp/BookStack/issues/2740))
* Updated page deletions to also delete related revisions. ([#2668](https://github.com/BookStackApp/BookStack/issues/2668))
* Updated shelf, book & chapter creation/edit views to autofocus on the name input. ([#1956](https://github.com/BookStackApp/BookStack/issues/1956))
* Fixed issue where user search field could stack too early in certain languages. ([#2147](https://github.com/BookStackApp/BookStack/issues/2147))
**Released in v21.04.1 through v21.04.6**
* Added a way to configure options on a social driver, for the initial redirects, through the `Theme::addSocialDriver` system. ([#2759](https://github.com/BookStackApp/BookStack/issues/2759))
* Added a new `SAML2_IDP_AUTHNCONTEXT` option for SAML2 authentication since the default did not work well for some Windows environments. Thanks to [@ivir](https://github.com/BookStackApp/BookStack/pull/1998). ([#1998](https://github.com/BookStackApp/BookStack/pull/1998))
* Updated mobile header elements for much better keyboard/screen-reader accessibility. ([#2681](https://github.com/BookStackApp/BookStack/issues/2681))
* Updated WYSIWYG editor code-block handling provide a more stable undo/redo experience. ([#2602](https://github.com/BookStackApp/BookStack/issues/2602))
* Updated AWS S3 SDK to fix incompatibility with Minio. ([#2689](https://github.com/BookStackApp/BookStack/issues/2689))
* Updated translations with latest Crowdin changes. ([#2691](https://github.com/BookStackApp/BookStack/pull/2691), [#2695](https://github.com/BookStackApp/BookStack/pull/2695), [#2719](https://github.com/BookStackApp/BookStack/pull/2719), [#2672](https://github.com/BookStackApp/BookStack/pull/2672), [#2737](https://github.com/BookStackApp/BookStack/pull/2737))
* Updated migration string column lengths to better fit within restrictive index limits ([#2710](https://github.com/BookStackApp/BookStack/issues/2710))
* Updated select box styles with to work around default iOS styles causing issues in dark mode. ([#2709](https://github.com/BookStackApp/BookStack/issues/2709))
* Updated styles of layout view buttons in mobile screen sizes to respect dark mode.
* Updated image upload behaviour for s3 style uploads to set public permissions as part of the upload request instead of a separate request.
* Updated Korean translations. Thanks to [@Jokuna](https://github.com/BookStackApp/BookStack/pull/2716). ([#2716](https://github.com/BookStackApp/BookStack/pull/2716))
* Updated table style handling across exports types to be consistent. ([#2666](https://github.com/BookStackApp/BookStack/issues/2666))
* Updated S3 ACL setting so ACLs are set via another request, as per pre-v21.04.2, but only when actually use AWS S3. ([#2739](https://github.com/BookStackApp/BookStack/issues/2739))
* Updated overflowing table content to be consistent. Thanks to [@dopyrory3](https://github.com/BookStackApp/BookStack/pull/2735). ([#2735](https://github.com/BookStackApp/BookStack/pull/2735), [#2732](https://github.com/BookStackApp/BookStack/issues/2732))
* Updated export system to remove JavaScript used in Custom HTML Head Content to prevent errors or strange behaviour. ([#2490](https://github.com/BookStackApp/BookStack/issues/2490))
* Improved error messaging when attempting to access a non-existent image file. ([#2696](https://github.com/BookStackApp/BookStack/issues/2696))
* Fixed issue where "Recently Viewed" would show non-viewed content for new users. ([#2703](https://github.com/BookStackApp/BookStack/issues/2703))
* Fixed issue where a page could become inaccessible when the creator no longer existed. ([#2687](https://github.com/BookStackApp/BookStack/issues/2687))
* Fixed HTTP JSON detection when an encoding is in the response JSON content type. ([#2684](https://github.com/BookStackApp/BookStack/issues/2684))
* Fixed page export error thrown when the created by, or last updated by user, had been deleted. ([#2733](https://github.com/BookStackApp/BookStack/issues/2733))
* Fixed white borders on layout buttons when in dark mode when using Safari. ([#2728](https://github.com/BookStackApp/BookStack/issues/2728))
* Fixed error during PDF export in some cases due to incorrect path. ([#2746](https://github.com/BookStackApp/BookStack/issues/2746))
* Fixed error thrown when saving a markdown page with empty content. ([#2741](https://github.com/BookStackApp/BookStack/issues/2741))
* Fixed scenario where recent Image upload visibility changes caused issues on hosting where webserver and PHP process group/user differ. ([#2758](https://github.com/BookStackApp/BookStack/issues/2758))
### Next Steps
As planned for this release cycle, I've talked a good chunk of the outstanding pull requests on GitHub. I'll look to continue this for another release
cycle as I'd ideally want to address most of these before updating the Laravel framework version, which will soon be due.
To start thinking about our next "Editor Review" roadmap stage, I've [opened a scoping issue on GitHub](https://github.com/BookStackApp/BookStack/issues/2738) to gain feedback on potential options. If you have experience on developing with any of the options posted then feedback is appreciated. I'll be looking to dig a little deeper into this within the next release cycle or two.
### Donating to BookStack
Donations are always something I used to stay away from. I always thought that people should spend their money
on more worthy causes, since I didn't really need the money myself nor would I expect it to have a
significant impact on the project. That said, people really wanted to provide dontations and it was raised
mulitple times. Ideas like bug-bounties were floated but I never wanted money to be a core motivator
for BookStack features and efforts.
After thinking it through over the last few years, I realised that donations could be used for the following:
1. Support & forward on the donations to the projects & people that BookStack is built upon.
2. Gauge the feasibility of using the income to potentially one day work on open source full time.
The second idea is a bit of a pipe-dream but for now I'll focus on the first, supporting other projects. Since the end of last year I've been testing out utlising GitHub sponsors:
<iframe src="https://github.com/sponsors/ssddanbrown/button" title="Sponsor ssddanbrown" height="35" width="116" style="border: 0;" loading="lazy"></iframe>
Within GitHub sponsors are mulittude of options for one-off and monthly donations.
As my donations build up I'll look to support other projects and people.
If the donations ever get to a point where they could support me working on open source full time, I'll likely change focus and only support myself
until I could get to a point of stable sustainability to be able to then support other projects again.
----
<span style="font-size: 0.8em;opacity:0.9;">Header Image Credits: <span>Photo by <a href="https://unsplash.com/@fredmarriage?utm_source=unsplash&amp;utm_medium=referral&amp;utm_content=creditCopyText">freddie marriage</a> on <a href="https://unsplash.com/?utm_source=unsplash&amp;utm_medium=referral&amp;utm_content=creditCopyText">Unsplash</a></span></span>