From: Dan Brown Date: Tue, 31 Jan 2023 11:33:08 +0000 (+0000) Subject: Finalized v23.01 post, updated npm deps X-Git-Url: http://source.bookstackapp.com/website/commitdiff_plain/refs/remotes/twindscheif/2301 Finalized v23.01 post, updated npm deps --- diff --git a/content/blog/bookstack-release-v23-01.md b/content/blog/bookstack-release-v23-01.md index 0449bc9..7caa1a6 100644 --- a/content/blog/bookstack-release-v23-01.md +++ b/content/blog/bookstack-release-v23-01.md @@ -2,32 +2,31 @@ categories = ["Releases"] tags = ["Releases"] title = "BookStack Release v23.01" -date = 2023-01-31T12:00:00Z +date = 2023-01-31T11:45:00Z author = "Dan Brown" image = "/images/blog-cover-images/snow-doggo-tadeusz-lakota.jpg" slug = "bookstack-release-v23-01" draft = false +++ -To start off our releases for the year we have v23.01 which adds many user experience enhancements and -options while also making subtle back-end further changes to permissions. +To start off our releases for the year we have BookStack v23.01 which adds many user experience enhancements & +options while also making subtle further back-end changes to permissions. * [Update instructions](https://www.bookstackapp.com/docs/admin/updates) * [GitHub release page](https://github.com/BookStackApp/BookStack/releases/tag/v23.01) **Upgrade Notices** -- **Permission Changes** - There have been changes to the permission system which can affect how permissions apply and therefore could lead to changes in provided abilities upon update. This is only really relevant to complex permission scenarios that have only been possible since BookStack v22.10. Please see the [Permission System Changes](#permission-system-changes) section below for more details on this. -- **Database Upgrade Time** - Changes to the permission system have required permissions to be regenerated upon update. Due to this, the `php artisan migrate` upgrade step may take extra time to run, especially where there's a lot of content and/or roles in the system. +- **Permission Changes** - There have been changes to the permission system which can affect how permissions apply and therefore could lead to changes in provided abilities upon upgrade. This is only really relevant to complex permission scenarios that have only been possible since BookStack v22.10. Please see the [Permission System Changes](#permission-system-changes) section below for more details on this. +- **Database Upgrade Time** - Changes to the permission system have required permissions to be regenerated upon upgrade. Due to this, the `php artisan migrate` upgrade step may take extra time to run, especially where there are a lot of content and/or roles in the system. -TODO - YouTube - +{{}} ### App Icon Control We have a new customization setting! -This addition allows the upload and easy setting of a custom application icon that will be used -by browsers as the icon for a tab, or often by mobile devices to use as an "App" icon when creating a +This addition allows the upload and easy use of a custom application icon that will be utilized +by browsers as the tab icon, or often by mobile devices to use as an "App" icon when creating a webpage shortcut. ![Screenshot of an "Application Icon" setting with a preview image showing a cat](/images/2023/01/app_icon_setting.png) @@ -39,7 +38,7 @@ across different browsers, devices and platforms. ![A row of mobile app icons, with a BookStack-labelled cat icon in the centre](/images/2023/01/mobile_app_icon.webp) -While you could already hack-in a custom icon via various means, this should it much easier and accessible +While you could already hack-in a custom icon via various means, this should make it much easier and accessible to those that don't want to hack about with code or web-servers. ### New Color Scheme Controls @@ -57,7 +56,7 @@ so hopefully this will be quite a welcome addition to address that concern. A more subtle addition to the color controls is a new "Default Link Color" option. Links and actions within the interface would previously use the primary color, but this could be problematic since the primary color was also used for many non-text focused use-cases such as the header banner and other decorations -which made choosing a color, which worked across all these areas, difficult to achieve. +which made choosing a color, which worked well across all these areas, difficult to achieve. Splitting these out now provides a little more control to get the right look with great usability. ![Screenshot of a page view in BookStack, showing different colors between the actions sidebar and header banner](/images/2023/01/app_link_color_usage.png) @@ -69,22 +68,22 @@ auto-copied across to ensure minimal change upon system update, although you can ### Book Sorting Experience Upgrades The book sort interface has received a fair bit of attention to make the experience more pleasant than ever. -The changes here were primary to ensure usability via screen-reader and keyboard-only-use, but such changes can -have a positive impact to all users. Changes include: +The changes here were primarily to ensure usability via screen-reader and keyboard-only-use, but such changes can +have a positive impact to all. Changes include: -- Sort items will now show up & down buttons to allow quick sorting without drag+drag. +- Sort items will now show up & down buttons to allow quick sorting without drag+drop. - A new menu on sort-items provides a range contextual actions such as "Move to Next Book" or "Move to Previous Chapter". -- Multi-select and drag, once previously available, has now been fixed. +- Multi-select and drag, once previously available but since broken, has now been fixed. - The "Other books" sidebar is now sticky on desktop, meaning you don't need to scroll back up to find this box when sorting long books. -- The book sort boxes are now collapsible, which can useful when sorting multiple large books. +- The "book" sort boxes are now collapsible, which is useful when sorting multiple large books. - Sort items show drag-handles to make it clear you're able to drag & drop. - Some intro text has been added to help guide users. ![Screenshot of the BookStack sort view for a book, featuring a collapsed book and a dropdown menu providing move actions for a page](/images/2023/01/book_sort.png) -### Code Block Additions +### Code Language Additions -Since v22.11 a few new code languages have been added for code-highlighting and code-editor support: +Since the original v22.11 release a few new code languages have been added for code-highlighting and code-editor support: - Scheme - SQL variants: MySQL, MSSQL, PostgreSQL, SQLite @@ -138,7 +137,28 @@ but the changes here were required due to current inconsistent handling. A humongous heap of thanks once again to all the below people that have helped translate BookStack text since the original v22.11 release: -- user - *language* +- RandomUser0815 - *German Informal* +- Matthias Mai (schnapsidee) - *German; German Informal* +- 10935336 - *Chinese Simplified* +- Naoto Ishikawa (na3shkw) - *Japanese* +- Maciej Lebiest (Szwendacz) - *Polish* +- m0uch0 - *Spanish* +- Pafzedog - *French* +- Angelos Chouvardas (achouvardas) - *Greek* +- Xabi (xabikip) - *Basque* +- David Furman (thefourCraft) - *Hebrew* +- Indrek Haav (IndrekHaav) - *Estonian* +- Jan Mitrof (jan.kachlik) - *Czech* +- Martin Sebek (sebekmartin) - *Czech* +- Adrian Ocneanu (aocneanu) - *Romanian* +- sdhadi - *Persian* +- scureza - *Italian* +- SmokingCrop - *Dutch* +- rndrss - *Portuguese, Brazilian* +- Eduardo Castanho (EduardoCastanho) - *Portuguese* +- VIET NAM VPS (vietnamvps) - *Vietnamese* +- rirac294 - *Russian* +- m4tthi4s - *French* ### Next Steps diff --git a/content/docs/user/roles-and-permissions.md b/content/docs/user/roles-and-permissions.md index f6fb162..920fba2 100644 --- a/content/docs/user/roles-and-permissions.md +++ b/content/docs/user/roles-and-permissions.md @@ -58,11 +58,11 @@ There are three main levels of permission, which have different levels of specif **From least specific to most specific**: 1. Role permissions (Edited via the "Roles" interface). -2. Content "Other Users" permissions (Edited via the "Permissions" view for an item). +2. Content "Everyone Else" permissions (Edited via the "Permissions" view for an item). 3. Role-specific content permissions (Also edited via the "Permissions" view for an item). With those levels in in mind: - Most specific permission application (as above) take priority and can deny less specific permissions. -- Parent role-specific content permissions, that may be inherited ("Other Users" Inheriting checkbox active), are considered to essentially be applied on the item they are inherited to unless a lower level has its own permission rule for that specific role. +- Parent role-specific content permissions, that may be inherited ("Everyone Else" Inheriting checkbox active), are considered to essentially be applied on the item they are inherited to unless a lower level has its own permission rule for that specific role. - Where both grant and deny exist at the same specificity, we side towards grant. \ No newline at end of file diff --git a/package-lock.json b/package-lock.json index 5ec2911..f79699a 100644 --- a/package-lock.json +++ b/package-lock.json @@ -10,7 +10,7 @@ "license": "MIT", "devDependencies": { "npm-run-all": "^4.1.5", - "sass": "^1.52.1" + "sass": "^1.57.1" } }, "node_modules/ansi-styles": { @@ -872,9 +872,9 @@ } }, "node_modules/sass": { - "version": "1.52.1", - "resolved": "https://registry.npmjs.org/sass/-/sass-1.52.1.tgz", - "integrity": "sha512-fSzYTbr7z8oQnVJ3Acp9hV80dM1fkMN7mSD/25mpcct9F7FPBMOI8krEYALgU1aZoqGhQNhTPsuSmxjnIvAm4Q==", + "version": "1.57.1", + "resolved": "https://registry.npmjs.org/sass/-/sass-1.57.1.tgz", + "integrity": "sha512-O2+LwLS79op7GI0xZ8fqzF7X2m/m8WFfI02dHOdsK5R2ECeS5F62zrwg/relM1rjSLy7Vd/DiMNIvPrQGsA0jw==", "dev": true, "dependencies": { "chokidar": ">=3.0.0 <4.0.0", @@ -1745,9 +1745,9 @@ } }, "sass": { - "version": "1.52.1", - "resolved": "https://registry.npmjs.org/sass/-/sass-1.52.1.tgz", - "integrity": "sha512-fSzYTbr7z8oQnVJ3Acp9hV80dM1fkMN7mSD/25mpcct9F7FPBMOI8krEYALgU1aZoqGhQNhTPsuSmxjnIvAm4Q==", + "version": "1.57.1", + "resolved": "https://registry.npmjs.org/sass/-/sass-1.57.1.tgz", + "integrity": "sha512-O2+LwLS79op7GI0xZ8fqzF7X2m/m8WFfI02dHOdsK5R2ECeS5F62zrwg/relM1rjSLy7Vd/DiMNIvPrQGsA0jw==", "dev": true, "requires": { "chokidar": ">=3.0.0 <4.0.0", diff --git a/package.json b/package.json index bd408fb..e51db47 100644 --- a/package.json +++ b/package.json @@ -20,6 +20,6 @@ "license": "MIT", "devDependencies": { "npm-run-all": "^4.1.5", - "sass": "^1.52.1" + "sass": "^1.57.1" } } diff --git a/static/images/yt/W7I2Hlcj1QA.webp b/static/images/yt/W7I2Hlcj1QA.webp new file mode 100644 index 0000000..913ab05 --- /dev/null +++ b/static/images/yt/W7I2Hlcj1QA.webp @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:865f22197fbcc9a46e7ad9572de4eff7723ffcfd99967b126a7b73a36eaa7a6c +size 33996