Merge branch 'development' into release

Author: ssddanbrown

.github/translators.txt

@@ -348,7 +348,7 @@ robing29 :: German
 Bruno Eduardo de Jesus Barroso (brunoejb) :: Portuguese, Brazilian
 Igor V Belousov (biv) :: Russian
 David Bauer (davbauer) :: German
-Guttorm Hveem (guttormhveem) :: Norwegian Bokmal; Norwegian Nynorsk
+Guttorm Hveem (guttormhveem) :: Norwegian Nynorsk; Norwegian Bokmal
 Minh Giang Truong (minhgiang1204) :: Vietnamese
 Ioannis Ioannides (i.ioannides) :: Greek
 Vadim (vadrozh) :: Russian
@@ -357,13 +357,15 @@ Paulo Henrique (paulohsantos114) :: Portuguese, Brazilian
 Dženan (Dzenan) :: Swedish
 Péter Péli (peter.peli) :: Hungarian
 TWME :: Chinese Traditional
-Sascha (Man-in-Black) :: German
+Sascha (Man-in-Black) :: German; German Informal
 Mohammadreza Madadi (madadi.efl) :: Persian
-Konstantin Kovacheli (kkovacheli) :: Ukrainian
+Konstantin (kkovacheli) :: Ukrainian; Russian
 link1183 :: French
 Renan (rfpe) :: Portuguese, Brazilian
 Lowkey (bbsweb) :: Chinese Simplified
 ZZnOB (zznobzz) :: Russian
 rupus :: Swedish
 developernecsys :: Norwegian Nynorsk
 xuan LI (xuanli233) :: Chinese Simplified
+LameeQS :: Latvian
+Sorin T. (trimbitassorin) :: Romanian

.github/workflows/test-migrations.yml

@@ -16,7 +16,7 @@ jobs:
     runs-on: ubuntu-22.04
     strategy:
       matrix:
-        php: ['8.0', '8.1', '8.2']
+        php: ['8.0', '8.1', '8.2', '8.3']
     steps:
       - uses: actions/checkout@v1
 

.github/workflows/test-php.yml

@@ -16,7 +16,7 @@ jobs:
     runs-on: ubuntu-22.04
     strategy:
       matrix:
-        php: ['8.0', '8.1', '8.2']
+        php: ['8.0', '8.1', '8.2', '8.3']
     steps:
     - uses: actions/checkout@v1
 

dev/docs/javascript-public-events.md

@@ -253,3 +253,69 @@ window.addEventListener('library-cm6::configure-theme', event => {
 });
 ```
 </details>
+
+### `library-cm6::pre-init`
+
+This event is called just before any CodeMirror instances are initialised so that the instance configuration can be viewed and altered before the instance is created.
+
+#### Event Data
+
+- `usage` - A string label to identify the usage type of the CodeMirror instance in BookStack.
+- `editorViewConfig` - A reference to the [EditorViewConfig](https://codemirror.net/docs/ref/#view.EditorViewConfig) that will be used to create the instance.
+- `libEditorView` - The CodeMirror [EditorView](https://codemirror.net/docs/ref/#view.EditorView) class object, provided for convenience.
+- `libEditorState` - The CodeMirror [EditorState](https://codemirror.net/docs/ref/#state.EditorState) class object, provided for convenience.
+- `libCompartment` - The CodeMirror [Compartment](https://codemirror.net/docs/ref/#state.Compartment) class object, provided for convenience.
+
+##### Example
+
+The below shows how you'd enable the built-in line wrapping extension for page content code blocks: 
+
+<details>
+<summary>Show Example</summary>
+
+```javascript
+window.addEventListener('library-cm6::pre-init', event => {
+    const detail = event.detail;
+    const config = detail.editorViewConfig;
+    const EditorView = detail.libEditorView;
+    
+    if (detail.usage === 'content-code-block') {
+        config.extensions.push(EditorView.lineWrapping);
+    }
+});
+```
+</details>
+
+### `library-cm6::post-init`
+
+This event is called just after any CodeMirror instances are initialised so that you're able to gain a reference to the CodeMirror EditorView instance.
+
+#### Event Data
+
+- `usage` - A string label to identify the usage type of the CodeMirror instance in BookStack.
+- `editorView` - A reference to the [EditorView](https://codemirror.net/docs/ref/#view.EditorView) instance that has been created.
+- `editorViewConfig` - A reference to the [EditorViewConfig](https://codemirror.net/docs/ref/#view.EditorViewConfig) that was used to create the instance.
+- `libEditorView` - The CodeMirror [EditorView](https://codemirror.net/docs/ref/#view.EditorView) class object, provided for convenience.
+- `libEditorState` - The CodeMirror [EditorState](https://codemirror.net/docs/ref/#state.EditorState) class object, provided for convenience.
+- `libCompartment` - The CodeMirror [Compartment](https://codemirror.net/docs/ref/#state.Compartment) class object, provided for convenience.
+
+##### Example
+
+The below shows how you'd prepend some default text to all content (page) code blocks.
+
+<details>
+<summary>Show Example</summary>
+
+```javascript
+window.addEventListener('library-cm6::post-init', event => {
+    const detail = event.detail;
+    const editorView = detail.editorView;
+    
+    if (detail.usage === 'content-code-block') {
+        editorView.dispatch({
+          changes: {from: 0, to: 0, insert: 'Copyright 2023\n\n'}
+        });
+    }
+});
+```
+</details>

lang/ar/settings.php

@@ -306,8 +306,9 @@
         'ko' => '한국어',
         'lt' => 'Lietuvių Kalba',
         'lv' => 'Latviešu Valoda',
-        'nl' => 'Nederlands',
         'nb' => 'Norsk (Bokmål)',
+        'nn' => 'Nynorsk',
+        'nl' => 'Nederlands',
         'pl' => 'Polski',
         'pt' => 'Português',
         'pt_BR' => 'Português do Brasil',

lang/bg/settings.php

@@ -306,8 +306,9 @@
         'ko' => '한국어',
         'lt' => 'Lietuvių Kalba',
         'lv' => 'Latviešu Valoda',
-        'nl' => 'Nederlands',
         'nb' => 'Norsk (Bokmål)',
+        'nn' => 'Nynorsk',
+        'nl' => 'Nederlands',
         'pl' => 'Polski',
         'pt' => 'Português',
         'pt_BR' => 'Português do Brasil',

lang/bs/settings.php

@@ -306,8 +306,9 @@
         'ko' => '한국어',
         'lt' => 'Lietuvių Kalba',
         'lv' => 'Latviešu Valoda',
-        'nl' => 'Nederlands',
         'nb' => 'Norsk (Bokmål)',
+        'nn' => 'Nynorsk',
+        'nl' => 'Nederlands',
         'pl' => 'Polski',
         'pt' => 'Português',
         'pt_BR' => 'Português do Brasil',

lang/ca/settings.php

@@ -306,8 +306,9 @@
         'ko' => '한국어',
         'lt' => 'Lietuvių Kalba',
         'lv' => 'Latviešu Valoda',
-        'nl' => 'Nederlands',
         'nb' => 'Norsk (Bokmål)',
+        'nn' => 'Nynorsk',
+        'nl' => 'Nederlands',
         'pl' => 'Polski',
         'pt' => 'Português',
         'pt_BR' => 'Português do Brasil',

lang/cs/settings.php

@@ -306,8 +306,9 @@
         'ko' => '한국어',
         'lt' => 'Lietuvių Kalba',
         'lv' => 'Latviešu Valoda',
-        'nl' => 'Nederlands',
         'nb' => 'Norsk (Bokmål)',
+        'nn' => 'Nynorsk',
+        'nl' => 'Nederlands',
         'pl' => 'Polski',
         'pt' => 'Português',
         'pt_BR' => 'Português do Brasil',

lang/cy/settings.php

@@ -306,8 +306,9 @@
         'ko' => '한국어',
         'lt' => 'Lietuvių Kalba',
         'lv' => 'Latviešu Valoda',
-        'nl' => 'Nederlands',
         'nb' => 'Norsk (Bokmål)',
+        'nn' => 'Nynorsk',
+        'nl' => 'Nederlands',
         'pl' => 'Polski',
         'pt' => 'Português',
         'pt_BR' => 'Português do Brasil',