Beta Release v0.21.0

A new version of BookStack is here. Version 0.21 improves upon a number of existing features in addition to bringing its own new capabilities to BookStack. If you are updating to this release from v0.20.0 or before it’s also worth reviewing the hefty update v0.20.1 which included a good number of fixes and improvements itself.

New Team Member

Before we dive into the depths of the new features in this release I’d like to announce that BookStack team has grown a little bit. Abijeet is now an official maintainer of BookStack. Abijeet has contributed on a good number of features now and pretty much every recent release includes features or improvements provided by Abieet. In addition, he frequently helps with GitHub issues.

By being an official maintainer he now has the ability to contribute quicker and to manage issues easier without me jumping in. Welcome Abijeet.

Media Embed Support

For this release Abijeet has added media embedding to the WYSIWYG editor. This makes it really easy to include videos and media from other websites in your pages. Here’s a quick preview of how easy embedding a YouTube video is:

For those that prefer the Markdown editor, You already have the ability to insert HTML directly in the editor so you can directly insert any embed code from external sources.

Page Copying

It’s now possible to directly copy a page. You can find a new ‘Copy’ option in the ‘More’ menu at the top-right when viewing a page. When copying you’ll have the option to change the name and alter the destination of the copied page. To be able to copy a page the user will need ‘create’ permissions for the book or chapter the page is to be copied into.

Tag System Update

Previously you could only apply tags to pages but this has now been rolled out to books and chapters. This can be found in the edit view of both. These tags can be searched upon just as you currently can with pages.

Configurable Robots.txt

The robots.txt file of a website tells web crawlers, such as Google’s page indexer, whether your site should be crawled and indexed. Previously in BookStack this was set to always allow web crawlers. This file has now been made dynamic and will change depending on the “Allow public viewing?” setting.

Alternatively you can force the value of the robots.txt by setting ALLOW_ROBOTS=false, or ALLOW_ROBOTS=true, in the .env file. This will take priority over the “Allow public viewing?” setting.

If you want to customise the contents of this file you are able to do this, without editing BookStack source files, via the theme override system.

Language Support

Thanks to @jasoncheng7115 we now have traditional Chinese as a language option in BookStack. Upon this addition, the following languages have been updated:

Full List of Changes

  • Added the ability to insert videos via the WYSIWYG editor. Thanks to @Abijeet. (#768#266
  • Added the ability to copy a page. (#673)
  • Rolled out tag system to chapters and books. (#121)
  • Updated export image processing to include images when using “local_secure” option. (#786)
  • Robots.txt file is now dynamic and configurable. (#779)
  • Added traditional Chinese translations. Thanks to @jasoncheng7115. (#780)
  • Updated Spanish translations. Thanks to @moucho. (#783)
  • Updated ‘Spanish Argentina’ translations. Thanks to @leomartinez. (#806)
  • Updated German translations. Thanks to @abno85. (#798)
  • Updated Japanese translations. Thanks to @msaus. (#767)
  • Updated ‘Reset Password’ flow with newer design (#800)
  • Fixed issue where old books would not update with cover image on save. (#773)
  • Added proper permission checking when moving pages and chapters (cdb1c7ef)

Next Steps

For this release I was hoping to bring in proper revision control for drawings to finish that feature off but I did not find the time so that will be my focus for the next release. I believe Abijeet may be looking to add the ‘All Books’ listing as a homepage option.

For other features please ensure you add a ‘Thumbs-up’ reaction on the parent post of any GitHub issue for desired features as it’s a really helpful way to identify the most requested features.


Header Image Credits:   unsplash-logoGiammarco Boscaro