Revert "GHAction - Commit content changes pulled from notion"

This reverts commit 61d93cf.

docs/Advanced-Topics/_category_.json

@@ -0,0 +1 @@
+{"position":5, "label":"Advanced Topics"}

docs/Using-Bloom-for-Large-Projects/adaptations.md → docs/Advanced-Topics/adaptations.md

@@ -1,6 +1,6 @@
 ---
 title: Managing Large Projects- new books and adaptations
-sidebar_position: 3
+sidebar_position: 1
 slug: /adaptations
 ---
 
@@ -103,7 +103,7 @@ Click the arrow beside your collection name:
 ![](./adaptations.805385b1-671e-43c9-84aa-2e3f90cb3080.png)
 
 
-And then choose `Make Bloom Pack of Shell Books…`
+And then choose **Make Bloom Pack of Shell Books…**
 
 
 ![](./adaptations.06bcf2fa-65e1-4b3b-8e48-44a4e6c20941.png)

docs/Bloom-Editor/Bloom-Editor-Best-Practices/bloom-editor-best-practices.md → docs/Advanced-Topics/bloom-editor-best-practices.md

@@ -1,6 +1,6 @@
 ---
-title: Bloom Editor Best Practices Index
-sidebar_position: 0
+title: Bloom Editor Best Practices
+sidebar_position: 3
 slug: /bloom-editor-best-practices
 ---
 

docs/Bloom-Reader/bloomPUB-image-resolution.md → docs/Advanced-Topics/bloomPUB-image-resolution.md

@@ -1,6 +1,6 @@
 ---
 title: Setting the image resolution in BloomPUBs
-sidebar_position: 4
+sidebar_position: 7
 slug: /bloomPUB-image-resolution
 ---
 
@@ -20,7 +20,7 @@ In Bloom 5.4 and 5.5, you can increase this number by following these steps:
 
 :::tip
 
-Note, images in PDFs are not down-sampled.
+Note, images in PDFs are not down-sampled
 
 :::
 
@@ -29,7 +29,7 @@ Note, images in PDFs are not down-sampled.
 
 :::tip
 
-Bloom normally down-samples **incoming** images to 3500 x 2550 (landscape) or 2550 x 3500 (portrait). These maxes were chosen to fit A4 paper at 300dpi. This was done to avoid the situation we were seeing where less-technical users were getting gigantic images into Bloom and then having memory problems.
+Bloom normally down-samples _incoming_ images to 3500 x 2550 (landscape) or 2550 x 3500 (portrait). These maxes were chosen to fit A4 paper at 300dpi. This was done to avoid the situation we were seeing where less-technical users were getting gigantic images into Bloom and then having memory problems.
 
 :::
 

docs/Help/Technical-Notes/derivatives.md → docs/Advanced-Topics/derivatives.md

@@ -1,6 +1,6 @@
 ---
-title: Issues Around Derivative Books
-sidebar_position: 5
+title: Issues around derivative books
+sidebar_position: 4
 slug: /derivatives
 ---
 
@@ -18,7 +18,7 @@ There are only three approved ways to make a book in Bloom.
 When you make a book using any of the above Bloom-approved methods for making books, the Bloom Editor will generate a unique number and assign that number to your book. This “book ID” is unique and it will follow that book _wherever_ that book “lives” even when it is uploaded to the Bloom Library.
 
 
-## Consequences of Using Windows Explorer To Make a New Book {#b5937dcc86c84961aeb121e2c5214730}
+## Consequences of using Windows Explorer to make a new book {#b5937dcc86c84961aeb121e2c5214730}
 
 
 If you use Windows Explorer to make a new book by copying a book folder from one collection into another collection, then the two books will have the _same_ ID. This could cause confusion later on.

docs/Bloom-Editor/Talking-Books/edit-timings.md → docs/Advanced-Topics/edit-timings.md

@@ -1,6 +1,6 @@
 ---
-title: Edit Aeneas Timings
-sidebar_position: 3
+title: Fine-tuning Aeneas Timings
+sidebar_position: 8
 slug: /edit-timings
 keywords: [Aeneas, Talking Book Tool]
 ---
@@ -55,7 +55,7 @@ With the Talking Book Tool open:
 
 4. A message will display (example shown below). Click **OK**.
 
-	![](./edit-timings.0b2706dc-8ae6-491e-98fc-edddd679c00d.png)
+![](./edit-timings.0b2706dc-8ae6-491e-98fc-edddd679c00d.png)
 
 
 ## The timings file {#d3fd21b8b9bf439980bec34665709f8b}

docs/Bloom-Editor/Adding-interactive-features-to-your-books/html5-widgets.md → docs/Advanced-Topics/html5-widgets.md

@@ -1,13 +1,13 @@
 ---
 title: HTML5 Widgets
-sidebar_position: 1
+sidebar_position: 5
 slug: /html5-widgets
 keywords: [HTML5, widgets, activities, games]
 ---
 
 
 
-Bloom pages can embed little custom HTML5 activities called “widgets”. When published as a BloomPUB, these widgets will work on the web, Bloom Reader, and RAB Apps. You can see examples of widgets in [these interactive books](https://bloomlibrary.org/activities/books-with-widgets) in the Bloom Library.
+Bloom pages can embed little custom HTML5 activities called “widgets”. When published as a bloompub, these widgets will work on the web, Bloom Reader, and RAB Apps. You can see examples of widgets in [these interactive books](https://bloomlibrary.org/activities/books-with-widgets) in the Bloom Library.
 
 
 Many of these widgets already exist on the web, because they work with Apple's iBooks and other software. You can also make your own using programs like [Active Presenter](https://atomisystems.com/activepresenter/). Most widgets don’t have any custom programming, but if software like Active Presenter is not sufficient for what you need, you can hire a web developer to do something even more advanced.
@@ -24,7 +24,7 @@ Bloom can import any of the following widget formats
 # Adding to Bloom {#cb88f96b162543898f468ed2a9082469}
 
 
-To add a widget, click “Add Page” and then select one of the template pages. These have an image of a puzzle piece:
+To add a widget, Click “Add Page” and then select one of the template pages. These have an image of a puzzle piece:
 
 
 ![](./html5-widgets.1cb55c74-29c0-40d6-8534-1fa29c61cfbb.png)
@@ -66,7 +66,7 @@ Bloom Player will not give the user any way to navigate away from this page exce
 ### 2: Send navigation messages {#2f6c61a6febd4a128e9225ba30fd2a33}
 
 
-To tell Bloom Player to navigate, you will need to add some JavaScript to a button:
+To tell Bloom Player to navigate, you will need to add some javascript to a button:
 
 
 <div class='notion-row'>

docs/Bloom-Editor/Install-Bloom/installing-bloom-linux.md → docs/Advanced-Topics/installing-bloom-linux.md

@@ -1,51 +1,42 @@
 ---
-title: Install Bloom on Linux
-sidebar_position: 5
+title: Installing Bloom on Linux
+sidebar_position: 9
 slug: /installing-bloom-linux
 ---
 
 
 
-:::note
-
-Bloom 5.4 is the final version of Bloom available on Linux in either a flatpak or debian package for the foreseeable future.  The Bloom team is working to convert all of the Bloom user interface to a web-based system. Once that is achieved, we hope to be able to offer a cross-platform Bloom for Linux and MacOS as well as Windows.  We do not have a time-table for when that will happen.
-
-:::
-
-
-
-
 ## Installing Bloom on Newer Linux Systems (Ubuntu 22.04 and later) {#0a0e555f3b51439686a086c6f0c97bf1}
 
 
-Bloom 5.4 is available as a [flatpak package](https://flathub.org/apps/org.sil.Bloom) which will run on newer versions of Ubuntu and Wasta Linux, and probably other Linux distributions also. (The debian packages will not work on these newer releases of Linux because the system libraries are no longer compatible with some of the older software libraries used inside Bloom.)
+Bloom 5.4 is available as a flatpak package which will run on newer versions of Ubuntu and Wasta (and probably other Linux distributions). For details on installing the flatpak version of Bloom, see [https://flathub.org/apps/org.sil.Bloom](https://flathub.org/apps/org.sil.Bloom).  The debian packages will not work on these newer releases of Linux because the system libraries are no longer compatible with some of the older software libraries used inside Bloom.
 
 
-If flatpak has been installed on your system, you can install Bloom with the following command in a terminal window:
+If flatpak has been installed on your system, then installing Bloom can be done with the following command in a shell window:
 
 
 ```bash
 flatpak install org.sil.Bloom
 ```
 
 
-Updating Bloom is a similar:
+Updating Bloom is a similar command:
 
 
 ```bash
 flatpak update org.sil.Bloom
 ```
 
 
-To run Bloom from the command line, enter the following command:
+Running Bloom from the command line is also a similar command:
 
 
 ```bash
 flatpak run org.sil.Bloom
 ```
 
 
-Setting up a desktop icon that you can click is a bit trickier.  If Bloom was installed globally (the default), then the following commands should work:
+Setting things up for a desktop icon that you can click on is a bit trickier.  If Bloom was installed globally (the default), then the following commands should work:
 
 
 ```bash
@@ -63,24 +54,16 @@ chmod +x ~/Desktop/org.sil.Bloom.desktop
 ```
 
 
-### Known Limitations of the flatpak Bloom {#e6134b6dafb348a9b95ba5c0c4d9db3b}
+### Known Limitations of the Flatpak Bloom {#e6134b6dafb348a9b95ba5c0c4d9db3b}
 
 - Book history does not work in Team Collections on Linux in general, including flatpak.
 - Checking ePUB accessibility by ACE by Daisy does not work.  At this point, there are no plans to try to get this working.  It should be possible to save an ePUB from Bloom and check that file separately with the ACE by Daisy program outside of Bloom.
+- Bloom 5.4 is the final version of Bloom available on Linux in either a flatpak or debian package for the foreseeable future.  The Bloom team is working to convert all of the Bloom user interface to be web-based, but has a long ways to go to get there.  Once that is achieved, we hope to be able to offer a more cross-platform Bloom available on Apple OSX and Linux as well as Windows.  We do not have a time-table for when that will happen.
 
 ## Installing Bloom on Older Linux Systems (Ubuntu 20.04 and 18.04) {#39ef5bfd225f4978b2f04fe16036059a}
 
 
-Bloom 5.4 is available as a Debian package for Ubuntu 20.04 (Wasta 20) and Ubuntu 18.04 (Wasta 18). 
-
-
-:::note
-
-If your Linux distribution uses a package manager other than `apt`, make the appropriate changes to the directions below. 
-
-:::
-
-
+Bloom 5.4 is available as a Debian package for Ubuntu 20.04 (Wasta 20) and Ubuntu 18.04 (Wasta 18).  This is the final version of Bloom available for these versions of Linux.
 
 
 ### Step 1: Try to install the Bloom Editor program {#0955c54890a548c88f50627a739761cf}
@@ -91,16 +74,16 @@ sudo apt install bloom-desktop
 ```
 
 
-If this succeeds, you can skip to [Step 4](/installing-bloom-linux#7afd8e3e48c94d5a8a19bad8617ffe8a) below.  If this fails because `apt` cannot locate the package, then the following steps are needed. (If this fails because of authorization issues or a missing `sudo` program, consult your local Linux administrator.)
+If this succeeds, you can skip to step 4 below (you are already a user of SIL software).  If this fails because of authorization issues or a missing sudo program, you need to consult with the local Linux administrator.  If this fails because apt cannot locate the package, then the following steps are needed.
 
 
 ### Step 2: Add the SIL repository to your system {#d39f37716f014faca56c137191554e6f}
 
 
-See [Enable access to SIL software and fonts in Ubuntu](https://packages.sil.org/) for alternative instructions on how to add the SIL repository to your system.
+See the [Enable access to SIL software and fonts in Ubuntu](https://packages.sil.org/) for alternative instructions on how to add the SIL repository to your system.
 
 
-**(for bionic or wasta 18):**
+### (for bionic or wasta 18): {#828abb7005574e7d87c61a4009227746}
 
 
 ```bash
@@ -111,7 +94,7 @@ See [Enable access to SIL software and fonts in Ubuntu](https://packages.sil.org
 ```
 
 
-**(for focal or wasta 20):**
+### (for focal or wasta 20): {#0a236525d2d54a0b9f7c1bb7a5793e9a}
 
 
 ```bash
@@ -124,14 +107,14 @@ sudo apt update
 ### Step 3: Install the Bloom Editor program {#22bd050eb47f49a4b6db40632e55a6fd}
 
 
-(This is just a repeat of step 1 now that you have access to the SIL software repository.)
-
-
 ```bash
 sudo apt install bloom-desktop
 ```
 
 
+(This is just a repeat of step 1 now that you have access to the SIL software repository.)
+
+
 ### Step 4: Copy the desktop launcher to your local area {#7afd8e3e48c94d5a8a19bad8617ffe8a}
 
 
@@ -144,7 +127,16 @@ chmod +x ~/Desktop/bloom.desktop
 ### Step 5: Launch the Application {#f95630c029d14b5e95ff3072bdc76bbd}
 
 
-Double click the desktop launcher icon, or type the name of the program in a terminal window (or into the dashboard or startup menu): 
+### (mouse) {#f81860b903e14dfc9ce02714f1fd3e0a}
+
+
+Double click the desktop launcher icon
+
+
+### (keyboard) {#2cc573a95d6e4212a378e14b33619c23}
+
+
+Type the name of the program in a terminal window or into the dashboard or startup menu
 
 
 ```bash

docs/Bloom-Editor/Multilingual-Books/publishing-multilingual-books.md → docs/Advanced-Topics/publishing-multilingual-books.md

@@ -1,6 +1,6 @@
 ---
-title: Publish Books in Multiple Languages- Two Methods
-sidebar_position: 5
+title: Two Different Approaches to Publishing Books in Multiple Languages
+sidebar_position: 2
 slug: /publishing-multilingual-books
 ---
 
@@ -39,9 +39,6 @@ Regarding the “tweaking” mentioned above, if your book is not yet ready to s
 Legitimate “tweaking” of an already published Bloom book might include things like _adding_ or improving the audio narration, or perhaps adding a forgotten book acknowledgment, or some other minor change.
 
 
-See [Workflow for Method 1](/publishing-multilingual-books#2f4bec2da8e3425595cc7d0faf126ed7).
-
-
 ## Method 2 {#0b1c5ee4ec604aa1a6c357f0ac1cc426}
 
 
@@ -60,9 +57,6 @@ Publish one source language book, and then create derivative copies of the book
 Now that you understand the advantages and disadvantages of these two methods, let’s talk about how your workflow would differ for each method.
 
 
-See [Workflow for Method 2](/publishing-multilingual-books#88e2a0b4e5884abcbf57a5f6ba1d7563).
-
-
 ## Workflow for Method 1 {#2f4bec2da8e3425595cc7d0faf126ed7}
 
 

docs/About-Bloom/when-to-use-bloom.md → docs/Advanced-Topics/when-to-use-bloom.md

@@ -1,6 +1,6 @@
 ---
 title: Is Bloom right for my project?
-sidebar_position: 3
+sidebar_position: 0
 slug: /when-to-use-bloom
 ---