Skip to content

Commit

Permalink
GHAction - Commit content changes pulled from notion
Browse files Browse the repository at this point in the history
  • Loading branch information
jamespostsil authored and github-actions[bot] committed Dec 9, 2024
1 parent 11155e8 commit 6a982fc
Show file tree
Hide file tree
Showing 17 changed files with 75 additions and 33 deletions.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
73 changes: 45 additions & 28 deletions docs/Bloom-Enterprise/Bulk-Book-Processing/bloom-bookshelves.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,14 +37,20 @@ _Both_ bulk operations depend on grouping books into particular “bookshelves

There are two essential steps before initiating either of these bulk processing operations.

1. Set the **Bloom Library Bookshelf** for the book collection to set the bookshelf.
2. Ensure the publishing settings for each book are correct.
1. Set the [Bloom Library Bookshelf](/bloom-bookshelves#8874d41827394c69a5ef00d4508fda2a) for the book collection to set the bookshelf.
2. Ensure the [publishing settings](/bloom-bookshelves#0ef8e2f1272c4ea88040940a6cdcce56) for each book are correct.

The first essential step is to select the **Bloom Library Bookshelf**. This is selected from a drop-down list in the **Book Making** tab of Bloom Editor Settings:
**Set Bloom Library Bookshelf**


Here are the steps to select the **Bloom Library Bookshelf**:


![](./bloom-bookshelves.5e121b7d-814d-4834-9931-4a9d7d25d42b.png)

1. Choose the `Book Making` tab of Bloom Editor Settings.
2. Select the **bookshelf** from the `Bloom Library Bookshelf` drop-down.
3. Click `OK`.

:::caution

Expand All @@ -55,18 +61,24 @@ Setting up bookshelves is something done in coordination with the Bloom Libraria



**Check Publishing Settings**


Once the **Bloom Library Bookshelf** has been selected for the collection of books, the second essential step is to carefully set the publishing settings for _each_ individual book in the collection.

1. Click on the `Publish` tab.
1. Click the `Web` option:

To do this, in **Publish to Web** for _each_ book, ensure the following are correct:
![](./bloom-bookshelves.e116ff50-edf9-49bb-a2ac-a09a7b75b49c.png)

- Selection of **Text Languages**.
- Selection of **Talking Book Languages**.
- Selection of book **Features**.
- **Cover Color**.
- **Visibility**.
- Book **Summary**.
- Book Copyright.
2. For **each** book, ensure the following are correct:
- Book **Copyright**.
- Book **Summary**.
- Selection of **Text Languages**.
- Selection of **Talking Book Languages**.
- Selection of book **Features** (for example: `Talking Book`, `Sign Language`, `Motion Book`, etc)
- **Cover Color**
- **Visibility**

## Bulk Uploading to Web {#9db147e9949e425cb73cb3b013f07c55}

Expand Down Expand Up @@ -128,31 +140,27 @@ See also [How to distribute Bloom books on SD Cards or Phones](/BR-distribution)
## Make All BloomPUBs {#9eaab0ca96f44e25ae8a2cae05f545e5}


To bulk publish all BloomPUBs in a single operation:
Here are the **steps to bulk publish all BloomPUBs** in a single operation:


![](./bloom-bookshelves.140a73c7-e15a-4b86-90fa-91e6dac5fd6f.png)


| **** | Click on the **Publish** tab. |
| ----- | ---------------------------------------------- |
| **** | Choose **BloomPUB**. |
| **** | Click **Make All BloomPUBs from Collection**. |

1. Click on the **Publish** tab.
2. Choose **BloomPUB**.
3. Click **Make All BloomPUBs from Collection**.

A **Make All BloomPUBs from Collection** dialog will appear with a number of options:


![](./bloom-bookshelves.5a06535e-96d7-490f-9f74-6862444af239.png)


| **** | Tick this box to produce the special .bloomshelf file needed to group the BloomPUBs together into separate bookshelves on the Bloom Reader app. |
| ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **** | Click the color chooser to select a color for this bookshelf. |
| **** | If your organization wants to track particular Bloom Reader campaigns, choose a specific Distribution Tag to identify that campaign. See also [this document](https://docs.google.com/document/d/1Hm7apUH1KV3I_GCCOVkh-aiCtq5O_1ILcne074r_w-g/preview#heading=h.u0vc4ok5rukm). |
| **** | Tick this box if you need the books bundled together into a single `.bloombundle` file. <br/>See also [BloomPUB Bundles](/bloomPUB-bundles). |
| **** | Click the MAKE button to start the process. |

1. Tick this box to produce the special **.bloomshelf file** needed to group the BloomPUBs together into separate bookshelves on the Bloom Reader app.
2. Click the color chooser to select a color for this bookshelf.
3. If your organization wants to track particular Bloom Reader campaigns, choose a specific Distribution Tag to identify that campaign.
1. See also [Measuring the Impact of your Bloom Reader Campaigns with Distribution Tags](/bloom-reader-distribution-tags).
4. Tick this box if you need the books bundled together into a single `.bloombundle` file.
1. See also [BloomPUB Bundles](/bloomPUB-bundles).
5. Click the `MAKE` button to start the process.

Bloom will make these BloomPUBs in a temporary folder called:

Expand All @@ -162,8 +170,17 @@ C:\Users\YOUR NAME\AppData\Local\Temp\BloomPubs
```


After the operation is complete, Bloom will open an instance of Windows File Explorer and show you the results which can be copied to a phone which has Bloom Reader installed.
After the operation is complete, Bloom will open a **File Explorer** window and show you the file(s) created.


Share the file(s) to a phone which has Bloom Reader installed. See [Other Sharing Methods](/get-books-bloom-reader#e35d8c2330514305aa5622eebaeb57b4) for suggestions how to share these files.


### Make and Distribute Multiple Bookshelves {#e0819367b8814d6d93330669772f903b}


If you are preparing multiple bookshelves for distribution on an SD card, or prepaid phones, you will need to copy the files over to a separate folder set aside to house all of the Bloom Reader bookshelves. Once all of the required materials are gathered, they can be copied to an SD for mass distribution.
If you are preparing multiple bookshelves for distribution on an SD card, or prepaid phones:

1. Create a separate folder to store all of the Bloom Reader bookshelves.
2. After each bookshelf is created, copy the files over to the separate folder.
3. Once all of the required materials are gathered, copy all bookshelf files to an SD card for mass distribution.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Original file line number Diff line number Diff line change
Expand Up @@ -33,10 +33,13 @@ If your Android device is connected to the internet, Bloom Reader also provides
![](./about-bloom-reader.2d8294f9-9846-498d-988a-1f26704164a0.png)


For instructions to download books into Bloom Reader, see [Get Books in Bloom Reader](/get-books-bloom-reader).


## Send Books to Bloom Reader {#cc1a6dc032b84ca8b04d3f66fe92a507}


Books from Bloom Editor can be transferred to the Bloom Reader app through:
Books from **Bloom Editor** can be transferred to the Bloom Reader app through:

1. A shared Wi-Fi connection
OR
Expand All @@ -45,6 +48,9 @@ OR
![](./about-bloom-reader.f08f4559-0e92-4a4d-8b1a-f058ddbe09d6.png)


For instructions how to share books from Bloom Editor, see [Get Books from Bloom Editor](/get-books-bloom-reader#1524bb19df1281b49db4e08540d499fe).


## Share Books from Bloom Reader {#d126c4bbd5ee491c8f7c75d5619eec7b}


Expand All @@ -63,6 +69,9 @@ Bloom Reader can import books from your Android device’s storage, or an extern
![](./about-bloom-reader.560b251f-f422-4cbc-bbbf-0c3847a2696f.png)


See [Get books from a folder on your Android device](/get-books-bloom-reader#0c2e2d830dcd4b769af3d29c24ac0e3c) for more details.


## BloomPUB Books {#703db164da8a4d57ba0661fadbd88f95}


Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -19,14 +19,14 @@ BloomPUB Bundles are used in connection with the [Bloom Reader](https://bloomlib
When a person opens a BloomPUB Bundle on an Android device with Bloom Reader installed, Bloom Reader will “unpack” the file and add all of its books and bookshelves to its book list.


The normal way to make a BloomPUB bundle is to use the Make all BloomPUBs from Publish to BloomPUB screen in Bloom’s desktop editor. For more information, see [Bloom Bulk Book Processing](/bloom-bookshelves).
The normal way to make a BloomPUB bundle is to use the [Make All BloomPUBs](/bloom-bookshelves#9eaab0ca96f44e25ae8a2cae05f545e5) feature in Bloom’s desktop editor.


:::caution

The Samsung File Manager does not handle `.bloombundle` (or `.bloomPUB`) files.

Unfortunately, we have determined that we can do nothing about this.
The best option is to use [Google File Manager](https://play.google.com/store/apps/details?id=com.google.android.apps.nbu.files). It is able to use Bloom Reader to open `.bloombundle` and `.bloomPUB`) files.

:::

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -231,13 +231,13 @@ If you have a BloomPUB file on computer or Android device, you can share it with
- Messaging apps: WhatsApp, Skype, Facebook Messenger, etc.
- File Sharing apps: DropBox, Google Drive, One Drive, etc.
- Email: Gmail, Outlook, Yahoo mail, etc.
- File Transfer: Bluetooth, Wi-Fi transfer, etc.
- File Transfer: Bluetooth, Wi-Fi transfer, USB cable transfer, etc.

**Steps to share a Bloom book with others:**

1. Generate/share a BloomPUB file. You can use either of these methods:
1. [Publish to BloomPUB](/publish-to-bloompub) from Bloom Editor
2. [Share a Book from Bloom Reader](/share-book-bloom-reader)
2. Send the BloomPUB book to an Android device using your preferred sharing method.
3. Save the file to the Android device
3. Save the file to the Android device.
4. Use the steps listed in to open the file in Bloom Reader.
16 changes: 16 additions & 0 deletions docs/Bloom-Reader-App/Use-Bloom-Reader/share-book-bloom-reader.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
---
title: Share a Book from Bloom Reader
sidebar_position: 5
slug: /share-book-bloom-reader
---



:::note

Content coming soon.

:::



Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 6a982fc

Please sign in to comment.